SuperAPI AI 工具集

decision-log

通用与其它

查看项目

更新于 10-16 02:31

技能介绍

用途:在阶段内发生语义裁定、拍板或设计裁决时,将其写成 ADR 并集中存入 docs/decisions/,使「决策 X 的现状」可查询,保留 status 与历史链(superseded 不删除)。触发场景包括用户要求记录裁定、写入决策日志或 ADR,以及查询某决策现状或是否被更改。

主要能力:采用 Nygard 模板,含 Context、Decision、Consequences 三节,并带 Status(proposed/accepted/superseded/rejected)与 Date、相关引用。状态机为 proposed→accepted→superseded,proposed 也可→rejected;被取代时新 ADR 注明 supersedes NNN,旧 ADR 状态改为 superseded 但不删除。查询返回当前 status 与完整链。

使用方式:记录流程为编号(索引最大号+1)、命名 NNN-slug.md、写 ADR、更新 000-decision-log.md 索引表(#/标题/状态/日期)。若项目已有 .handoff/ 存储,则为该 ADR 登记一条编号引用(不复制内容),标题镜像 ADR 序号,正文写路径;无该存储则跳过,不自主建存储。

适用场景:审计裁定、拍板项、设计裁决等需要留痕并可追溯的决策;spec 引用 ADR 编号记录 DoD 变更来源;门禁检查决策日志同步。

限制:每次语义裁定后 3 分钟内完成记录,流程轻量;不写敏感信息(凭据不写值);.handoff/ 与设计文档只引用 ADR 编号,不复制内容以防双源;superseded 后不得删除旧 ADR;不得跳号或覆盖旧文件;项目无 .handoff/ 时不得为登记引用而自建存储,建/迁须用户显式调用。