用途
architecture-decision 是一个用于编写 ADR（架构决策记录）的技能，把一项技术决策整理成文档，包含背景、考虑过的备选方案与后果。它应用于游戏开发项目，与工程引擎、GDD 与故事流程衔接。
主要能力
- 解析参数并进入不同模式：普通 ADR 编写、以
retrofit开头的追溯补写模式（见 references/0-retrofit.md）、以accept开头的接受模式（见 references/0-accept.md）。 - 无参数时先询问要记录的技术决策标题。
- 始终先加载引擎上下文（references/1-engine-context.md）。
- 扫描 docs/architecture/ 确定下一个 ADR 编号。
- 收集上下文（references/3-gather-context.md），协作式引导决策（references/4-decide.md），生成 ADR（references/5-generate.md）。
- 按 team.size 决定验证 ADR 的智能体：individual（默认）与 small、studio 均为 technical-director（TD-ADR）加引擎专家；任何规模都不启动引擎子专家或对抗性评审者。
- 按 docs.density 控制正文详略：terse（默认，经 rigor: minimal）为要点式；balanced（rigor: standard）为每节一段；thorough 为完整叙述。Engine Compatibility、ADR Dependencies、GDD Requirements 表格为结构性内容，任何密度下都保持完整。
- 按 workflow 决定必需范围：full 要求完成全部必需 ADR；standard 仅关键 ADR（Foundation 层系统）；minimal 不要求，仍可自愿运行。
使用方式
调用技能并给出标题或 retrofit / accept 加文件路径或 ADR id 的参数。全文多处为占位脚本与配置解析（如 yaml-helper.sh resolve_config）以及指向 references/ 与 .claude/docs/ 各文件的步骤引用，具体步骤在对应文件中，不在本页展开。
收尾与限制
ADR 写入后（可选择性更新 registry）以 AskUserQuestion 收尾，列出所有剩余优先 ADR、在前提 ADR 全部完成后可出现的“开始编写 GDD”选项，以及停止选项。收尾输出须包含固定提示：在全新 Claude Code 会话中运行 /architecture-review 以对照 GDD 验证 ADR 覆盖；禁止在同一会话中运行 /architecture-review，因为评审者必须独立于编写上下文。此处不解除故事阻塞：ADR 处于 Proposed 状态，被其阻塞的故事仍为 Blocked，需通过 /architecture-decision accept ADR-NNNN 在被接受后才会转为 Ready，并列出被阻塞故事的路径。
未提供信息
资料未说明该技能的收费、价格、适用平台或具体效果。