用途
Architecture Diagram Builder 用于创建当前或目标架构图，并将其作为主要交付物。它的目标是用最小的一组可理解、有证据支撑的图，沟通当前或拟议的架构。技能明确限定：只修改已批准的架构文档；不虚构关系、不进行视觉产品设计、不替代文字证据、不审计架构健康度、不编辑实现代码。
主要能力
- 建立图表契约：确定受众、问题、当前或目标状态、范围、已批准的目标位置和所需符号。
- 构建架构模型：识别相关人员、系统、应用/数据存储、组件、队列和外部依赖；记录职责、类型、技术、负责人和当前/目标状态；解析关系方向、标签、协议或数据、同步性以及信任或网络边界。
- 选择并绘制视图：按需创建系统上下文视图、容器或部署视图、组件视图、序列或动态视图、数据流或信任边界视图。
- 使图表自描述：添加标题、图表类型、范围、当前/目标标记、目标受众、观察或提案日期、图例、关系标签和证据注释。
- 验证与报告：验证语法，检查渲染可读性，对照实现证据验证当前状态元素和关系，并给出 READY、INCONCLUSIVE 或 BLOCKED 结论。
使用方式
技能通过有序清单作为完成定义，逐项内部跟踪为 PENDING、PROVEN、CLEARED 或 UNPROVEN。阅读、委托或工具失败不算证明。每个部分后对账，返回前解决所有 PENDING，只统计 PROVEN 和 CLEARED。工具路由方面：架构证据优先使用仓库文件、运行时接线、IaC、契约和已批准工件；关系追踪优先使用语言智能、依赖工具和聚焦搜索；图表格式优先使用现有仓库约定和渲染器，回退到 Markdown 中的 Mermaid，再回退到纯 ASCII；语法验证优先使用仓库渲染器、解析器或预览，回退到手动检查围栏、标识符和关系；文档变更采用对已批准图表工件的最小补丁，若路径或证据边界不安全则返回 BLOCKED。
适用场景
适用于需要向特定受众沟通系统范围与外部参与者、职责与可部署性、复杂区域的内部边界、关键成功/失败/重试/超时/恢复/迁移交互，以及安全、隐私、驻留或记录系统问题的场景。
限制
不适用于 UI 设计、架构审计或凭空构造结构。可执行行为对当前状态具有权威性。当前、目标和过渡视图必须明显区分。不确定的元素或关系应标记为 UNKNOWN，而不是为了美观补全。没有渲染器时，视觉可读性记为 UNPROVEN；手动语法检查不是渲染证明。