SuperAPI AI 工具集

adr-skill

编程与开发

查看项目

更新于 10-15 23:33

技能介绍

用途:为具有重要替代方案或后果的持久性架构选择创建和维护架构决策记录(ADR),面向智能体编程工作流。常规修复和已确立的实现选择无需新建 ADR;修改受某条已接受记录约束的代码前,应先查阅相关记录。

主要能力:从项目说明、现有决策索引、相关记录、依赖和受影响代码中提取意图,捕获触发条件、约束、备选方案、选定选项、后果、非目标及重新审视条件,并区分用户决策与智能体建议。支持简单模板与 MADR 模板(位于 assets/templates/),可包含受影响路径、模式、实现步骤和可观察验证。

使用方式:先阅读项目说明与现有约定;在 Brain 树中以 .svx 写正文。仅在缺失关键决策时提问;对已定决策的文档化请求无需预访谈。起草后阅读审查清单,修正事实与完整性缺口。将 ADR 链接到受约束代码和实现凭据,并更新现有索引与可视化链接。生命周期操作(接受、拒绝、弃用、取代)需用户授权并遵循项目状态约定,保留历史,取代记录双向链接;仅在检查实现并记录验证后标记为已发布。

工具:scripts/new_adr.js 从模板创建并可选更新索引;scripts/set_adr_status.js 更新状态;scripts/bootstrap_adr.js 按需初始化 ADR 约定。使用前阅读当前帮助。

限制:跟踪器创建与实现是独立动作,除非请求中已包含;选择下一条拟议 ADR 不授权其接受或执行。本地草稿不构成无关的全舰队同步理由。资料未提供具体收费、平台与效果信息。