---
name: Wiki Diagram
slug: wiki-diagram
category: Writing
description: Wiki Diagram adds Mermaid diagrams to wiki pages when a concept is easier to understand visually. Use it for processes, architecture, sequences, hierarchies, comparisons, or when someone asks to diagram a concept.
github: "https://github.com/IssacW228/student-llm-wiki/tree/main/skills/wiki-diagram"
stars: 176
forks: 4
install: "npx degit https://github.com/IssacW228/student-llm-wiki/tree/main/skills/wiki-diagram ~/.claude/skills/wiki-diagram"
installs_to: ~/.claude/skills/wiki-diagram
source_path: skills/wiki-diagram/SKILL.md
collection_size: 9
category_size: 1328
collection_url: "https://dirskills.com/collections/IssacW228/student-llm-wiki"
added: 2026-09-07T05:21:25.433Z
last_synced: 2026-09-07T05:21:25.433Z
canonical_url: "https://dirskills.com/skills/wiki-diagram"
---

# Wiki Diagram

Wiki Diagram adds Mermaid diagrams to wiki pages when a concept is easier to understand visually. Use it for processes, architecture, sequences, hierarchies, comparisons, or when someone asks to diagram a concept.

**Install:**

```bash
npx degit https://github.com/IssacW228/student-llm-wiki/tree/main/skills/wiki-diagram ~/.claude/skills/wiki-diagram
```

## README

# 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` 小节。局部插入，不重写全页。

```markdown
## 图解 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}` 命令，针对指定概念页生成/补充图表