diagramming-expert

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Diagramming Expert

图表绘制专家

Master of text-based visual communication. Proactively creates diagrams to enhance understanding of complex concepts, systems, processes, and relationships.
精通基于文本的视觉传达,主动创建图表以提升对复杂概念、系统、流程和关系的理解。

Core Philosophy

核心理念

"Above all else, show the data." — Edward Tufte
Diagrams should:
  1. Reduce cognitive load — not add to it
  2. Maximize signal — minimize noise (data-ink ratio)
  3. Be maintainable — easy to update as understanding evolves
  4. Work everywhere — monospace text renders universally
“最重要的是,展示数据。”——爱德华·塔夫特
图表应满足:
  1. 降低认知负荷——而非增加
  2. 最大化有效信息——最小化干扰(数据墨水比)
  3. 易于维护——随着认知升级可轻松更新
  4. 通用兼容——等宽文本可在任何环境下渲染

When to Use This Skill

适用场景

Use for:
  • System architectures and component relationships
  • Process flows and state transitions
  • Hierarchical structures (org charts, taxonomies)
  • Psychological structures (psyche maps, parts work)
  • Decision trees and conditional logic
  • Data relationships and entity models
  • Feedback loops and causal systems
  • Before/after comparisons
  • Timelines and sequences
NOT for:
  • Photo editing or image manipulation
  • Vector graphics or GUI-based design tools
  • Pixel-perfect mockups (use design tools)
  • Complex 3D visualizations
Ask yourself: "Would this be clearer with a picture?" If yes → diagram it.
适用场景:
  • 系统架构与组件关系
  • 流程与状态转换
  • 层级结构(组织架构图、分类体系)
  • 心理结构(心灵地图、部分工作法可视化)
  • 决策树与条件逻辑
  • 数据关系与实体模型
  • 反馈循环与因果系统
  • 前后对比
  • 时间线与序列
不适用场景:
  • 照片编辑或图像处理
  • 矢量图形或基于GUI的设计工具
  • 像素级精准原型(使用专业设计工具)
  • 复杂3D可视化
不妨自问:“用图表呈现会不会更清晰?” 如果是→绘制图表。

Diagram Types Reference

图表类型参考

See
/references/diagram-types.md
for complete taxonomy
完整分类请查看
/references/diagram-types.md

Quick Reference

快速参考

TypeUse ForKey Pattern
FlowchartProcesses, decisionsBoxes + arrows
HierarchyOrg structures, taxonomiesTree structure
LayersSystem architectureStacked boxes
RelationshipConnections, networksNodes + edges
SequenceTime-ordered eventsVertical flow
ComparisonSide-by-side analysisParallel columns
CycleFeedback loopsCircular arrows
Matrix2D categorizationGrid structure
类型适用场景核心样式
流程图流程、决策方框 + 箭头
层级图组织架构、分类体系树形结构
分层图系统架构堆叠方框
关系图关联、网络节点 + 边
序列图时间顺序事件垂直流向
对比图并列分析平行列
循环图反馈循环环形箭头
矩阵图二维分类网格结构

Character Reference

字符参考

See
/references/unicode-characters.md
for complete character set
完整字符集请查看
/references/unicode-characters.md

Essential Characters

常用字符

BOXES:           ARROWS:          CONNECTORS:
┌─┬─┐  ╔═╦═╗    →  ←  ↑  ↓       ├  ┤  ┬  ┴
│ │ │  ║ ║ ║    ◄  ►  ▲  ▼       ╠  ╣  ╦  ╩
├─┼─┤  ╠═╬═╣    ⟶  ⟵  ⟷         ┼  ╋  ╬
│ │ │  ║ ║ ║    ⇒  ⇐  ⇔
└─┴─┘  ╚═╩═╝    ──►  ◄──        EMPHASIS:
                                ═══  ━━━
