用途:把杂乱或结构化的输入转化为清晰、可编辑的图表,覆盖流程图、决策树、时序图、状态机、ER 图、类图、甘特图、思维导图、旅程图、Git 图以及依赖网络图等。
主要能力:优先采用文本图表语言,便于审阅、版本管理和迭代;根据用户意图、受众和素材选择合适的图表语言与类型;规范化实体、关系、标签、状态、分支和时间顺序;生成简洁可读的源码并在必要时校验语法;仅在用户要求图片/PDF 或可下载产物确有帮助时才渲染文件。
图表语言选择:流程图、决策树、简单泳道图默认用 Mermaid flowchart;系统交互用时序图;生命周期和状态机用 stateDiagram-v2 或 PlantUML;数据库模式和实体关系用 erDiagram;类/接口模型用 classDiagram 或 PlantUML;项目排期用 gantt;层级与想法用 mindmap;用户旅程用 journey;Git 历史用 gitGraph;密集依赖或网络关系用 Graphviz DOT;需要精细视觉控制时用 SVG。
使用方式:先识别意图、受众和来源,选定图表族与语言,整理要素后生成源码,必要时运行脚本渲染。渲染命令示例: python "<SKILL_ROOT>/diagram-generator/scripts/render_diagram.py" input.mmd --format svg --out output.svg python "<SKILL_ROOT>/diagram-generator/scripts/render_diagram.py" input.dot --format png --out output.png python "<SKILL_ROOT>/diagram-generator/scripts/render_diagram.py" input.puml --format svg --out output.svg <SKILL_ROOT> 为实际 skills 目录路径,需自动检测。渲染器依赖容忍,缺少工具时会给出安装提示,不声称已渲染除非脚本成功且输出文件存在。
适用场景:需要快速产出可嵌入文档的架构图、攻击路径图、渗透报告配图、业务流程与数据模型说明图;输入不完整时可做合理假设并标注。
限制:主要输出文本源码,本地渲染需相应工具;Mermaid CLI 可通过 npm install -g @mermaid-js/mermaid-cli 安装,Graphviz 和 PlantUML 需手动安装,PlantUML 还需要 Java 与 plantuml.jar。具体平台、收费与价格信息暂未提供。