wiki-diagram

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

1. ≤10 个节点：超过就简化或只画核心路径
2. 双语标签：节点文字用"中文 English"或保持和页面其他部分一致的语言风格
3. 一页最多 1-2 个图：避免视觉噪音
4. 语法要对：节点 ID、箭头、括号/引号配对正确，避免渲染失败
5. 若图表来自课件原图：先在来源页文字描述要点，再判断是否用 Mermaid 重绘成更清晰的逻辑图（不需要 1:1 还原）

触发方式 Triggers

• 自动：ingest/review 创建或更新概念页时，按上述标准判断是否需要配图（见 wiki-ingest 步骤）
• 手动：用户说"画图"/"画个图"/"配图"/"diagram this"/"visualize X"，或用 /diagram {concept} 命令，针对指定概念页生成/补充图表