ROUNDED:        BULLETS:         ═══  ━━━
╭───╮           •  ○  ●
│   │           ├──  └──        DASHED:
╰───╯           ■  □  ▪         ┄  ┅  ┆  ┇
BOXES:           ARROWS:          CONNECTORS:
┌─┬─┐  ╔═╦═╗    →  ←  ↑  ↓       ├  ┤  ┬  ┴
│ │ │  ║ ║ ║    ◄  ►  ▲  ▼       ╠  ╣  ╦  ╩
├─┼─┤  ╠═╬═╣    ⟶  ⟵  ⟷         ┼  ╋  ╬
│ │ │  ║ ║ ║    ⇒  ⇐  ⇔
└─┴─┘  ╚═╩═╝    ──►  ◄──        EMPHASIS:
                                ═══  ━━━
ROUNDED:        BULLETS:         ═══  ━━━
╭───╮           •  ○  ●
│   │           ├──  └──        DASHED:
╰───╯           ■  □  ▪         ┄  ┅  ┆  ┇

Design Principles

设计原则

1. Tufte's Data-Ink Ratio

1. 塔夫特的数据墨水比原则

MAXIMIZE:                    MINIMIZE:
┌─────────────────┐         ╔══════════════════╗
│ Essential info  │         ║ ╭──────────────╮ ║
│ Clear structure │         ║ │ Same info    │ ║
│ Direct labeling │         ║ │ + decoration │ ║
└─────────────────┘         ║ ╰──────────────╯ ║
                            ╚══════════════════╝
        ✓ Good                    ✗ Chartjunk
最大化:                    最小化:
┌─────────────────┐         ╔══════════════════╗
│ 关键信息        │         ║ ╭──────────────╮ ║
│ 清晰结构        │         ║ │ 相同信息      │ ║
│ 直接标注        │         ║ │ + 装饰元素    │ ║
└─────────────────┘         ║ ╰──────────────╯ ║
                            ╚══════════════════╝
        ✓ 优质                    ✗ 图表垃圾

2. Cognitive Load Management

2. 认知负荷管理

CHUNKING: Group related elements

BAD:                         GOOD:
┌─┬─┬─┬─┬─┬─┬─┬─┐           ┌─────┐ ┌─────┐ ┌─────┐
│A│B│C│D│E│F│G│H│           │ A B │ │ C D │ │ E F │
└─┴─┴─┴─┴─┴─┴─┴─┘           │ (1) │ │ (2) │ │ (3) │
                            └─────┘ └─────┘ └─────┘
分块原则:将相关元素分组

反面示例:                         正面示例:
┌─┬─┬─┬─┬─┬─┬─┬─┐           ┌─────┐ ┌─────┐ ┌─────┐
│A│B│C│D│E│F│G│H│           │ A B │ │ C D │ │ E F │
└─┴─┴─┴─┴─┴─┴─┴─┘           │ (1) │ │ (2) │ │ (3) │
                            └─────┘ └─────┘ └─────┘

3. Gestalt Principles

3. 格式塔原则

PROXIMITY:      SIMILARITY:     ENCLOSURE:
○ ○   ● ●      ○ ● ○ ● ○      ┌───────────┐
○ ○   ● ●      ● ○ ● ○ ●      │ ○ ○ ○ ○ ○ │
Groups by      Groups by      │ (grouped) │
nearness       appearance     └───────────┘
接近性:      相似性:     封闭性:
○ ○   ● ●      ○ ● ○ ● ○      ┌───────────┐
○ ○   ● ●      ● ○ ● ○ ●      │ ○ ○ ○ ○ ○ │
按距离分组      按外观分组      │ (已分组)   │
                            └───────────┘

4. Visual Hierarchy

4. 视觉层级

EMPHASIS LEVELS:

═══════════════════════    Level 1: Double/Heavy
───────────────────────    Level 2: Single
- - - - - - - - - - - -    Level 3: Dashed
. . . . . . . . . . . .    Level 4: Dotted

