技能介绍

要解决的具体问题

智能体生成 PlantUML 时，常见三类问题：语法与渲染环境不匹配、关系缺少说明导致图难读、试图用一张图塞下过多信息。本技能强调以图族和抽象层级为先的生成方式，并给出校验清单，目标是让输出能被本地 plantuml 或文档系统稳定渲染，同时让阅读者快速理解边界、角色和消息。

技能如何工作

路由规则明确：UML、C4、企业架构或需要产出 .puml 时使用本技能；轻量 Markdown 内嵌图优先交给 Mermaid；明确要求 ProcessOn 或托管编辑时再走对应技能。
核心工作流：从请求与源材料中提取 actor、component、type、state、message、deployment node，选择合适图族与抽象层级，生成包含 @startuml / @enduml 的完整代码块，并用别名和 package/boundary 控制可读性。
图族覆盖清晰：运行时交互使用 sequence/participant/actor，静态类型模型使用 class/interface/relationships，逻辑架构使用 component/package/interface，运行时拓扑使用 node/cloud/database/artifact，生命周期用 state，流程控制用 start/if/while/fork/stop，用户目标用 actor/usecase，C4 模型使用 C4 include 及 Person、System、Container、Component。
写作约束：别名只定义一次并保持一致；关系上补充 protocol 或 purpose；逻辑架构与部署拓扑拥挤时拆图；C4 的 context、container、component 层级不混用；不使用远程 !include，除非用户接受网络依赖渲染；不虚构未证实的组件、协议、多重性或调用。
校验优先：优先用本地 PlantUML 渲染验证；没有渲染器时做结构检查，包括起始/结束指令是否匹配、别名与引用元素是否定义、关系方向和多重性是否有意给出、目标环境是否具备 C4 includes、源码是否泄漏 secret 或机器路径。

适用边界与注意点

适合需要独立 .puml 资产、C4/企业架构图、复杂依赖关系表达的场景。不适合追求极简内联草图或需要交互式托管编辑的场景；这类需求应切换到 Mermaid 或 ProcessOn 技能。默认内联返回 PlantUML 源码，只有用户要求或项目已有文档树约定时才保存 .puml，推荐 docs/diagrams/ 且绝不静默覆盖。