用 ADR 记下架构决定
收录 2026-10
半年前为什么选了这个方案没人记得，把背景、选项和取舍写成短文档
团队要为一个决定留下记录：[决定内容，比如数据库或消息队列的选型]。请按架构决策记录的格式写一份，包含当时的约束、考虑过的方案及各自代价、最终选择和理由，以及什么情况下应该重新评估。输出：一份可直接入库的短文档（不超过一页）、需要补充的数据、后续变更时怎么更新它。
本站原创
中文原文
使用示例
示例输入
要为一次选型留记录：消息队列选了自建还是托管，按架构决策记录格式写一份。
输出应包含
- 含当时约束、候选方案与代价
- 最终选择与理由都要写具体
- 标出什么情况下应重新评估
复制前替换这些占位符 1
把方括号里的内容换成你的具体信息，替换后再粘贴给 AI。
[决定内容，比如数据库或消息队列的选型]
使用建议
重点写被否掉的方案和原因，那是半年后最想知道的部分。
可以这样改
- 要求它先复述需求与约束，确认无误再写代码。
- 让它给出最小改动 + 回滚方式，而不是整文件重写。
交付物（这次应拿到什么）
- 可运行的最小改动（含直接可用的代码块）
- 影响面清单：改了哪些文件、哪些调用点要跟着改
常见错法
- 一次让它改十个文件，最后分不清哪处改动导致了新问题。
- 只贴报错不贴代码和版本，拿到无法落地的修法。
输出验收（怎么判断能用）
- 改动可运行、可回滚，且没顺手改无关代码。
- 边界条件（空值、超长、并发）有说明或测试。
适用场景与注意
- 适合：让它先复述需求和约束，再给最小可运行改动。
- 注意：贴报错时同时给版本号与最小复现，否则它容易给出看似合理但不适配的写法。