Claude Code adr:为长期架构决定写简短记录
EnglishClaude Code 安装步骤
- 打开 GitHub 固定提交的 `.claude/skills/adr/SKILL.md`,核对内容与使用条件。
- 在自己的项目中创建 `.claude/skills/adr/`,把核对后的文件保存为 `.claude/skills/adr/SKILL.md`。
- 在该项目根目录启动 Claude Code,在斜杠菜单中选择 `/adr`。
中文摘要
从现有决策中查出下一个编号,写清为何作决定、选择及后果,并补上相关变更链接。
SKILL.md 中文导读
可复现示例
样例阵列为 {existingAdrs: [8, 9], proposed: 'stable plugin configuration'},新决定是从下一版起让插件入口保留一个长期稳定的配置结构。工作步骤
- 查看已有 ADR 的最高编号,确认新决定影响的长期边界。
- 写入简短的背景、决定与后果,有变更包时补上对应链接。
验收方法
在 docs/decisions/ 记录 {adrNumber: 10, decision: 'stable plugin configuration'}。正文给出背景、决定和带来的兼容性维护成本。
GitHub 原文 · 更新日期
适用环境
在 Claude Code 中打开 agtmux 或遵循同类约定的仓库,准备决策目录、已明确的架构决定与现有编号。
常见问题
适合给容易撤销的小调整建 ADR 吗?
ADR 用于难以撤销或会长期定义接口边界的决定。小调整可继续由实际变更材料说明。