← 所有命令 📥 捕获

/note-decide

决策记录

ADR-lite 格式:上下文 > 决策 > 为什么 > 而非(备选方案)> 影响(后果)。搜索相关的历史决策,构建「取代」链。自动推断缺失的上下文和备选方案。

快速示例

Claude Code
/note-decide 用 PostgreSQL 而不是 MongoDB 做 user 服务,因为需要 ACID 事务

带明确备选方案和理由的决策。后果自动生成。

核心功能

📐

ADR-lite 格式

紧凑的架构决策记录:上下文、决策、为什么(最有力的一个理由)、而非(最多 3 个备选方案)、影响(后果)。

🔗

决策链

搜索已有决策,当新决策取代旧决策时创建「取代」链接。

🤔

自动推断备选方案

如果你只说了决策,AI 会推断出你很可能考虑过的 1-2 个常见备选方案。

⚖️

权衡部分

对于复杂决策,扩展格式会加上专门的「权衡」部分。

实际示例

技术选型

/note-decide 用 PostgreSQL 而不是 MongoDB 做 user 服务,因为需要 ACID 事务

带明确备选方案和理由的决策。后果自动生成。

架构

/note-decide payment 系统用微服务

AI 推断单体架构作为备选方案,并补充 payment 需求的上下文。

替换库

/note-decide 从 Moment.js 换成 date-fns,减小 bundle 体积

如果找到,取代之前的 Moment.js 决策。列出迁移的后果。

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

当你想记录 为什么 选了某个方案,而不只是 选了什么 的时候,用它。决策记录在这些时候会变得非常宝贵:

  • 新成员问「我们当初为什么这么做?」
  • 几个月后你需要重新审视某个决策
  • 你想追踪架构是怎么一步步演变的

现在就试试

下载 SlashNote,安装 Claude Code 插件

从 App Store 下载