技术决策记录
把一次技术选型的背景、备选方案、理由和后果写成标准决策文档,并维护索引与状态流转。
功能与用途
半年前为什么把数据库选成这个、为什么放弃另一个方案,当时参与的人一走就没人说得清,新同事只能靠口口相传或者猜。这个 Skill 把架构决策写成留档的决策记录:先写清楚当初要解决什么问题、有哪些硬性要求,再把认真考虑过的方案及各自利弊列全,写明最终选择和理由,并把正面、负面后果和风险缓解都摊开,最后给出目录结构和索引表。它还提供一句话精简版和专门记录「废弃旧方案并迁移」的模板,以及评审清单。接受后的记录不直接改写,要变更就新写一份取代它。
适用场景
- 团队刚定下用哪个数据库或网关,你担心半年后没人记得为什么这么:团队刚定下用哪个数据库或网关,你担心半年后没人记得为什么这么选,想把决策当场留档。
- 要把一个早已被废弃的技术方案从系统里迁走,需要写清楚当初为什:要把一个早已被废弃的技术方案从系统里迁走,需要写清楚当初为什么用、现在为什么换。
- 新同事入职总要问一圈「为什么当初这么设计」,想用一批决策记录:新同事入职总要问一圈「为什么当初这么设计」,想用一批决策记录替代反复口头解释。
适用人群
- 后端架构师
- 技术团队负责人
- 新加入项目的开发工程师
使用步骤
- 说明技术选型的背景、业务诉求与硬性约束。
- 列出所有候选技术方案并客观梳理利弊与取舍。
- 明确选定方案并详述推导理由与可能产生的后果。
- 选择合适格式生成决策记录,并更新索引状态流转。
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- 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.
依赖与权限
- 读取用户主动提供的内容