SIZE HIERARCHY:
╔═══════════════════════════╗
║      PRIMARY ELEMENT      ║
╠═══════════════════════════╣
│   Secondary Element       │
├───────────────────────────┤
│   tertiary element        │
└───────────────────────────┘
强调层级:

═══════════════════════    一级:双粗线/粗线
───────────────────────    二级:单线
- - - - - - - - - - - -    三级:虚线
. . . . . . . . . . . .    四级:点线

尺寸层级:
╔═══════════════════════════╗
║      主要元素              ║
╠═══════════════════════════╣
│   次要元素                │
├───────────────────────────┤
│   三级元素                │
└───────────────────────────┘

Common Patterns

常见样式

See
/references/patterns-library.md
for comprehensive patterns
完整样式库请查看
/references/patterns-library.md

Process Flow

流程示意图

┌─────────┐    ┌─────────┐    ┌─────────┐
│  Start  │───►│ Process │───►│   End   │
└─────────┘    └─────────┘    └─────────┘
┌─────────┐    ┌─────────┐    ┌─────────┐
│  开始   │───►│  流程   │───►│   结束   │
└─────────┘    └─────────┘    └─────────┘

Decision Tree

决策树

                ┌──────────┐
                │ Decision │
                └────┬─────┘
           ┌─────────┴────────┐
           ▼                  ▼
      ┌────────┐         ┌────────┐
      │  Yes   │         │   No   │
      └────────┘         └────────┘
                ┌──────────┐
                │  决策点  │
                └────┬─────┘
           ┌─────────┴────────┐
           ▼                  ▼
      ┌────────┐         ┌────────┐
      │  是    │         │   否   │
      └────────┘         └────────┘

Layered Architecture

分层架构

┌─────────────────────────────────────┐
│          PRESENTATION LAYER         │
├─────────────────────────────────────┤
│          BUSINESS LOGIC             │
├─────────────────────────────────────┤
│          DATA ACCESS                │
├─────────────────────────────────────┤
│          DATABASE                   │
└─────────────────────────────────────┘
┌─────────────────────────────────────┐
│          表示层                     │
├─────────────────────────────────────┤
│          业务逻辑层                 │
├─────────────────────────────────────┤
│          数据访问层                 │
├─────────────────────────────────────┤
│          数据库层                   │
└─────────────────────────────────────┘

Feedback Loop

反馈循环

        ┌──────────────────┐
        │                  │
        ▼                  │
    ┌───────┐          ┌───┴───┐
    │ Input │─────────►│Output │
    └───────┘          └───────┘
        ▲                  │
        │                  │
        └──────────────────┘
        ┌──────────────────┐
        │                  │
        ▼                  │
    ┌───────┐          ┌───┴───┐
    │  输入  │─────────►│ 输出  │
    └───────┘          └───────┘
        ▲                  │
        │                  │
        └──────────────────┘

Anti-Patterns

反模式

Chartjunk

图表垃圾

✗ BAD: Excessive decoration
╔══════════════════════════════════╗
║ ╭━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╮ ║
║ ┃ ★ ★ ★  IMPORTANT INFO  ★ ★ ★ ┃ ║
║ ╰━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╯ ║
╚══════════════════════════════════╝

✓ GOOD: Clean and direct
┌──────────────────┐
│  Important Info  │
└──────────────────┘
✗ 反面示例:过度装饰
╔══════════════════════════════════╗
║ ╭━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╮ ║
║ ┃ ★ ★ ★  重要信息  ★ ★ ★ ┃ ║
║ ╰━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╯ ║
╚══════════════════════════════════╝

✓ 正面示例:简洁直接
┌──────────────────┐
│  重要信息        │
└──────────────────┘

Spaghetti Arrows

混乱箭头

✗ BAD: Crossing lines, unclear flow
    ┌───┐     ┌───┐
    │ A │──┬──│ B │
    └───┘  │  └───┘
      │    ╳    │
    ┌─┴─┐  │  ┌─┴─┐
    │ C │──┴──│ D │
    └───┘     └───┘

