用途:这是 Spec Forge 工作流中的架构阶段,把已批准的 framing 契约转换为顶层方案形态与分解计划,回答整体方案是什么、哪些旅程重要、有哪些组件、哪些角色需在细节工作前评审设计。
主要能力:产出方案大纲、旅程索引、组件索引三类架构产物,并支持基于角色的评审(至少包含 product-manager、ux-architect、tech-lead、qa-lead)。工作方式为从粗到细:先锁定整体方案摘要,再定义自有边界与外部依赖,然后列出顶层旅程与顶层组件。
使用方式:仅在 Plan 模式下运行,非 Plan 模式须停止并提示用户切换。开始前需确认聊天语言与文件语言,并读取 ../spec-forge/assets/contracts/ux-contracts.yaml。入口门要求 Intake 产物存在且已批准,必需输入为已批准的 framing/request-context.yaml 与 framing/role-map.yaml。先运行 spec-forge-cli resolve --target <target-dir> --skill spec-forge-architecture --stage architecture --write,再逐步收集缺失参数并用 spec-forge-cli apply 记录;产物级写入优先用 spec-forge-cli artifact merge --file ...。批准通过聊天摘要进行,随后用 spec-forge-cli approve 持久化,再运行 spec-forge-cli gate check 与 spec-forge-cli stage advance。
输出:architecture/solution-outline.yaml、journey-index.yaml、component-index.yaml 及 gates/architecture.yaml。
限制:不得直接跳到逐文件或逐函数细节;方案摘要不得含糊;旅程与组件索引不得写成大段散文;不得让单一角色主导评审;不得一次性批量收集参数;不得在非 Plan 模式继续;不得要求用户直接查看 YAML 文件。