skills/diagram-generator/SKILL.md·查看原始 Markdown·索引

name: diagram-generator description: generate, refine, validate, and render diagrams from natural language, notes, code snippets, schemas, tables, or existing diagram source. use for flowcharts, swimlanes, sequence diagrams, state diagrams, er diagrams, class diagrams, architecture/c4-style diagrams, dependency graphs, gantt charts, mind maps, user journeys, sankey-style flows, org charts, network graphs, and other visual models. supports mermaid by default, graphviz dot for complex graph layout, plantuml for uml-heavy engineering diagrams, and svg output when direct markup is more reliable.


Diagram Generator

Purpose

Create clear, editable diagrams from messy or structured inputs. Prefer text-based diagram source first so the result can be reviewed, versioned, and refined. Render to files only when the user asks for an image/PDF or when a downloadable artifact would materially help.

Default workflow

  1. Identify the user's intent, audience, and source material.
  2. Choose the diagram family and language using the decision table below.
  3. Normalize entities, relationships, labels, states, branches, and time/order information before writing diagram code.
  4. Generate concise, readable diagram source.
  5. Validate the syntax mentally and, when creating files, run scripts/render_diagram.py.
  6. Return the diagram source plus a short note about assumptions. When files are generated, include links to the output files.

Do not over-ask for clarification. If the request is underspecified, make reasonable assumptions and label them briefly.

Diagram language decision table

Use Mermaid unless another language is clearly better.

User wants Prefer Why
process flow, decision tree, simple swimlane Mermaid flowchart readable and easy to paste into Markdown
sequence of system/user interactions Mermaid sequenceDiagram or PlantUML sequence Mermaid for docs; PlantUML for UML formality
lifecycle, state machine, transitions Mermaid stateDiagram-v2 or PlantUML state compact transition syntax
database schema, entities, relationships Mermaid erDiagram portable ER notation
class/interface/object model Mermaid classDiagram or PlantUML class Mermaid for docs; PlantUML for detailed UML
project schedule Mermaid gantt concise timeline syntax
hierarchy, ideas, notes Mermaid mindmap good default for idea maps
customer/product journey Mermaid journey built-in journey notation
git history Mermaid gitGraph built-in git notation
dependency graph, package graph, large network Graphviz DOT better layout engines for dense graphs
architecture with layers, clusters, boundaries Mermaid flowchart with subgraphs, Graphviz clusters, or PlantUML C4-style choose based on requested fidelity
weighted flow/sankey-like relationship Mermaid sankey-beta when supported, otherwise SVG or Graphviz Mermaid support may vary by renderer
custom visual where source languages fit poorly SVG precise control over layout and styling

Output policy

Mermaid generation rules

Consult references/diagram-patterns.md for compact templates.

General Mermaid rules: - Start with the correct diagram directive, for example flowchart TD, sequenceDiagram, erDiagram, gantt, mindmap, or journey. - For flowcharts, use flowchart TD unless the user asks for left-to-right; use flowchart LR for architecture and pipelines. - Use subgraphs for swimlanes or architecture layers. Name subgraphs with readable labels. - Keep node IDs stable and ASCII-only, for example ingest_service[Ingest Service]. - Quote labels that contain punctuation likely to confuse the parser. - Use decision diamonds for branching: decision{Condition?}. - Use consistent edge labels: -- yes -->, -- no -->, -. async .->, or == critical ==> only when meaningful. - In sequence diagrams, declare participants before messages. Use actor for humans and participant for systems. - Use alt/else/end, opt/end, loop/end, and par/and/end blocks for conditional, optional, repeated, and parallel flows.

Graphviz DOT generation rules

Use Graphviz for large, dense, or layout-sensitive relationship diagrams.

PlantUML generation rules

Use PlantUML when the user asks for UML or needs formal UML notation.

SVG generation rules

Use SVG only when text diagram languages cannot express the requested visual reliably.

Rendering files

When the user asks for PNG/SVG/PDF, create a source file and run:

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/ 目录的实际路径,AI 应自动检测。

The renderer is intentionally dependency-tolerant. It tries common local tools and reports actionable installation hints if a renderer is unavailable. Do not claim an image was rendered unless the script completed successfully and the output file exists.

Validation checklist

Before finalizing:

Common response template

Use this structure for most diagram answers:

下面是可编辑的 [language] 版本:

```[language]
[source]

Assumptions: - [only if needed]

Rendered file: [link] [only if generated] ```

For English user requests, respond in English. For Chinese user requests, respond in Chinese unless they ask otherwise.


按需自举(On-Demand Bootstrap)

自动化能力边界

工具 可自动安装 安装方式 说明
Mermaid CLI (mmdc) ✓ npm install -g @mermaid-js/mermaid-cli 渲染 Mermaid 为 PNG/SVG
Graphviz (dot) ✗ 手动安装 https://graphviz.org/download/
PlantUML ✗ 需要 Java + plantuml.jar https://plantuml.com/download
Python (render script) ✓ 已在 bootstrap 中 scripts/render_diagram.py 依赖

说明

本 skill 主要输出文本格式的图表源码(Mermaid/DOT/PlantUML),不一定需要本地渲染工具。只有当用户明确要求生成 PNG/SVG/PDF 文件时才需要对应的渲染器。

如果渲染器不可用,scripts/render_diagram.py 会输出安装提示而不是报错。


路由上下文

上游入口: skills/SKILL.md(总控)、routing.md 触发条件: 用户说"画图"、"流程图"、"架构图"、"攻击路径图"、"时序图"、"Mermaid"、"Graphviz"、"PlantUML" 下游出口: - 生成的图表可嵌入 docs-generator/ 的报告中 - 攻击路径图可配合 pentest-tools/ 的渗透报告

同级关联模块: docs-generator/(报告中嵌入图表)