| name | wiki-diagram |
| description | Add Mermaid diagrams to wiki pages to aid understanding. This skill should be used during ingest/review when a concept involves a process, architecture, sequence, hierarchy, or comparison that is easier to grasp visually, or when the user explicitly asks to "画图"/"配图"/"diagram"/"visualize" a concept. |
Wiki Diagram — Mermaid 可视化
用 Mermaid 给概念页配图。Obsidian 原生渲染 ```mermaid 代码块，无需安装插件。
何时配图 When to Diagram
只在"文字描述比图更难懂"时配图，不要每页都加。适合配图的情况：
- 多步骤流程/算法 → flowchart
- 协议交互/攻击步骤，含时序（适合 COMP4337） → sequenceDiagram
- 系统架构/模型结构，含组件关系 → flowchart
- 概念分类/知识地图 → mindmap
- 状态转换/生命周期 → stateDiagram-v2
- 概念间关系网（跨课程连接） → graph
不适合配图：单一定义、纯数学公式推导、线性叙述无分支无关系的内容。
图表类型映射 Diagram Type Mapping
| 内容类型 | Mermaid 类型 |
|---|
| 算法步骤/数据处理流程 | flowchart TD |
| 协议/攻击交互序列 | sequenceDiagram |
| 模型架构/系统组件 | flowchart LR |
| 概念分类/知识地图 | mindmap |
| 状态机/生命周期 | stateDiagram-v2 |
| 概念间关系网 | graph TD |
放置位置 Placement
在概念页的 直觉 Intuition 或 详细解释 Detailed 章节之后，新增 ## 图解 Diagram 小节。局部插入，不重写全页。
## 图解 Diagram
\`\`\`mermaid
flowchart TD
A[输入 Input] --> B[处理 Process]
B --> C[输出 Output]
\`\`\`
质量规则 Quality Rules
- ≤10 个节点：超过就简化或只画核心路径
- 双语标签：节点文字用"中文 English"或保持和页面其他部分一致的语言风格
- 一页最多 1-2 个图：避免视觉噪音
- 语法要对：节点 ID、箭头、括号/引号配对正确，避免渲染失败
- 若图表来自课件原图：先在来源页文字描述要点，再判断是否用 Mermaid 重绘成更清晰的逻辑图（不需要 1:1 还原）
触发方式 Triggers
- 自动：ingest/review 创建或更新概念页时，按上述标准判断是否需要配图（见 wiki-ingest 步骤）
- 手动：用户说"画图"/"画个图"/"配图"/"diagram this"/"visualize X"，或用
/diagram {concept} 命令，针对指定概念页生成/补充图表
