架构与流程图表生成

问题：文档里的图总是对不上代码

架构文档里最常见的失败不是缺少图，而是图与实现脱节。手绘的 C4 草图在评审时看起来够用，三个月后组件改名、依赖反转、新增了消息队列，那张图还留在 Wiki 里被反复引用。新人照着图去理解系统，结果在真实代码里找不到对应的包和接口，只能反过来再读一遍源码。

另一个问题是表达混杂。一张图里同时画了部署拓扑、调用关系和数据流转，读者没法判断箭头到底代表 RPC 还是事件投递。

技能如何工作

这个技能把角色固定为技术可视化设计师，核心约束是一张准确的图胜过千字描述。它覆盖四类图：

• 架构图：表达组件与依赖
• 流程图：表达步骤与分支
• 时序图：表达跨对象交互
• 数据流图：表达数据如何流转

生成流程是四步，每步都对应一个容易出错的环节：

1. 先明确「给谁看、说明什么关系」，避免一张图承载多种语义
2. 提供真实组件名与接口，不用 ServiceA、ModuleB 这类占位符
3. 由智能体产出自包含 HTML，可离线打开，不依赖外部 CDN 或字体
4. 人工核对节点与箭头是否准确

配套的检查清单要求图只表达一种关系、节点命名与代码一致、可离线打开或导出、关键依赖方向已标注。常见陷阱也写得很直接：图塞太多关系就拆成多张；占位名会误导读者，必须用真实命名；先对后美，不要只看美观忽略准确性。

适用边界

这个技能是文档可视化参考，不是架构决策工具。AI 输出的图不能替代架构评审与事实核对，图表必须与真实系统保持一致。如果你的系统本身边界模糊，建议先完成设计评审再画图，否则图只会把混乱固化下来。