archimate

archimate 技能概览

archimate 的用途

archimate 技能帮助你使用 PlantUML 里的 !include <archimate/Archimate> stdlib 和类型化宏来生成 ArchiMate 图。它最适合需要一个 archimate skill 来表达分层企业架构视图的场景：业务层、应用层、技术层、动机层，以及实施路线图。它适合把粗略的架构轮廓整理成结构化图，而不是只画一些通用的方框和箭头。

最适合的使用场景

这个技能非常适合制作企业架构交付物的人，比如能力地图、应用集成视图、安全架构或迁移计划。它尤其适合需要跨层级可追溯性和清晰元素/关系语义的读者。如果你需要在 TOGAF 风格视图里做 archimate for Diagramming，这个技能比自由发挥式提示词更适合作为严谨起点。

不适合使用的场景

如果你的图主要是云参考架构、Kubernetes 布局或网络拓扑图，不要选 archimate，除非你的明确目标就是用 ArchiMate 视角来表达这些领域。仓库本身也明确把这些情况排除在外：基础设施成分很多的云图请用 cloud skill，拓扑图请用 network skill。这个边界很重要，因为这里的宏建模的是企业架构概念，而不是通用示意图设计。

如何使用 archimate 技能

安装并找到工作流

使用 npx skills add markdown-viewer/skills --skill archimate 安装。安装后，先阅读 SKILL.md 以了解必需的 PlantUML 结构，再查看 examples/ 里的示例文件，理解各层的典型模式。最值得先预览的文件是 examples/enterprise-landscape.md、examples/application-integration.md、examples/business-capability.md、examples/data-architecture.md 和 examples/migration-planning.md。

给技能提供正确输入

高质量的 archimate usage 总是从清晰的架构意图、目标视图和你已经知道的实体开始。差的请求会说“画一个架构图”。更好的请求会说：“创建一个零售行业的 ArchiMate business-capability 视图，展示 customer engagement、supply chain 和 finance capabilities，并包含 8–10 个命名元素以及它们之间的关系。” 记得写明层级、受众、范围，以及你是否希望包含动机层或实施层元素。

遵守 PlantUML 约定

这个技能要求输出的是一张真正的 PlantUML 图，而不是一段说明文字。核心模式是：以 @startuml 开始，包含 !include <archimate/Archimate>，使用 Business_Actor(...) 或 Application_Component(...) 这类类型化宏声明元素，用 Rel_* 宏连接它们，最后以 @enduml 结束。建议用 rectangle "Layer Name" { ... } 来保持模型清晰易读。如果省略 include，或使用了错误的代码块包裹方式，图就不会按预期渲染。

能提升输出质量的提示流程

想让 archimate guide 更稳定，最好分三步走：先定义架构问题，再列出实体和关系，最后只要求输出 PlantUML 图。好的输入会包括命名规则、期望细节层级，以及必须出现的关系，例如 serving、realization、access 或 triggering。如果源材料比较杂，先让技能把内容规范化成一个目标视图，再扩展到多个层级。

archimate 技能常见问题

archimate 比普通提示词更好吗？

是的，尤其当你需要稳定的 ArchiMate 语法，以及一张可以渲染、可编辑的图时。普通提示词可能会生成看起来合理的架构文字，但很容易缺少必需的宏、层级分组或关系类型。只要你在意图的准确性和复用性，archimate skill 就更有价值。

安装前需要知道什么？

最基本的前提是，你已经有一个符合 ArchiMate 语义的图目标。这个技能最适合你能明确说出要建模的 actor、application、capability、service 和 technology 节点的情况。即使你只有一个模糊想法也能用，但如果你先提供一个范围明确的视图，而不是一份宽泛的企业愿望清单，第一次输出通常会更好。

初学者能用 archimate 吗？

可以，只要愿意学几个宏模式。仓库的价值在于示例展示了常见视图和元素类型，初学者可以直接照着结构写，而不必把整套符号系统背下来。新手最常见的错误，是太早要求一张完整的企业总图；更好的做法是从一个视图、一层内容或一个流程切片开始。

什么时候该选别的技能？

如果图主要围绕云资源、物理网络布局，或者没有企业架构语义的通用软件组件，就应该选别的技能。若你需要的是纯视觉草图，而不关心标准化关系，也不适合用它。只有当结构、可追溯性和面向利益相关者可读的 EA 记法才是价值核心时，才选择 archimate。

如何改进 archimate 技能

先定义视图，而不是主题

提升最大的方式，是把你想要的 ArchiMate 视图说清楚。比如“银行业企业架构”太宽泛；“遗留计费系统的 migration-planning view，包含 baseline、两个 plateaus、work packages 和 gaps”就很可执行。如果你想让 archimate 的结果更好，要明确说明层级组合、受众，以及这张图要支撑的决策。

提供完整实体和关系意图

当你列出关键节点，以及它们如何连接时，这个技能的表现会更好。比如不要只说“展示登录流程”，而要说“Identity Provider serves Auth Service，Auth Service realizes Access Control，Users trigger Login Request。” 这种额外结构能减少幻觉式连线，也能让图更贴近真实架构。

一次只要一个交付物，并反复迭代

常见失败模式是一次要求太多视图，结果图面拥挤、关系也变弱。建议先做一张图，检查宏的选择是否符合你的架构语言，再针对缺失元素、命名或分组提出修订。对于 archimate usage 来说，迭代优化通常比一开始就塞进一个超大提示词更有效。

把示例当作模式库来用

如果你不确定该怎么组织请求，可以直接参考仓库里的示例：business-capability、application-integration、data-architecture、security-architecture、devops-pipeline 和 migration-planning。这些示例展示了哪些宏对应哪些关注点，以及仓库期望怎样做分层分组。复用这种结构，能让你的提示更具体，也让输出图更忠实。