《猎豹行动 硝烟中的敏捷转型之旅》的作者：刘华老师在10月19日的 Atlassian 社区日 | 广州站的活动上跟我们分享了《Jira & Confluence 在敏捷转型中的重要性》这个主题，并且他也把此次的分享写成文章，希望和更多的小伙伴们一起共享和学习。

Atlassian 产品的设计理念

工欲善其事，必先利其器！今天，我们就来聊聊全球敏捷开发团队普遍使用的两大利器：来自澳大利亚的软件企业 Atlassian 的 Jira 和 Confluence。其设计理念彻底地贯彻了敏捷开发所倡导的去中心化、协作、集体讨论、信息共享、灵活、透明、可视化等原则。

为了让大家更好的理解，我们假设一个场景：

假设小赵是负责需求分析的BA，她需要和项目干系人一起进行需求分析和确认。

按照过去的做法，小赵会用Word来组织一份需求文档，然后通过邮件把文档发给所有干系人收集意见。干系人也会通过邮件回复意见。然后她又要把根据意见修改的版本发给所有干系人。由此会产生大量的邮件。

由于只有小赵掌握关于需求的全部和最新的信息，每次当某个干系人想要翻阅需求文档时，由于不确定TA手头上的版本是否是最新的，TA一定会找小赵再要一次。小赵需要不厌其烦地招呼这些主。

而且万一小赵病了或者需要突然请假，需求分析和确认这件事情就会停滞下来，其他人也会抓狂。

我们来看一下这里的几个问题：

• 中心化管理：最全面和最新的信息只掌握在小赵一个人手上，她也成为需求分析这个事情的中心节点，一旦她这个节点出了问题，就会成为整个环节的障碍和瓶颈，其他人的工作也会受到影响；

• 信息没有共享：信息全部通过邮件传递，不好翻阅和查找，除了小赵外，其他人都是两眼一抹黑，无法确定自己手头上的信息是否是最完整和最新的。

• 讨论的收集：意见都是通过邮件收集，小赵需要手动收集和整理，费时费力，其他人如果不看每一封邮件，也无法掌握所有人的意见。

但如果小赵是用 Confluence 工作的话，会怎样呢？

• 去中心化和共享：虽然小赵是需求文档的原作者，但是由于Confluence是基于Wiki精神设计的，小赵发表初版后，任何干系人都可以直接对内容进行修改和贡献。而Confluence会自动记录每一版的修改，随时可以回退到任何一个版本。由于任何人都可以在Confluence上看到最新的内容，他们随时可以看到最全面和及时的信息。小赵被彻底地解放了出来，即使她临时无法上班，其他人都可以继续讨论、完善需求。

• 集体讨论：所有干系人都可以通过Confluence的Comment功能对文档内容进行讨论、对话。所有人都可以很直接地查阅到全部讨论内容。

而 Jira 也有类似的设计。

通过去中心化、共享和集体讨论，可以减少瓶颈，赋能每个人都有足够信息进行相应的工作，也使得过程变得透明，增加用户/业务对交付过程的理解与信任，促进融合，共同实现项目目标。

善用敏捷思维运用工具

既然 Jira 和 Confluence 是基于敏捷原则和价值观设计的，只有以敏捷思维来做事，才能善用这些工具。千万不要把旧思维运用在这些新工具上

我们公司过去是用 Word/Excel+SharePoint，很多同事在使用 Confluence时，只是把它当成了 SharePoint 的替代品，把一大堆 Word/Excel 文档以附件形式放在 Confluence 的页面上。

虽然 Confluence 可以管理附件文档，但这完全不是它的特长。

我们从RTC过渡到 Jira 时，也存在类似的情况。

那怎样使用 Jira 和 Confluence 才是正确的呢？我在这里总结了一些使用原则：

- Jira 的使用原则：

在 Jira 里面，所有的事项都统一叫做 Issue，而 Issue 可以定义 Issue 的类型，以映射我们真实工作工程的管理单元，比如它可以是 Story 代表用户故事，它可以是 Test 代表测试用例，它可以是 Incident 代表生产环境故障等。不同的 Issue 类型也可以对应不同的工作流，以反映真实的工作过程。

Jira 是原生支持敏捷开发的。在敏捷开发中，有下面几个层级：

• Epic - 史诗故事：包含某个特性或子项目的相关用户故事，便于用户故事归组。
• Story - 用户故事：其中一种Issue的类型。这里强烈建议用户故事是具有一定业务价值、可单独交付、最小的需求。
• Sub-task - 用户故事下需要分配给不同人处理的子任务，不可单独交付，比如前端开发与后端开发，上、下游组件开发等。

由于一个 Epic 包含若干个用户故事（Story），在新建或编辑Story时，可以通过 Epic Link 的属性把该 Story 指向一个已有的 Epic，从而建立两者的隶属关系。

