SuperAPI AI 工具集

plantuml

部署与运维

查看项目

更新于 10-15 21:48

技能介绍

用途:为 UML、C4、企业架构或 .puml 输出生成结构有效、语义明确、布局可读的 PlantUML 源码,也可修订已有源码。

主要能力:支持多种图族,包括时序图(sequence、participant、actor)、类图(class、interface、关系)、组件图(component、package、interface)、部署图(node、cloud、database、artifact)、状态图(state、[*])、活动图(start、if、while、fork、stop)、用例图(actor、usecase)以及 C4 模型(C4 include 加 Person、System、Container、Component)。

使用方式:先从需求与来源中提取参与者、组件、类型、状态、消息或部署节点,选定图族与抽象层级,再生成带匹配起止指令的完整源码块。长名称使用别名,用 package/boundary 做有意义的分组。标准 UML 图用 @startuml 与 @enduml 包裹。有本地渲染器时进行验证,否则做结构检查。仅在用户要求或需并入现有文档树时保存 .puml 文件,默认路径建议 docs/diagrams/<descriptive-name>.puml,且不得静默覆盖。

路由:需要 UML、C4、企业架构或 .puml 输出时选 PlantUML;需要直接嵌入 Markdown 的轻量图时选 mermaid 技能,安装命令为 npx skills add full-stack-skills/document-skills --skill mermaid;明确需要托管编辑或 ProcessOn 输出时选 processon-diagram-generator 技能,安装命令为 npx skills add full-stack-skills/document-skills --skill processon-diagram-generator。当请求的记法或目标格式已确定渲染器时,不要询问用户选择。

限制:避免远程 !include 依赖,除非用户接受依赖网络的渲染;不得编造无证据支持的组件、协议、多重性或调用;C4 各层级需保持区分,不无故混用上下文、容器与组件细节;源码中不得出现密钥或机器特定路径。验证清单包括起止指令匹配、别名与引用元素已定义、关系方向与多重性符合意图、目标渲染环境支持 C4 include、本地渲染成功。