在 Jira 中保留决策日志：记住选择这个方案的原因

发布六周后，有人问为什么选择邮件而不是每日摘要。Jira 任务说明了做了什么，评论只写着“规划时已同意”。记得讨论的人很忙，没人确定哪个限制最重要。

决策日志补上这个缺口，把情况、选项、选择和后果放在团队能找到的位置。Power Pack 的 Decision Log 将记录放在 Jira 事项旁，靠近它解释的工作。

本指南展示虚构门户团队如何写出有用记录、连接实施工作，并在客户需求变化时重新审视。

确定哪些决定值得记录

日志不必记录每场对话。从未来同事可能合理质疑的选择开始，例如实施方式、依赖、发布边界，或影响超出小任务的有意妥协。

通知发送值得记录。即时邮件会影响开发、测试、支持说明和客户期望。团队考虑过其他方案，也预计在消息量增长时重新评估。

相比之下，修正按钮错别字通常不需要独立决策记录。判断标准很实际：理解原因能否帮助未来维护、修改或解释结果？

架构决策记录 ADR 提供了有用先例。Michael Nygard 的原文介绍简短记录，保存背景、决定、状态和后果，并保留被替代决定及其后续链接。来源见下方。这里将这种轻量思路用于 Jira 实施决定。

为决定选择固定位置

选择最能代表受影响工作的 Jira 事项。本例使用协调门户通知的事项，它已指向开发和测试工作。

告诉团队记录在哪里。Decision Log 属于单个事项，应建立简单的查找习惯。协调事项可加注说明通知决定保存在此处。如团队另有项目索引，按正常流程加入该事项。

不要将副本分散到多个事项并期待自动一致。其他任务可引用主记录。导出方便讨论，但大家应知道在哪里查看当前立场。

先写背景，再写结论

背景解释问题为何出现，并区分事实、约束和假设，让后来的读者辨认哪些条件发生了变化。

团队写道：“客户需要知道支持请求何时发生重大变化。现有服务已发送邮件。门户首版没有收件箱。我们预计大多数请求只有少量客户可见的状态变化，但尚未测量上线后的通知量。”

这比“邮件最简单”更有用，说明起点并揭示假设，也没有宣称邮件永远是正确渠道。

适当引用调查。如果技术探索影响了决定，指出包含发现的 Jira 事项；如果客户反馈重要，总结相关模式，不要不必要地复制私人信息。

背景应让新同事无需重建整场会议也能理解。保留影响选择的细节，无关讨论留在原处。

比较真实替代方案

有用的记录展示团队本来可以做什么。纳入认真考虑过的方案，诚实写出每个方案的优点和缺点。

这些评估仅用于虚构系统。其他团队可能已有收件箱或摘要服务，比较会完全不同。好的记录应体现对背景的依赖。

不要故意弱化被放弃的方案，让选择显得不可避免。摘要确有减少单独消息的优势。当前发布不选它，是因为现有假设下时机和实施范围更重要。

也要区分方案和独立决定。是否把客户完整消息放进邮件，可能需要单独审查。将所有通知问题塞进一条记录，会让实际约定难以理解。

写明选择及其后果

用完整句子表达：“门户首版在支持请求发生有意义、客户可见的状态变化时发送邮件。内部编辑不会触发消息。”

再解释原因：“这使用现有发送渠道，及时报告进展，同时控制发布范围。”这只解释本例，不代表邮件普遍更便宜或可靠。

后果同样重要。团队需定义有意义的变化，测试重复更新和去重，支持需解释触发事件。活跃请求的客户仍可能觉得邮件太多。

有用的后果自然引出后续工作。这里记录影响，任务则在 Jira 管理。决策记录应解释工作必要性，而不是成为状态和负责人相互冲突的第二套待办。

在 Power Pack 中创建记录

打开相关事项的 Decision Log (ADR Lite)，使用直接描述选择的标题，如“为门户日常状态更新使用即时邮件”。

选择适合团队的类别，讨论期间使用 Proposed。加入决策者，决定后记录日期。姓名字段表示责任，并不会代替审批过程。

填写背景、各方案利弊，选定方案并说明后果。确保未参加讨论的人也能理解。

按需添加受影响 Jira 键。编辑器接受逗号分隔的事项引用，可指明开发和测试任务。这只是记录引用；若需要正式事项关系，应另用 Jira 常规链接功能。

与参与者核对记录，确保选项与解释一致。请同事依赖最新内容前确认保存，尤其是在出现本地或离线状态时。

用状态明确当前立场

Power Pack 提供 Proposed、Accepted、Rejected、Superseded。约定其用法，区分仍待决定的想法和已经指导实施的选择。

Maya 作出通知决定后，团队记录日期并标为 Accepted。这表示决策状态，不证明开发完成、测试通过或发布获得授权。

Rejected 同样如此。简短说明可避免后来者不知道已有调查而重做。即使没有后续实施任务，也应保留有用理由。

假设变化时重新审视

假设上线后门户开始服务大量活跃请求的客户。支持发现有人每天收到多封普通邮件。这是与原低消息量假设直接相关的新背景。

提出变更前先打开旧记录，区分当时合理的取舍和今天的问题。旧决定解释为何选择即时邮件，并不禁止条件变化后的更优方案。

为每日摘要新建 Proposed 记录。Power Pack 可将旧条目复制为 Proposed，作为起点。仔细检查全部复制字段：旧假设、日期和后果可能已失效。

新选择获采纳后，将旧记录标为 Superseded，并在替代字段引用新决定。保留原始理由，不要改写得像团队一直计划摘要。

这是一种团队文档实践。记录仍可编辑，因此约定重大变化用替代记录，普通编辑用于纠错和澄清。不要把日志当作不可变审计轨迹。

让记录服务日常工作

新人加入、有人提议重构或询问特殊要求时，查阅日志。搜索和过滤帮助在事项日志中定位条目。Power Pack 也可导出 ADR 风格 Markdown，用于审查或其他文档流程。

分享导出前，确认它反映当前内容并指出维护事项。下载文件只是快照，后续修改不会更新已经发送的副本。

从近期且可能重审的决定开始。写出背景、真实替代方案、选择和后果，放在 Power Pack 的 Jira 工作旁，请未参加讨论的同事阅读。如果他能解释当时为何合理、什么情况值得改变，日志就在发挥作用。

• Michael Nygard：记录架构决策