用途:为一次具有架构意义的设计决策撰写 ADR(架构决策记录),记录决策及其理由。ADR 存放在仓库根目录的 adr/ 目录,按顺序编号。
主要能力与流程:先查看 adr/ 目录中已有编号,取最大编号加一,补零到 4 位(如 0002);从用户处收集动机问题、决定内容、考虑过的替代方案、预期后果与当前状态(默认 Proposed);若用户已提供设计文档、PR 讨论或先前对话内容,则从中提取而非重复询问;按 assets/adr-template.md 的结构写入 adr/NNNN-<slug>.md,slug 为简短 kebab-case 摘要;完成后向用户展示文件路径并询问是否修改。
模板结构:遵循 Nygard 格式(Status、Context、Decision、Consequences),并加入 Date、Rationale、Considered Options。需填写标题、状态(Proposed、Accepted、Rejected、Deprecated、Superseded,默认 Proposed,被取代时注明 Superseded by / Supersedes)、日期(YYYY-MM-DD,默认今天)、Context(背景与推动因素,可引用 issue、PR、先前 ADR)、Option A/B(可选,列出方案与利弊)、Decision(明确简洁,主动语态)、Consequences(正面、负面,Neutral 可选)、Rationale(可选)。
适用场景:需要记录某项重大技术或架构选择时;一次决策写一份 ADR;内容保持 1-2 页,面向未来读者;接受后的 ADR 不再修改,如需更新则写新 ADR 取代之;状态生命周期为 Proposed → Accepted(或 Rejected),后续可 Deprecated 或 Superseded。
限制与注意:Considered Options 与 Rationale 可选但非平凡决策建议填写;Consequences 下 Neutral 子节可选;未经用户同意不要暂存或提交 ADR。其余细节(如具体平台支持、收费等)资料未提供。