如果一个 Story 需要拆分成任干个任务交给不同人或团队完成，可以在 Story 中新建 Sub-task 并分配给相应的人或团队。Defect 也是一种 Sub-task。独立测试团队对某个 Story 进行测试时发现 Defect，应该在该 Story 下创建 Defect (Sub-task)，把两者关联起来。

在一个 Story 级别的 Issue 中，可以按“More”按钮，然后按“Create Sub-Task”按钮来新建 Sub-task。Sub-task 和 Story 级别的 Issue 是可以相互转换的。所以即使一开始关系建错了，也没有关系。另外，Issue 类型可以通过 Move 功能随时进行转换。这也体现了 Jira 强大的灵活性和对延后决策的完美支持。

小结三者关系是 Epic 包含若干个 Story，Story 包含若干个 Sub-task。

我们可以在JIRA中做发布计划。在管理界面中，管理员可以根据发布计划定义 Version，包含发布日期与发布提要。在每一个 Issue 中，我们可以在 Fix Version/s 属性中指定它将在哪个 Version 发布。可以通过Releases页面轻松发布Release Note。

通过代码版本控制软件如 SVN、Git等的插件，只要在提交代码时，提交备注（Comment）中包含JIRA Issue Key，相应的代码提交信息也会显示在Issue中，从而建立 Issue 与相应的代码的可视关系。实现敏捷与 DevOps 里倡导的可追踪性。

- Confluence 的使用原则

Confluence 是基于 Wiki 精神设计的，任何人都可以对内容进行修改和贡献。所以在建立 Confluence 文档时，不必拘泥于一次写对，持续地更新、修正恰恰符合“先完成、再完美”的敏捷原则。

我强烈建议大家在编写 Confluence 文档时，善用 Header 来对文档进行结构化处理。Confluence 支持5级 Header，便于建立不同的章节和层次结构，配合目录（Table of Content）功能，Confluence 会自动根据文档的 Header 生成相应的目录和书签，便于定位某个章节。

由于 Confluence 具有强大的灵活性，文档所处的位置可以通过 Move 功能随意移动，不建议花太多时间设计文档间的关系。

在去中心化的原则下，每个人都可以贡献内容，所以 Confluence 的文档体系建立一定是自底向上的，这不可避免地会带来文档的碎片化和内容的重复建设。但不必对此过于担心，其实互联网也是这样的，我们不还是活得好好的，能通过互联网获取到我们所需要的信息吗？强大的搜索功能可以帮助我们找到需要的内容。

如果可以善用标签，也就是在编写某类文档有加上相应的关键字做标签，然后通过标签把相应的文档聚合在某个地方，方便查阅。

- Jira 与 Confluence 的实时互动

全球 76% 的客户表示，将这两种产品相结合可以帮助他们更快交付项目！

只要把某个 Jira Issue 的链接地址贴到 Confluence 页面里，该 Issue 的标题和实时状态会自动显示在 Confluence 页面中。

如果某个 Issue 被 Confluence 引用，在 Jira 中也能看到相应的链接。

我们建议把项目中相对静态的信息，如项目的整体框架或者从项目拆分到特性等内容放在 Confluence 中。

然后把对应的比较动态的工件通过 Jira 来追踪，然后把 Jira Issue 的链接放在 Confluence 页面中，建立两者的对应关系，整个项目的脉络，一目了然。

而且在 Jira 中的状态更新在 Confluence 页面中也能实时反映。或者通过 Confluence 的表格功能建立用户故事地图，然后把生成的用户故事通过 Jira 记录，并把链接放在 Confluence 里的地图细节中。

简单来说，就是静态的内容放 Confluence，动态的内容放 Jira，并把两者链接起来。

我们不时需要给客户提交项目报告。过去，我们需要手动整理这些信息，费时费力。通过这两大利器，我们可以轻松构建实时的报告和仪表盘，只消一次搭建的功夫。

我们可以在 Confluence 中把整个 Jira 列表引入，列表的内容可以通过 JQL 灵活设定。也可以把列表转换为图表，建立可视化很强的仪表盘。

敏捷转型是思维转型

最后我想强调的是，敏捷转型是思维转型。我们需要：

• 深入理解敏捷价值观——在前文提到“去中心化、集体讨论、信息共享、灵活、透明、可视化”等原则才是敏捷转型的思想武器；
• 运用具体实践和工具落实敏捷价值观——JIRA和Confluence可以帮助我们践行敏捷原则和价值观；
• 持续回顾与改善——没有放之四海而皆准的方法，通过针对具体交付问题的持续回顾、总结，才能帮我们找到最合适自己的方法和工具。

关于作者

刘 华 （Kenneth）

• 就职于世界500强银行，负责基金服务业务软件开发与交付，DevOps团队负责人
• 著有《猎豹行动：硝烟中的敏捷转型之旅》一书
• 敏捷、精益、DevOps专家
• 精通极限编程、Scrum、看板方法、测试驱动开发、持续集成、行为驱动开发、DevOps工具栈
• 曾在GDevOps、DevOpsDays Meetup、中国软件技术大会、ArchSummit等论坛发表主题演讲。