技能介绍

要解决的问题

技术文档里的架构图经常和正文脱节：接口依赖改了，图里还是旧链路；评审后重画一次图，要花大量时间拖节点、调连线。文本是声明式的，图表却常常是手工维护的，这种不同步会直接影响文档可靠性和迭代速度。另一个问题是输出不统一：同一个设计可能需要 SVG 给网页、PNG 给汇报材料、PDF 给归档，但很多工具只支持单一导出，或者自动布局效果不稳定。

技能如何工作

这个技能围绕 D2 的声明式图表脚本组织：你用文本描述节点、连接、分组和标签，再由 CLI 解析并编译成 SVG、PNG 或 PDF。常见流程是先写一个 .d2 文件，用 目标: 说明 定义节点，用 A -> B: 调用 表达关系；随后工具负责自动布局和样式渲染，并支持多套主题。它尤其适合有方向和连接约束的图：服务拓扑、序列图、类图、网络设备连接等。相比在绘图软件里点选，改结构时只需要改文本，再重新生成，图就和描述保持一致。

适用边界与注意点

它不是通用可视化编辑器。适合结构清晰、关系明确的架构图和文档插图；如果需要自由排版、强视觉叙事或手绘风格，自动布局可能不合适。它也要求你接受声明式语法和编译式工作流：前期要花一点时间整理节点与关系，复杂自定义样式可能需要额外配置。另外，团队使用前最好约定命名、主题和输出格式，否则同一个图在不同人手里容易生成不一致的版本。