用途:在开发流程的各个 Gate 中,当人工给出 KO 或质疑提案时,记录决策背后积累的智慧(patine),即为何这样决定以及否决了哪些替代方案。
主要能力:
- 决策捕捉——检测决策类型(Technical/UX/Process),询问简短理由,附带谁、何时、领域、Gate、关联任务等元数据。
- 三层存储——默认用 Notion MCP 写入 Decision Patine 数据库;高影响或跨领域技术决策生成 ADR 文件到 /docs/decisions/NNN-[slug].md;微观代码级决策写内联注释。
- 自动学习捕捉——Kaizen(重复挖掘线框图、同一错误修复 2 次以上等模式)与 Hansei(用户纠正 AI 假设、超出 takt 警告、Jidoka 升级等反思)自动记录,不提示用户;HIGH 影响才立即生成 ADR。
- 查询已有决策——按 Domain 查询数据库,避免重复提议被否决的方案。
触发条件:Gate 1/2/4 KO、Gate 3 KO/BLOCK、Gate 5 变更请求、调试发现值得记忆的模式、重复细化或重复修复、用户纠正假设、超出 takt、Jidoka 二级/三级。
使用方式:由 ask.mdc(Gate 1/2/3)、plan.mdc(Gate 4)、push-pr.mdc(Gate 5)、debug 自动调用,也可手动执行“use decision-capture skill”。存储层 1 用 Notion MCP API-create-page 写入;层 2 取 ADR 编号命令为 ls docs/decisions/ | wc -l;层 3 注释格式如 // ADR: [Brief decision]. [Why not alternative]. —@[initials] [YYYY-MM]。
适用场景:需要沉淀决策理由、避免重复讨论、追踪被否决方案与约束的工程团队。
限制与注意:不要为每个微观决策都要求理由;非架构选择不建 ADR;已写在代码注释中的决策不重复捕捉;用户拒绝说明时不再追问;Kaizen/Hansei 不提示理由,按观察自动捕捉并汇总到 session-journal 同步。资料未提供收费、平台支持范围及效果数据。