技能介绍

你在跟图表死磕时，到底在死磕什么

把脑子里的架构讲清楚，或者把一段混乱的会议纪要画成流程，最常见的死法不是「我不会画图」，而是在三件事之间来回切换：想清楚图该怎么组织、手写 Mermaid 语法试渲染、发现 label 里有括号报错再回头改。更烦的是，图一旦画出来往往被截图塞进 Wiki，后续任何一次结构微调都要从头重画。

这个技能怎么解决

它把重心放在可编辑的源码上。拿到输入后，先判断意图、受众和素材，再按决策表选型：流程和决策树走 flowchart，交互序列走 sequenceDiagram，状态迁移走 stateDiagram-v2，ER 关系走 erDiagram，密集依赖图交给 Graphviz DOT，正式 UML 用 PlantUML，实在表达不了才手写 SVG。写码前先归一化实体、关系、标签、分支和时序信息，生成后做语法校验，最后把源码连同假设一起返回。

几条值得注意的规则：

默认只出一张图，不堆砌替代品；优先用稳定语法，避免老版本渲染器不支持的花哨特性。
节点 ID 只用 ASCII，标签含标点就加引号；长文本拆到图外注释里。
时序图先声明 actor 和 participant，用 alt/loop/par 块表达条件、循环与并行。
输入信息不全时不反复追问，直接做合理假设并标注在 Assumptions 一节。

边界在哪

它输出的是图表源码，不是像素。只有明确要求 PNG/SVG/PDF 时才会调用 scripts/render_diagram.py 渲染，而渲染器（mmdc、dot、plantuml）不一定齐备：脚本会尽力探测本地工具，缺了就给出可操作的安装提示——没跑成功就不要声称图已渲染。另外 Graphviz 和 PlantUML 的安装不在自举范围内，需要手动准备环境。