Claude Code 编写架构决策记录

Claude Code 安装步骤

打开 GitHub 固定提交的 `.claude/skills/plan-adr/SKILL.md`，核对内容与使用条件。
在自己的项目中创建 `.claude/skills/plan-adr/`，把核对后的文件保存为 `.claude/skills/plan-adr/SKILL.md`。
在该项目根目录启动 Claude Code，在斜杠菜单中选择 `/plan-adr`。

把重大技术取舍整理成拟议状态的架构决策记录，写清触发原因、备选案、好处和代价。

排练表打算在浏览器本地生成打印版。已有 ADR-0007。材料给出 `{decision:'browser print',alternative:'server PDF',reason:'work offline'}`。本地打印能离线工作，但版式要考虑浏览器差异。

下一份记录使用 `0008-browser-print.md`，状态为 Proposed。说明为何要离线、选择浏览器打印、为何没有选择服务器生成 PDF，以及版式随浏览器变化的代价。人工同意后才改为 Accepted。

GitHub 原文 · 更新日期 2026-11-14

Claude Code 项目与已有架构决策目录。编号就从当前文件确认，最终接受由人工决定。

先从现有记录确定编号，以 Proposed 写清背景、决策、备选和后果。接收人工对内容的批准后，才更新状态。