用途:在实现之前撰写 docs/architecture/architecture.md,将全部已批准的 GDD 转化为具体技术蓝图,处于设计与实现之间,必须在冲刺规划开始前存在。它与 /architecture-decision 不同:ADR 记录单个点决策,本技能产出为 ADR 提供上下文的整体系统蓝图。
主要能力与阶段:技能定义 9 个阶段(Phase 0 加载上下文、1 系统分层映射、2 模块归属图、3 数据流、4 API 边界、5 ADR 审计与可追溯性检查、6 缺失 ADR 清单、7 撰写总体架构文档、8 交接),各阶段步骤写在 references/ 目录对应文件中,需按其指示执行;对话被压缩或恢复后应重新读取。支持 workflow 的 full(全部层级、模块归属、数据流、API 边界、完整 ADR 审计)、standard(系统分层图加关键 ADR 列表)、minimal(不要求,仍可主动运行)。参数模式包括无参数/full 完整引导、layers、data-flow、api-boundaries、adr-audit(仅审计现有 ADR 与引擎兼容缺口)。docs.density 控制每节深度:terse(默认,分层图加决策要点)、balanced、thorough。
使用方式:协作模式(默认)下静默加载上下文、呈现发现、先给方案再询问、先展示草稿再批准;写审批须用 AskUserQuestion 的结构化选项,全部章节批准后于 Phase 7 一次性写入。不得在没有用户输入时做有约束力的架构决策。
限制:需搭配 Claude Skill 环境与配置(review_mode、automation、workflow、docs.density 等),具体默认值与引擎版本由项目配置决定,资料未提供更多细节;未提供平台、收费与效果信息。完成后建议依次运行 /architecture-decision、/architecture-review、/test-setup、/ux-design、/create-control-manifest、/gate-check pre-production。