如何将故事点数同步到 Jira

你可以直接在 Jira 的 backlog 上运行计划扑克：将问题导入房间，团队一起进行估算，并让团队接受的故事点数自动写回每个问题，无需手动复制。这样就省去了大多数估算会议末尾那个缓慢且容易出错的步骤——由某个人把数字逐一输入到工单中。下面将介绍如何连接 Jira、导入问题、进行估算，并将点数发送回去，以及配置完成后如何做好估算。

还在挑选工具？看看为什么团队会选择用于 Jira 的计划扑克，而无需安装 Marketplace 应用。

你需要准备什么

• 一个 Jira Cloud 站点。（不支持 Jira Data Center。）
• 一个能够浏览该项目（用于导入问题）并能在其中编辑问题（用于写回估算结果）的 Jira 账号。为此专门创建的共享账号，例如 [email protected]，会比使用个人账号更合适，因为当该员工离职后，个人账号的令牌就会失效。
• 在你的组织中管理计划扑克的权限，用于连接 Jira。Owner 默认拥有该权限。

第 1 步：连接 Jira

1. 打开设置 → 集成（Settings → Integrations），选择 Jira，然后点击连接（Connect）。
2. 按照适合你的方式进行连接：

• OAuth： 系统会将你转到 Atlassian，批准访问权限后返回即可，无需复制任何内容。此选项仅在已为你的工作区配置时才会出现。
• API 令牌： 一种个人访问密钥。填写三个字段：你的 Jira 站点（例如 https://your-team.atlassian.net）、你的账号邮箱和 API 令牌。你需要在 Atlassian 自己的页面上创建该令牌：id.atlassian.com → Security → API tokens → Create API token（选择普通版本，而不是 "with scopes" 版本）。该令牌拥有与创建它的账号相同的权限。详细步骤以及失败时的排查方法，参见用 API 令牌连接 Jira。

1. 使用测试（Test）检查连接是否成功。你的密钥会被安全存储，且不会再次显示。

第 2 步：选择估算结果写入的位置

连接完成后，紧接着的配置（Configure）步骤会询问是否要将团队接受的估算结果写回 Jira，以及写入哪个字段。

• 打开将接受的估算结果写回（Send the accepted estimate back）。
• 选择用于保存估算结果的 Jira 字段。列表会显示你站点中的数字字段，如果存在 Story point estimate 字段，它会被默认选中。
• 你可以稍后在估算设置（Estimate settings）中更改此项。

不确定该选择 Jira 的哪个估算字段？下一节会解释清楚。

Story Points 还是 Story point estimate？该选哪个字段

Jira 有两个看起来很相似的估算字段，选错字段是估算结果没有出现在看板上的最常见原因。你需要哪一个，取决于项目的类型：

有两点需要注意：

• 自定义看板的行为类似于公司管理项目。 在自定义看板上，即使项目是团队管理的，也只有 Story Points 可以作为估算统计字段使用。Atlassian 建议使用随团队管理项目一同创建的看板。
• 在项目类型之间迁移可能会丢失估算结果。 将团队管理项目迁移为公司管理项目时，请保持勾选 "Retain" 选项，以便保留你的故事点数。

无论你选择哪个字段，都要确保它出现在该项目中问题的屏幕（screen）上，否则 Jira 会拒绝更新。

第 3 步：将问题导入房间

1. 创建一个房间（或打开一个已有的房间），在任务面板中选择导入（Import）。
2. 选择 Jira，再选择你的项目。
3. 使用筛选条件缩小列表范围：sprint、epic、问题类型和状态，你也可以按文本搜索。
4. 选择你需要的问题，或全选，然后导入。

已经存在于房间中的问题会被标记出来，因此不会重复添加。每个任务都会保留其 Jira 键（例如 PROJ-142）、指向该问题的链接，以及其描述的前几行。

第 4 步：估算

像平时一样进行会议：打开一个任务，所有人投票，揭晓，讨论分歧，然后接受估算结果。如果你是第一次接触这个流程，我们的计划扑克分步指南会带你了解每一步。当你接受估算结果后，这个数字会在片刻之间写入 Jira 问题，而不会让房间等待。房间历史记录随后会显示估算已发送（Estimate sent），或说明未能发送的原因。

哪些会被发送，哪些不会

• 数字会被发送。 半点数（half points）也可以，因为 Jira 的字段是数字类型。
• ? 和 ☕ 卡牌以及 T 恤尺码不会被发送，因为它们不是数字，会在历史记录中标记为"未发送"。

如果你的团队使用 T 恤尺码估算法，可以继续在房间中使用它们，然后手动将故事点数填入 Jira，或者为需要同步到 Jira 的会议约定使用数字卡组。

无论是否使用 Jira，都要做好估算

• 在 sprint 开始前估算，而不是进行中。 查看接下来要处理的 backlog 条目，这样 sprint 开始时，大家已经讨论过这些数字。
• 使用同一套量表，并坚持下去。 从一次会议到下一次会议在斐波那契数列和尺码之间来回切换，会让你的历史数据无法比较。
• 点数衡量的是工作量和不确定性，而不是时间。 避免将它们换算成小时数。过去几个 sprint 的速率（velocity）会告诉你下一个 sprint 能容纳多少点数。关于点数究竟是什么、不是什么，参见故事点数究竟是什么。
• 当范围发生变化时重新估算。 讨论后变得更大的任务值得重新投票。

计划扑克是多种敏捷估算技巧中的一种，它与将团队一致认可的单一数字写回 Jira 这样的跟踪工具最为契合。

如果估算结果未发送

• "该字段不在屏幕上"或权限错误：检查该字段是否出现在该项目中问题的屏幕上，以及连接的账号是否有权限编辑它。
• 连接失效： 令牌可能已被撤销或过期。在集成页面使用测试（Test），如有需要再重新连接（Reconnect）。
• 结果不是数字： 例如 ? 卡牌、☕ 或 T 恤尺码，这属于正常情况。

连接只需要几分钟，之后你每次会议产生的数字都会自动落在正确的位置，无需任何人手动复制。

常见问题

可以在 Jira 内部运行计划扑克吗？

你是在一个与 Jira 相连的计划扑克房间中运行它：导入问题，与团队一起估算，团队接受的故事点数会自动写回每个 Jira 问题，因此无需任何手动复制。

故事点数会写入 Jira 的哪个字段？

写入你在连接时选择的数字字段，通常是 Story point estimate。请注意，Jira 有两个相似的字段，Story points 和 Story point estimate，因此要选择你的看板所显示的那一个，并确保它出现在问题的屏幕上。

它支持 Jira Data Center 或 Server 吗？

不支持。该集成仅支持 Jira Cloud。

我需要 API 令牌，还是可以使用 OAuth？

两者皆可。如果你的工作区已配置好，OAuth 只需一键批准即可完成。API 令牌是你在 Atlassian 创建后粘贴到三个字段中的个人密钥。连接完成后，两者的效果相同。

像 "?" 或 T 恤尺码这样的非数字投票会怎样？

它们不会被发送到 Jira，因为该字段是数字类型，它们会保留在房间历史记录中并标记为"未发送"。如果你使用 T 恤尺码进行估算，可以手动把点数填入 Jira，或者为需要同步到 Jira 的会议使用数字卡组。

整个团队可以在没有 Jira 账号的情况下进行估算吗？

可以。只有连接步骤需要用到 Jira 账号。团队成员可以通过链接加入房间，无需任何账号，只有被接受的估算结果才会写回 Jira。