AI Skill 大全

技术决策记录

把一次技术选型的背景、备选方案、理由和后果写成标准决策文档,并维护索引与状态流转。

功能与用途

半年前为什么把数据库选成这个、为什么放弃另一个方案,当时参与的人一走就没人说得清,新同事只能靠口口相传或者猜。这个 Skill 把架构决策写成留档的决策记录:先写清楚当初要解决什么问题、有哪些硬性要求,再把认真考虑过的方案及各自利弊列全,写明最终选择和理由,并把正面、负面后果和风险缓解都摊开,最后给出目录结构和索引表。它还提供一句话精简版和专门记录「废弃旧方案并迁移」的模板,以及评审清单。接受后的记录不直接改写,要变更就新写一份取代它。

适用场景

  • 团队刚定下用哪个数据库或网关,你担心半年后没人记得为什么这么:团队刚定下用哪个数据库或网关,你担心半年后没人记得为什么这么选,想把决策当场留档。
  • 要把一个早已被废弃的技术方案从系统里迁走,需要写清楚当初为什:要把一个早已被废弃的技术方案从系统里迁走,需要写清楚当初为什么用、现在为什么换。
  • 新同事入职总要问一圈「为什么当初这么设计」,想用一批决策记录:新同事入职总要问一圈「为什么当初这么设计」,想用一批决策记录替代反复口头解释。

适用人群

  • 后端架构师
  • 技术团队负责人
  • 新加入项目的开发工程师

使用步骤

  1. 说明技术选型的背景、业务诉求与硬性约束。
  2. 列出所有候选技术方案并客观梳理利弊与取舍。
  3. 明确选定方案并详述推导理由与可能产生的后果。
  4. 选择合适格式生成决策记录,并更新索引状态流转。

开始使用

将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。

查看 MCP 接入说明

技术信息

分类
编程
适用工具
Codex、Claude Code、OpenClaw、Hermes、国内 Agent
使用难度
入门
版本
main
最近更新
2026-09-11
文件数
3
安装包大小
自动生成 ZIP
安全检查
基础检查通过

Write and maintain Architecture Decision Records (ADRs) following best practices for technical decision documentation. Use when documenting significant technical decisions, reviewing past architectural choices, or establishing decision processes.

依赖与权限

  • 读取用户主动提供的内容

同类 Skill