SuperAPI AI 工具集

architecture-decision-record

编程与开发

查看项目

更新于 10-16 01:18

技能介绍

用途:为任何技术决策生成完整的架构决策记录(ADR),采用广泛使用的 Nygard 格式,让后来者不仅知道决定了什么,还理解为什么这样决定。

主要能力:按固定结构输出 ADR,包含编号与标题、日期、状态(Proposed/Accepted/Deprecated/Superseded)、作者与决策者、Context(背景与关键约束)、Options Considered(至少两个备选方案及优缺点与排除理由)、Decision(用平实语言陈述)、Consequences(正面与负面后果/接受的权衡)、Risks、Implementation Notes、Review Date。附带评分量表(0–40,32 分以上为可交付)与质量检查项,强调背景要解释“为什么”、备选方案要诚实、后果必须包含负面项、风险要指出何种情况会使决策失效。

使用方式:提供 ADR 编号、决策标题、背景、备选方案、最终决策、选择理由、状态、作者与日期,团队背景为可选项。若缺少信息,技能会用标注“(assumed, confirm)”的合理假设补齐并在末尾列出;仅当核心主题本身缺失时才先提问。支持文件包括 references/decision-scoping.md(判断什么值得写 ADR 及 Context 应包含什么)与 templates/adr.md(可自行填写的模板)。

适用场景:记录技术选型、架构选择,或说明为何选择某方案而非其他方案。

限制:资料未提供具体安装命令、收费方式或平台支持信息;不应在决策已完全落地且团队已转向后才补写 ADR,也不应只列被选方案或只写正面后果。