用途
Architecture 技能用于针对特定功能进行架构设计并生成架构文档。其核心产物是 docs/features/<key>/3-architecture.md，包含组件图、数据流、集成点与架构决策。触发关键词包括 architecture、architecture design、architecture doc、component diagram、3-architecture、system design、document architecture。
当需要编写技术规格、进行代码实现、只做架构咨询或制定实现路线图时，本技能并非合适选择，文档建议分别使用 /tech-spec、/feature-dev、/codex-architect、/deep-analyze。
主要能力
- 组件图（Mermaid flowchart）与组件职责表
- 数据流（Mermaid sequence diagram）
- 与现有系统的集成点
- 架构决策（AD-N 格式：上下文 → 选项 → 决策 → 理由）
- 部署考虑事项（如适用）
- 自动插入指向技术规格与需求文档的交叉引用链接
使用方式
命令行用法：
- /architecture：自动检测功能，创建或更新文档
- /architecture <feature-keyword>：指定功能
- /architecture --skip-debate：跳过第三阶段对抗式辩论
参数说明：<feature-keyword> 默认自动检测，用于指定目标功能；--skip-debate 默认 false，用于跳过第三阶段对抗式辩论。
工作流
阶段 0：上下文解析。通过 5 级级联检测目标功能。根据 3-architecture.md 是否存在以及技术规格是否解析成功，决定进入更新（增量）、创建（基于技术规格）或创建（仅代码研究）模式；功能无法解析时触发“需要人工介入”门禁。解析特征通过 node scripts/resolve-feature.js 执行，并设置 scan_error 门禁（当 scan_error 不为 false 时不继续，报告并触发需要人工介入）。
阶段 1：架构研究（并行）。轨道 A 为代码模式分析（后台 Explore 代理，追踪执行路径、映射组件依赖、识别集成点、读取全局文档，输出组件列表+依赖图+集成点）；轨道 B 为技术规格提取（内联读取技术规格第 3 节技术方案、第 4 节风险、第 7 节开放问题）；轨道 C 在 A、B 完成后进行，向 Codex 请求独立架构建议，仅提供功能上下文元数据，不传入 Claude 的结论。Codex 结果的降级处理按结果分别处理：setup-required 或 exit 2 需修复设置；exit 1 可继续但需在输出中说明缺失第三方视角；完成状态未知需等待；exit 0 正常整合。
阶段 2：架构设计。将合并后的研究结果派发给 architecture-designer 代理，按 @skills/architecture/references/template.md 输出模板生成内容；若该代理不可用，回退至 solution-architect 代理。
阶段 3：验证（条件性）。通过 Skill 工具调用 /codex-brainstorm，重点评估可扩展性、可维护性、集成复杂度与可测试性，必须产出 threadId 与平衡结论。跳过条件包括：--skip-debate 标志、范围门禁触发（小功能）、更新模式（增量变更）。降级处理：/codex-brainstorm 超时时，在验证章节记录超时并仍然输出文档。
阶段 4：输出。按输出模板写入 docs/features/<key>/3-architecture.md，并自动触发 /codex-review-doc。
适用范围与限制
范围门禁：对于小型功能（技术规格 WBS 只有 1 个任务，或无技术规格且相关文件少于 3 个），建议将架构保留在技术规格第 3 节中，而非单独创建文档，并通过 AskUserQuestion 确认。
验证清单要求：功能上下文已解析、代码研究完成且在有技术规格时已读取、Codex 建议已整合或将其缺失记录为 exit 1 降级、架构设计包含全部必需章节、Mermaid 图有效、架构决策使用 AD-N 格式并含理由、包含指向技术规格与需求文档的交叉引用、/codex-review-doc 通过、未执行 git add/commit/push。
其他事实性信息（如价格、支持的平台范围等）在资料中暂未提供。