SuperAPI AI 工具集

plantuml-diagramming

数据与分析

查看项目

更新于 10-15 17:24

技能介绍

用途:该技能专注于 PlantUML 图表语言,将文本描述翻译成图形化表示,涵盖 UML 及非 UML 图形,帮助用户可视化流程、系统、架构、工作流与数据结构。

触发场景:当用户提到 plantuml、UML 图(用例图、序列图、类图)、流程图、活动图、状态图、组件图、对象图,或要求“从文字生成图表”“可视化这段内容”“画一张 UML”“制作线框图/界面草图”时自动调用。

主要能力:根据意图选择合适图型——时间流/API 调用用序列图,数据结构/继承/关系用类图,业务流程/决策用活动图,系统功能与用户交互用例图,对象生命周期用状态图,组件与依赖用组件图,实例快照用对象图,简单流程可用非 UML 流程图。支持 skinparam 样式、!theme 主题、颜色字体设置,以及过程(宏)、!include、Salt 线框图等高级特性。

使用方式:生成代码须用 @startuml 与 @enduml 包裹,并用 ```puml 代码块输出(不可用无语言标识的裸代码块,也不可裸露代码)。建议用别名(alias)简化长名称、用方向提示(left to right direction)改善布局、用 box 分组参与者、用 note 补充说明。会附简要结构说明并推荐渲染方式(PlantUML 服务器、VS Code 扩展等)。

适用场景:API 调用与消息流、业务审批流程、订单生命周期、系统组件与部署依赖、静态数据结构、实例快照等。

限制与注意事项:复杂图应拆分,避免 20 个以上参与者;标签不宜过长;括号、箭头与块须闭合;避免用保留字作标识符;需注意 ->、-->、->> 等箭头语义;本地渲染可能需安装 Graphviz;预处理失败常因 !include 路径错误。官方资源包括 plantuml.com 文档、语言指南、在线编辑器与主题库。