SuperAPI AI 工具集

technical-decision-record

办公与效率

查看项目

更新于 10-15 20:11

技能介绍

用途:在做出技术选型、架构变更、第三方服务选择或更改既定模式等决策时,创建结构化的 ADR(架构决策记录),让决策可追溯、理由清晰并被团队理解。凡是你希望日后能回看的决策,都适用。

核心原则:决策一旦作出即成为不可变历史,ADR 只被取代而非修改,以保留当时的推理;重视“为什么”胜过“是什么”;倾向于可逆的决策,并记录不可逆选择的回退成本;未写下即未决定,口头共识不算数;决策应由受影响方评审。

使用流程:1)明确要决定的问题,并说明触发原因;2)列出约束,包括技术、业务与合规方面;3)枚举 2-4 个真实选项,写明描述、优缺点与预估成本;4)明确选定一个选项,并记录决策者与时间;5)记录后果,包括正面收益、需接受的成本、风险及回退难度。

模板包含:标题与编号、状态(Proposed/Accepted/Superseded by ADR-X)、日期、决策者、Context、Constraints、Options Considered(各选项的优缺点)、Decision 及理由、Consequences(Positive/Negative/Risks/Reversibility)。

常见误区:不列选项就决策、把时间花在可逆的小决策上、遗漏受影响方、用修改替代取代旧 ADR。

限制:资料未提供具体安装命令、平台与收费信息,暂未提供。