技能介绍

要解决什么问题

很多团队在「写愿景文档」和「画架构图」之间缺少同一套决策节奏：愿景里拍脑袋的定位，后面 ADR 里又对不上；或者架构选型直接落盘，没有约束采集和对比就写进 ADR，后续 Backlog 里的 T-NNN 也挂不住依据。

本技能把战略层收成两阶段、三个文件：agile-docs/VISION.md（阶段 A）、agile-docs/ARCHITECTURE.md 与 agile-docs/ADR.md（阶段 B）。每个产出阶段前先过决策问询，问完并确认才写入；阶段 A 写完必须停下，禁止跨阶段顺手写架构或待办。

如何工作

阶段 0：无文件产出，按 interview-protocol 做决策问询；写前若发现多份矛盾输入或与现有 VISION/ADR 冲突，先生成或引用 STRATEGY_CONFLICT.md，不进入问询。

阶段 A（VISION）：文档优先读 DOD.md 项目画像与已有文档；按决策点清单（电梯演讲、用户画像、定位声明、原则、红线、只做清单、成功指标等）一次一问，每题给候选 + 推荐 + 自定义；关键决策落盘标注来源（用户给出 / agent 推断 / agent 推荐待确认）。产出后输出确认清单，等用户选择「继续阶段 B」或「更新愿景」。

阶段 B（架构 + ADR）：四步选型裁决——约束采集 → 系统边界与容器划分 → 必答话题清单（存储、缓存、认证、部署等，未提及必须问，不许静默默认）→ 逐项候选对比与用户裁决后才写入 ADR。ARCHITECTURE.md 含 C4 Level 1/2（Mermaid）；ADR.md 为索引 + 每章严格四行结构，已接受章节不可改，变更用新 ADR 替代。

变更：已产出后按 L1/L2/L3 分级（change-matrix），L1 措辞就地改，L2 只重问受影响维度，L3 才完整问询；禁止每次更新整层重访。

边界与注意

前置：agile-docs/ 与 DOD.md 需由 using-agile 就绪；本技能不手写 PRODUCT-BACKLOG / Sprint。
ADR 禁止超出四行结构或塞入选型对比长文（对比在对话中完成）。
若跳过阶段 B 直接去 Backlog，agile-backlog 可能因缺少 ADR 关联被门禁拦截。

截图预览

使用场景

新项目已有 `agile-docs/DOD.md`，要从项目画像出发逐项决策问询后产出首版 `VISION.md`，并在阶段 A 结束后停步确认是否进入架构层。
愿景已确认，需要画 C4 Level 1/2 写入 `ARCHITECTURE.md`，并对存储、认证、部署等未提及话题主动问清、对比候选后再裁决写入 `ADR.md`。
上线后改了核心原则或成功指标，需按变更矩阵 L2 只对受影响维度增量问询，并评估 Backlog 排序是否受影响。
多份输入与现有 VISION/ADR 互相矛盾，在写愿景或架构前先触发写前战略门禁，生成或引用 `STRATEGY_CONFLICT.md` 再决策。