关于 spec-loop-write-adr
spec-loop-write-adr 是用于撰写和更新 ADR 的技能，面向由用户请求或 Spec Loop 流程启动 ADR 工作的场景。它要求先检查未决决策，并按 ADR 各章节整理依据。
主要功能
- 01撰写与更新 ADR
- 02检查重要未决决策
- 03按章节归类输入
- 04以 Analysis 记录决策依据
适用场景
- 01根据请求起草 ADR
- 02在新决策出现时暂停并请求澄清
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/spec-loop-write-adr确认已加载。
附带文件adr-format.md
详细介绍
仅将此技能用于编写 ADR。
开始编写前，请先阅读 adr-format.md， 并遵照其中的要求。
请阅读并遵循项目说明，例如存在时的 AGENTS.md。
此技能用于编写 ADR。它不会自行判断是否需要 ADR。只有在用户提出要求，或 Spec Loop 工作流将任务交由 ADR 处理时，才开始 ADR 工作。
正在起草或更新的 ADR 是此技能的权威依据。
无论任务是否同时存在任务工件，都使用相同的 ADR 格式。
必须执行的澄清关卡
在将 ADR 起草或修订为当前事实之前，检查该决策、决策标准、权衡、可信选项或决策边界方面，是否仍存在任何重要的未决问题。
如果存在，只创建足以安全记录该主题和当前证据的 ADR 结构，然后使用 spec-loop-clarify-task/SKILL.md 与用户沟通。在继续之前，不要等待用户明确要求澄清，也不要以无结构的标准讨论或头脑风暴代替此交接。
如果后续 ADR 起草过程中出现新的重要未决问题，请重新执行此关卡。
编写或修订前，将每项输入归入适当的章节：
Context= 决策前的事实，即使采用其他可信选项也仍然成立，例如需求、约束、当前状态调查结果、范围边界和明确暂缓的事项；Alternatives= 可信的竞争选项；Analysis= 已澄清的推理、已接受的标准、权衡、选项比较，以及所选方案胜出的简要理由；以及Decision= 所选结果的概要，包括构成结果一部分的任何明确暂缓事项或主要保留边界。
将 Analysis 视为 ADR 中权威的决策与理由记录。
不要在其他章节以决策与理由的形式重复 Analysis 中的内容。
如果存在任务工件，请将其 Research、Analysis 以及其他与 ADR 相关的章节（例如 Constraints、Design，以及适用时的 Scenario）作为 ADR 的主要输入。否则，使用已确认的对话澄清和其他当前证据。