用途:把杂乱或结构化的输入转成清晰、可编辑的图表。默认先产出文本图表源码,便于审阅、版本管理和迭代;只有用户明确要图片/PDF 或可下载产物时才渲染成文件。
主要能力:支持 Mermaid(flowchart、sequenceDiagram、stateDiagram-v2、erDiagram、classDiagram、gantt、mindmap、journey、gitGraph、sankey-beta)、Graphviz DOT、PlantUML 和 SVG。内置语言选择决策表:流程/决策树用 Mermaid flowchart;系统交互用 sequenceDiagram 或 PlantUML sequence;状态机用 stateDiagram-v2;数据库结构用 erDiagram;类模型用 classDiagram;项目排期用 gantt;层级/想法用 mindmap;旅程用 journey;git 历史用 gitGraph;密集依赖图用 Graphviz DOT;分层架构用带 subgraph 的 flowchart、Graphviz cluster 或 PlantUML C4 风格;自定义视觉用 SVG。
使用方式:先识别意图、受众和素材,选择图表族与语言,规范化实体、关系、标签、状态、分支和时间信息,再生成简洁源码并做语法校验。生成文件时运行:python "<SKILL_ROOT>/diagram-generator/scripts/render_diagram.py" input.mmd --format svg --out output.svg(DOT 用 --format png,PlantUML 用 --format svg)。<SKILL_ROOT> 为 skills/ 目录实际路径,需自动检测。
限制:渲染器依赖本地工具,Mermaid CLI 可用 npm install -g @mermaid-js/mermaid-cli 自动安装,Graphviz 与 PlantUML 需手动安装;渲染器不可用时脚本输出安装提示而非报错,未成功完成且输出文件不存在时不得声称已渲染。信息不足时做合理假设并标注,不反复追问。输出策略:始终提供可编辑源码(除非用户只要图片),默认给单一最佳图,使用简短标签、ASCII 节点 ID,保留用户术语并统一大小写。
适用场景:流程图、架构图、攻击路径图、时序图、数据库 ER 图、类图、甘特图、思维导图、旅程图、git 图、依赖图等;生成图表可嵌入 docs-generator 报告,攻击路径图可配合 pentest-tools 渗透报告。
其他:中文请求用中文回复,英文请求用英文回复。