SuperAPI AI 工具集

architecture-decision-records

智能体与模型

查看项目

更新于 10-15 21:08

技能介绍

用途:在编码会话中捕捉架构决策,把原本散落在聊天、PR 评论或记忆中的决定,整理成与代码同库的结构化 ADR 文档。

主要能力:自动识别决策时刻(如明确说“记录这个决策”“ADR this”,或在框架、库、模式、数据库、API 设计间做出取舍,或说“我们决定……”);按 Michael Nygard 轻量格式生成 ADR,包含标题、日期、状态、决策者、Context、Decision、Alternatives Considered、Consequences、Risks;扫描 docs/adr/ 自动编号;维护 docs/adr/README.md 索引表;支持查询既有 ADR 回答“为什么选 X”。

使用方式:首次使用需用户确认后才创建 docs/adr/ 目录、README.md 索引和 template.md;检测到决策后提取核心选择、收集上下文、记录备选与后果、分配编号,草稿经用户明确批准后才写入 docs/adr/NNNN-decision-title.md,拒绝则丢弃不写文件;随后更新索引。查询时先看 docs/adr/ 是否存在,再查索引并展示 Context 与 Decision。

适用场景:技术选型、架构模式、API 设计、数据建模、基础设施、安全、测试与流程类决策。

限制:隐式信号只建议记录,不自动创建;不记录变量命名等琐碎决策;ADR 应保持简短;状态生命周期为 proposed → accepted → deprecated 或 superseded by ADR-NNNN,被取代时需链接新 ADR。具体安装命令与收费信息暂未提供。