architecture-decision-records
Installation
SKILL.md
架构决策记录
在编码会话期间捕捉架构决策。让决策不仅存在于 Slack 线程、PR 评论或某人的记忆中,此技能将生成结构化的 ADR 文档,并与代码并存。
何时激活
- 用户明确说"让我们记录这个决定"或"为这个做 ADR"
- 用户在重要的备选方案(框架、库、模式、数据库、API 设计)之间做出选择
- 用户说"我们决定..."或"我们选择 X 而不是 Y 的原因是..."
- 用户询问"我们为什么选择了 X?"(读取现有 ADR)
- 在讨论架构权衡的规划阶段
ADR 格式
使用 Michael Nygard 提出的轻量级 ADR 格式,并针对 AI 辅助开发进行调整:
# ADR-NNNN: [决策标题]