SuperAPI AI 工具集

write-a-adr

编程与开发

查看项目

更新于 10-15 17:31

技能介绍

用途:把对话或工作区中已有的技术问题、设计冲突或决策压力,整理成一份可长期保留的架构决策记录(ADR),并生成一份后续实现任务,使决策转化为可执行的工作。

主要能力:优先整合对话已有上下文;必要时探索代码库以验证判断,避免记录臆测性决策;按照 REFERENCE.md 中的模板撰写 ADR 和任务文档;面向初级开发者,清楚说明决策、实施顺序、验证步骤与风险。

使用方式:先重建问题并确认仍不确定的关键事实;再验证代码库中的架构边界、测试和既有 ADR;然后明确决策、状态(通常为 Proposed)、备选方案与影响;将 ADR 保存为 docs/adrs/YYYY-MM-DD-<descriptive-slug>.md,将任务保存为 docs/issues/<descriptive-slug>.md,必要时自动创建目录;若仓库使用 GitHub、Linear 等跟踪系统且用户要求真实任务,则改为在对应系统中创建。

适用场景:已有 bug、架构问题、技术决策或智能体发现的代码问题,需要留下决策记录并派生可执行任务时。

限制:不替代实际实现;探索代码库应保持克制,不为记录决策而过度改动;缺少会实质影响决策的事实时,应先向用户提一个简明问题;最终回复保持简短,不粘贴完整 ADR,除非用户要求。