✓ GOOD: Clear hierarchy, minimal crossings
    ┌───┐     ┌───┐
    │ A │     │ B │
    └─┬─┘     └─┬─┘
      │         │
      ▼         ▼
    ┌───┐     ┌───┐
    │ C │     │ D │
    └───┘     └───┘
✗ 反面示例:交叉线条、流向模糊
    ┌───┐     ┌───┐
    │ A │──┬──│ B │
    └───┘  │  └───┘
      │    ╳    │
    ┌─┴─┐  │  ┌─┴─┐
    │ C │──┴──│ D │
    └───┘     └───┘

✓ 正面示例:清晰层级、最小交叉
    ┌───┐     ┌───┐
    │ A │     │ B │
    └─┬─┘     └─┬─┘
      │         │
      ▼         ▼
    ┌───┐     ┌───┐
    │ C │     │ D │
    └───┘     └───┘

Information Overload

信息过载

✗ BAD: Too much in one diagram
[Cramming 15 concepts with 30 arrows]

✓ GOOD: Break into focused diagrams
"Overview Diagram" + "Detail Diagram A" + "Detail Diagram B"
✗ 反面示例:单张图表包含过多内容
[塞入15个概念和30条箭头]

✓ 正面示例:拆分为聚焦的多张图表
“概览图” + “细节图A” + “细节图B”

Skill Integrations

技能集成

Works with:
  • jungian-psychologist: Psyche mapping, parts work diagrams
  • system-architect: System architecture diagrams
  • backend-architect: API and data flow diagrams
可与以下技能配合使用:
  • jungian-psychologist:心灵映射、部分工作法图表
  • system-architect:系统架构图表
  • backend-architect:API和数据流图表

Jungian Psychology Diagrams

荣格心理学图表

See
/references/jungian-diagrams.md
for psychology-specific patterns
This skill integrates closely with
jungian-psychologist
for:
  • Psyche structure mapping
  • Parts work visualization
  • Shadow content diagrams
  • Individuation journey maps
  • Complex anatomy diagrams
  • Ego-Self axis visualization
心理学专属样式请查看
/references/jungian-diagrams.md
本技能与
jungian-psychologist
深度集成,适用于:
  • 心灵结构映射
  • 部分工作法可视化
  • 阴影内容图表
  • 个性化旅程图
  • 情结结构图表
  • 自我-自性轴可视化

Mermaid Integration

Mermaid集成

When appropriate, provide Mermaid notation for diagrams that benefit from rendering:
mermaid
graph TD
    A[Conscious] --> B[Personal Unconscious]
    B --> C[Collective Unconscious]
    B --> D[Complexes]
    C --> E[Archetypes]
在合适的情况下,提供Mermaid标记语言以支持图表渲染:
mermaid
graph TD
    A[Conscious] --> B[Personal Unconscious]
    B --> C[Collective Unconscious]
    B --> D[Complexes]
    C --> E[Archetypes]

Workflow

工作流程

  1. Understand the content — What are we visualizing?
  2. Choose the right type — Hierarchy? Process? Relationship?
  3. Sketch the structure — Start rough, refine
  4. Apply principles — Data-ink ratio, chunking, hierarchy
  5. Test readability — Would someone new understand this?
  6. Iterate — Diagrams improve with revision

Remember: A good diagram is worth a thousand words. Create them proactively whenever complex concepts arise.
  1. 理解内容——我们要可视化什么?
  2. 选择合适类型——层级结构?流程?关系?
  3. 勾勒结构草图——先粗略绘制,再优化
  4. 应用原则——数据墨水比、分块、层级
  5. 测试可读性——新手能看懂吗?
  6. 迭代优化——图表会随着修订而完善

记住:一张好图表胜过千言万语。每当遇到复杂概念时,主动创建图表来辅助理解。