architecture-decision-records

Installation
SKILL.md

架构决策记录

在编码会话期间捕捉架构决策。让决策不仅存在于 Slack 线程、PR 评论或某人的记忆中,此技能将生成结构化的 ADR 文档,并与代码并存。

何时激活

  • 用户明确说"让我们记录这个决定"或"为这个做 ADR"
  • 用户在重要的备选方案(框架、库、模式、数据库、API 设计)之间做出选择
  • 用户说"我们决定..."或"我们选择 X 而不是 Y 的原因是..."
  • 用户询问"我们为什么选择了 X?"(读取现有 ADR)
  • 在讨论架构权衡的规划阶段

ADR 格式

使用 Michael Nygard 提出的轻量级 ADR 格式,并针对 AI 辅助开发进行调整:

# ADR-NNNN: [决策标题]
Installs
1
First Seen
Jul 4, 2026