ROADYOM
ZH
立即开始
免费模板 · 决策日志

决策长于会议。请记录其背后的原因。

人们做出决策后便会继续前行,决策留了下来,其原因却随人而去。决策日志将“为什么”与“是什么”并列,为不在场的同事提供参考。

阿拉伯语版:XLSX · CSV

被拒绝的选项及其原因 自动标记的复审日期 英语和阿拉伯语

桌上堆满了文件,窗边放着一张打印好的页面
其重要性

事后聪明会重写记忆,但记录不会。

若缺失原因,团队要么只能维持一个已无法理解的决策,要么只能撤销决策,从而让已解决的问题卷土重来。

1975

心理学家 Baruch Fischhoff 研究表明,一旦人们知晓结果,就会认为该结果比实际情况更具可预测性。他称之为“渐进决定论”。

Journal of Experimental Psychology
已遗忘

Microsoft 的架构指南指出:未记录的决策“很可能会被遗忘,导致重复争论”。请保持日志仅限追加,并为每项决策标注置信度。

Microsoft Learn
2011

Michael Nygard 提出了决策记录的概念:标题、背景、决策、状态、后果。“所有后果都应在此列出,而不仅仅是‘正面’后果。”

Michael Nygard
采用

Thoughtworks 将轻量级决策记录置于其技术雷达 (Technology Radar) 的 Adopt 环中,这是其最强力的推荐。

Thoughtworks
模板

每项决策占一行。按时间倒序排列。

无论是诊所、学校、服务中心还是银行网点:记录任何重大决策时,字段均保持一致。

ID标题已决策负责人决策预期结果置信度复审状态
D-005预约开户服务2026-10-20网点经理我们将提供开户预约时段,同时保留现场办理。缩短快速业务的等待时间。低2027-02-28提议中
D-004协调员角色增加了出院电话2026-06-12运营经理我们将从 7 月起,将出院电话职责分配给协调员。到 12 月,护士在电话上的时间将减少。中2026-12-15已接受 · 替代 D-001
D-003服务柜台于周一 7:30 开放2026-05-05服务中心经理我们将从 6 月起,在每周一的 7:30 开放柜台。到 9 月底,周一的平均等待时间将有所下降。高2026-10-15已接受 · 待巡查
D-002两场较短的评估将取代期末考试2026-04-22教务副校长从 9 月起,7 至 9 年级每学期将进行两次较短的评估。教师将在两周内根据期中结果采取行动。中2027-01-31已接受
D-001跟进电话转交给协调员2026-02-10运营经理从 3 月 1 日起,我们将把后续跟进电话工作移交给专门的协调员。完成率将在三个月内提升。中2026-06-01已被 D-004 取代

当巡查日期已过且未填写结果时,XLSX 会标记为“待巡查”。 这些文件提供了背景、考虑过的选项、证据、尚不确定的事项以及巡查结果,此外还包含一份单页记录表。

考虑过的选项

包括被拒绝的选项及其原因。这是最常缺失、也最常被需要的字段。

决策

使用主动语态的一句话,以“我们将……”开头。

证据

直接链接调查、解读报告或日志本身,以便后续读者判断其是否仍然有效。

预期结果

如果方案奏效,应达到什么效果,以及何时达到。在结果明确前即需写下。

置信度

高、中或低,并用一行文字说明尚不确定的事项。

状态

建议、已接受、已取代或已废止。已取代会链接至其替代方案。

使用指南

在做出决定的那一周进行记录。

  1. 选择记录重点

    影响工作方式、质量或安全,或难以逆转的决策。并非每一笔采购都需要记录。

  2. 在该周内记录

    同周编写的记录是准确的;数月后编写的则是事后重构。

  3. 列出被拒绝的选项

    以及每个选项落选的原因。这正是下一支团队想要重新审视的内容。

  4. 陈述你的预期

    包括结果、日期和你的信心程度。事后聪明往往会试图抹除这三点。

  5. 在指定日期进行巡查

    在预期结果旁写下实际发生的情况。是证据不足、条件变化还是运气不佳:请说明原因。

  6. 使用取代,绝不覆盖

    用一条新记录取代旧记录,并链接回旧记录。方向转变的历史往往是最有价值的部分。

常见错误

为什么决策日志会失效。

记录一切

日志变成了会议纪要。没人读,于是也没人写。

仅记录胜出的选项

如果不记录被拒绝的选项,同样的争论一年后还会重演。

数月后才补写

到那时结果已定,记录也会被结果所左右。

编辑已接受的决策

线索断了。请编写新记录,并将旧记录标记为已取代。

无复审日期

随后,没人能知道当初的决策是否达到了预期效果。

保存在独立文件夹中

放在受影响的计划和程序旁边的日志会被阅读。放在文件夹里的则不会。

当电子表格不再够用时

当日志需要具备自主记忆能力时。

电子表格只是一行行数据。它无法展示每一行数据的可信程度,也无法展示后续发生了什么。

  • 人们会问“我们当时为什么这么决定?”,而答案却躺在某个人的收件箱里。
  • 决策、程序和经验教训分散在互不关联的文件中。
  • 你无法分辨一项已批准的决策与某人的猜测。
  • 你的团队所使用的助手无法理解你的决策逻辑。

ROADYOM PRISM

每一项决策,都承载着其分量。

Prism 将机构的决策与知识存储为具有明确信任级别的条目:已批准、有证据支持、已观察到或已推断。每项决策都与其证据、执行步骤以及随后的结果和“暂停与学习”教训相关联。当一项决策被取代时,之前的决策依然可见。决策由人做出,Prism 记录其理由。

问题,已解答。

这和会议纪要一样吗?

不一样。纪要记录的是谈话内容。决策记录则保留了决定了什么、为什么决定、还考虑了哪些其他选项以及预期效果。篇幅在一页以内。

谁应该编写记录?

决策的所有者,或由其在当周指定的其他人。被咨询的人员应当能够阅读并纠正事实。

那我们几年前做的决策呢?

从新决策开始。然后重新构建人们询问最多的少数过往决策,并将其标记为“已重建”。

这难道不是一种软件工程实践吗?

它确实起源于此,即架构决策记录。但其内容并非软件工程所特有。准入规则、评估政策和营业时间同样具有背景、选项和后果。

“置信度”增加了什么价值?

它记录了你在得知结果之前的判断。在复审时,一个失败的“高置信度”决策与一个“谨慎型”决策所提供的教训是截然不同的。

决策应该被删除吗?

不。将其退役或取代。记录被撤销的决策,是下一支团队避免重蹈覆辙的关键。

来源 (5)
  1. Hindsight ≠ foresight: The effect of outcome knowledge on judgment under uncertainty. Journal of Experimental Psychology: Human Perception and Performance 1(3) (B. Fischhoff), 1975.
  2. Documenting Architecture Decisions. Michael Nygard, Relevance (now Cognitect) blog, 2011.
  3. Architecture decision record (Azure Well-Architected Framework). Microsoft Learn, 2024.
  4. Decision Log (Code-With Engineering Playbook). Microsoft, 2024.
  5. Lightweight Architecture Decision Records (Technology Radar). Thoughtworks, 2018.

有目的地决策。两次。

一次在做出选择时。另一次在复审时。免费提供,支持英语和阿拉伯语。