SuperAPI AI 工具集

ln-24-architecture-decision-recorder

编程与开发

查看项目

更新于 10-16 06:23

技能介绍

用途:把一项具有架构意义的决策记录为紧凑、可长期保存的文档,保留背景、约束、备选方案、决策与后果。它只修改已获批准的决策文档,不设计整个系统、不静默批准决策、不删除历史、不审计代码、不实现该选择。

主要能力:按检查清单推进,条目状态分为 PENDING、PROVEN、CLEARED、UNPROVEN,只有观察到的结果才算证据。记录标题、状态、日期、决策者、背景、驱动因素、备选方案、决策、后果、验证与复审触发条件;区分事实、推断与未验证声明。

使用方式:优先复用仓库已有的 ADR 约定;否则使用 docs/architecture/decisions/NNNN-<slug>.md,取下一个未使用的递增编号。新记录默认 Proposed,仅在授权决策者明确确认后使用 Accepted。替代方案被明确接受后,才将旧记录标记 Superseded 并双向链接,保留历史内容。

适用场景:需要为单个架构选择留下可复审依据时;请求包含多个独立决策时,仅在明确批准后拆分。

限制:不重新编号、删除或改写历史记录的决策与理由;范围不清、编号不安全、所有权冲突或无写入位置时返回 BLOCKED;材料背景或所需批准权限未解决时返回 INCOMPLETE;完整且明确为 Proposed 的记录无需批准即可 READY。输出按 Result、Scope、Evidence、Verification、Completion 顺序报告。