Claude Code 给架构决策记录补变更修订
EnglishClaude Code 安装步骤
- 打开 GitHub 固定提交的 `.claude/skills/adr-writing/SKILL.md`,核对内容与使用条件。
- 在自己的项目中创建 `.claude/skills/adr-writing/`,把核对后的文件保存为 `.claude/skills/adr-writing/SKILL.md`。
- 在该项目根目录启动 Claude Code,在斜杠菜单中选择 `/adr-writing`。
中文摘要
按背景、决策、备选方案与影响记录技术选择,批准变更后在原决策记录补记原因和影响范围。
SKILL.md 中文导读
可复现示例
ADR-12 原先要求活动清单仅导出文字,已批准 CR-5 加入打印版。已知材料 `{adr:'ADR-12',request:'CR-5',change:'add print view',reason:'request from editors',impact:'rehearsal list'}`,批准日期 2026-08-11。工作步骤
- 核对原架构决策和批准后的变更依据,明确实际影响范围。
- 在原记录中增加带日期和请求编号的修订小节,注明变化和理由。
验收方法
给 ADR-12 加修订,标题包含 `Amendment (CR-5, 2026-08-11)`。写明新增打印版、理由是编辑人员提出需求、影响只及排练列表。原决策和备选表继续保留。
GitHub 原文 · 更新日期
适用环境
Claude Code 工作区与原有架构决策记录。修改已定稿的规格时准备已获批准的变更请求。
常见问题
规格定稿后如何记录已批准的技术变更?
在原架构决策记录中补一节修订,标出请求编号和日期,说明变化、理由及影响范围,保留原决策历史。