SuperAPI AI 工具集

adr-create

通用与其它

查看项目

更新于 10-16 08:47

技能介绍

用途:在技术决策发生的当下,以 ADR(架构决策记录)格式记录决策。适用于引入新依赖、变更架构、选择设计模式等重大决策,也适合在实施有争议或不直观的方案前记录,或与 create-plan 中的架构选择配套使用。

主要能力:引导确认决策内容、触发原因、备选方案及选定理由;从项目收集受影响模块、既有模式、性能与兼容性等约束及参考资料;自动确定 ADR 编号;按固定结构创建文件 docs/adrs/ADR-NNN-<title>.md,含状态、日期、背景、决策、备选方案(优缺点与否决理由)、后果(正面、负面、风险)和引用;若取代旧 ADR 则更新其状态,并在相关计划变更日志或模块文档中交叉引用。

使用方式:由主智能体直接运行本技能,用 question 工具澄清决策,然后收集上下文并写入文件。确定编号可执行:ls docs/adrs/ 2>/dev/null | grep -o 'ADR-[0-9]*' | sort -t- -k2 -n | tail -1;若目录不存在则创建并以 ADR-001 起步。

规则与限制:必须写明“为什么”及被否决的备选方案,至少记录一个备选方案;后果须真实列出正反两面;长度控制在 1–2 页;已接受的 ADR 不可修改,决策变化需新建 ADR 取代;不使用内置 explore 子代理。输出路径固定为 docs/adrs/。其余细节资料未提供。