architecture-designlisted

# 全项目架构设计（Architecture Design） 从一句想法到可交付的完整项目。本技能的目标不是"画出漂亮的架构图"，而是**让接下来的开发一次就做对**：需求不遗漏、设计可追溯、开发有验收、交付有证据。 ## 三个核心机制（为什么这样做） 项目返工的头号原因是**需求遗漏**和**设计与实现脱节**。本技能用三个机制应对，而不是靠自觉： 1. **需求可测**：每条需求写成"用户故事 + WHEN…THE SYSTEM SHALL…"验收标准并编号（REQ-001）。设计、任务、验收全部围绕编号展开，不允许出现"凭感觉做了但没人要"或"要了但没人做"的功能。 2. **双向追踪**：蓝图评审时过"需求追踪矩阵"——每条 REQ 必须有设计覆盖；实施计划中每个任务反向标注"本任务实现哪些 REQ"。 3. **两道门禁**：需求未确认不设计（门禁 1），蓝图未确认不开发（门禁 2）。走到门禁就停下等用户确认，不要自作主张跳过。门禁支持**快速确认**：用户明确预授权（"按你的推荐走，别反复问我"）时，门禁降级为"把采用的假设逐条写进文档，继续推进，到下一个门禁或里程碑再对账"——预授权也是授权，但假设必须落在纸面上。 ## 先分诊：用多重的流程做这件事？ | 档位 | 适用场景 | 流程 | 产出 | |---|---|---|---| | **迷你** | 周末项目、小工具、单人自用 | Phase 0→1→4→9 压缩进行，需求与方案合并为一次确认 | 单文档 docs/architecture/mini-blueprint.md（按 assets/templates/mini-blueprint.md；REQ 编号与验收标准不省略） | | **标准**（默认） | 常规新项目、中型改造 | 完整 12 阶段 | 四份文档 | | **完整** | 多人团队、长周期、高出错代价 | 完整 12 阶段，另加模块级设计评审、ADR 全量落档 | 四份文档 + 模块级设计文档 | 拿不准时选标准档；用户说"简化点/别搞那么重"就降一档。反过来，改 bug、调样式、加小字段这类改动**不需要本技能的全流程**——直接做，别为改一行代码建 docs/architecture/。 ## 工作流总览 ```mermaid flowchart TD P0["P0 上下文扫描"] --> P1["P1 需求摸底"] P1 --> G1{{"🚪 门禁1：需求确认"}} G1 --> P2["P2 规模估算"] P2 --> P3["P3 技术选型"] P3 -. 风格与栈互相约束，允许回溯迭代 .- P4["P4 架构设计"] P4 --> P5["P5 数据与接口"] P5 --> P6["P6 质量与运维"] P6 --> P7["P7 决策记录"] P7 --> P8["P8 蓝图评审"] P8 --> G2{{"🚪 门禁2：蓝图确认"}} G2 --> P9["P9 实施计划"] P9 --> P10["P10 开发执行"] P10 --> P11["P11 验收交付"] P11 -. 收敛反查：偏差转新任务 .-> P9 ``` 各阶段按需读对应参考文件（references/），按模板产出文档（assets/templates/）。不确定该读哪个时，按下表： | 阶段 | 读 | 产出 | |---|