用途:在做出非平凡架构决策、补录应记录却未记录的决策,或为设计评审做准备时,生成架构决策记录(ADR)。不适用于命名、格式等琐碎选择,也不用于运维手册或没有架构影响的产品决策。
主要能力:接收 context(要解决的问题,2–4 句)、options(考虑过的备选方案)、decision(选定路径)三个必填输入,以及可选的 number(ADR 编号);省略编号时会从 memory/decisions/ 中查找下一个可用编号。输出位于 memory/decisions/ADR-NNNN-<slug>.md,并遵循 ADR 模板。
工作流:确定下一个 ADR 编号或使用输入编号;将决策主题转换为 slug;填充模板(Context、Decision、Alternatives、Consequences 含正面与负面,Status 默认为 accepted,也可为 proposed 或 superseded by ADR-XXXX);写入 memory/decisions/ADR-NNNN-<slug>.md;并在 MEMORY.md#decisions 添加一行记录。
成功标准:每个备选方案都有一行“为什么不选”;Consequences 至少包含一项负面后果;文件名需匹配 ADR-\d{4}-[a-z0-9-]+.md。
限制:若一个决策实际包含多个决策,应拆分为多个 ADR;若 context 不清楚,应向用户求证,不得编造。参考资料与模板:../../../templates/ADR.md.template 和 ../../../design_docs/adr_guide.md。安装命令、价格与平台信息暂未提供。