---
source: ../../../../skills/adr-assistant/guide.md
source_version: 1.0.0
translation_version: 1.0.0
last_synced: 2026-03-26
status: current
---

# 架构决策记录助手指南

> **语言**: [English](../../../../skills/adr-assistant/guide.md) | 简体中文

**版本**: 1.0.0
**最后更新**: 2026-03-26
**适用范围**: 所有软件项目
**范畴**: universal

---

## 目的

开发过程中的技术决策常常遗失。架构决策记录通过建立轻量级、版本控制的决策日志来解决这个问题。

---

## 常见问题

**Q：ADR 和 SDD 规格有什么不同？**
A：SDD 规格定义*要建什么*和*怎么建*。ADR 记录*为什么*选择了某个方案而非其他。

**Q：每个技术决策都需要 ADR 吗？**
A：不需要。使用「6 个月法则」：如果 6 个月后有人可能问「为什么？」，就写一份 ADR。

---

## 参考

- 核心规范：[adr-standards.md](../../../../core/adr-standards.md)
- 技能定义：[SKILL.md](./SKILL.md)
