ADR-lite 格式
每条决策都遵循一个紧凑的结构:
| 部分 | 说明 |
|---|---|
| 上下文 | 为什么需要这个决策 |
| 决策 | 决定了什么 |
| 为什么 | 最有力的一个理由 |
| 而非 | 考虑过的备选方案(最多 3 个) |
| 影响 | 后果和受影响的范围 |
对于复杂决策,扩展格式会加上一个 权衡 部分。
智能功能
自动推断备选方案
如果你只说了决策,AI 会推断出 1-2 个常见备选方案:
/note-decide user 服务用 PostgreSQL
AI 补充:而非 MongoDB、MySQL — 因为数据库选型常见的备选就是这些。
决策链
系统会搜索已有的决策笔记。如果你的新决策取代了旧决策,它会创建一个 「取代」 链接:
取代:"user 服务用 MongoDB"(2 月 10 日)
这样就建立起一条能往回追溯的决策历史。
重复检测
在创建新笔记之前,/note-decide 会搜索相关的历史决策,如果已有类似决策就提醒你。
标题规范
好的标题是可执行且具体的:
- 「用 JWT 做 auth」(而不是「认证」)
- 「部署到 Fly.io」(而不是「部署」)
- 「从 REST 换成 GraphQL」(而不是「API」)
什么时候用 /note-decide
当你想记录 为什么 选了某个方案,而不只是 选了什么 的时候,用它。决策记录在这些时候会变得非常宝贵:
- 新成员问「我们当初为什么这么做?」
- 几个月后你需要重新审视某个决策
- 你想追踪架构是怎么一步步演变的