问题描述指南

撰写清晰的问题描述可以提升团队协作效率并加快优先级排序。定义明确的工单能帮助团队清晰理解任务，减少误解，更快地交付更好的结果。

充满痛苦的故事

问题描述曾是我们最薄弱的环节。我们浪费了大量时间争论该做什么。许多任务因为误解而出错，我们的待办事项中堆满了不完整的工单。

当我们开始进行优先级排序时，我们发现了根本问题。我们在 Ducalis 中设置了评估标准，并尝试分配评分以确定哪些工单对产品影响最大。这时我们意识到任务本身就不清晰，无法评估。优先级排序刚开始就停滞了。团队陷入困惑，缺乏一致性。每个人对任务的理解各不相同，分配的评分也完全不同。我们没有人能理解团队在做什么。

分散的评分表明团队缺乏一致性

我们实施了明确的问题描述规则，这些规则将在本文中分享。我们现在在工单描述上花费更多时间，但即使没有完整的上下文，这些描述也很清晰。

清晰的工单描述能够优化工作时间并减少错误。阅读时需要的问题越少，工作就能完成得越快越好。

通用原则

项目开发始于问题描述。

工单是工作的核心实体。它定义了要做什么、如何测试以及要达到什么结果。工单通常由报告人撰写。不要让任务负责人自己编写问题描述——他们可能会遗漏细节，他们的理解也可能不同。

1. 清晰简洁

团队中的任何人都应该能够在没有完整上下文的情况下理解问题。审查文本并预测团队成员可能提出的问题。在描述中直接回答这些问题。仔细检查你写的内容。要简洁——不是随意的长篇大论，但也不能只有两句话。

2. 具体有依据

所有引用都必须包含相关材料的超链接。尽可能添加截图。附上任务负责人可能需要的现有文件（图片、文档或类似内容）。不要让人们猜测或搜索数据。

3. 可读性强

让文本易于理解。帮助任务负责人快速找到关键点——避免密集、无结构的描述。使用段落、项目符号、编号列表、粗体和斜体文本。突出显示所有关键细节。

4. 合理拆分

将大型工单拆分为子任务，设置中间检查点。否则，你可能会得到错误的结果。如果你无法将复杂问题分解为中间任务，请考虑它是否有明确的终点，是否应该以这种形式存在。

工单结构

一个工单必须包含几个用粗体文本突出显示的必填部分。

1. 问题

本段描述任务中要解决的问题。以足够详细的方式描述，让任务负责人能够理解他们必须做什么以及为什么。你对问题描述得越清楚，任务负责人就越有可能深入理解并提供替代解决方案。

2. 结果

本段描述期望的结果。这部分越详细，任务负责人就越清楚你的期望以及要达到的结果。对于测试人员来说，它描述了要检查的内容。

3. 解决方案或评论（可选）

当报告人知道如何解决问题时，可以使用本段。其他参与者也可以在这里写下他们的评论。

你可以花费大量时间选择完全符合产品价值观和目标的评估标准。但要根据这些标准评估任务，你需要清楚了解它如何影响结果。如果你无法完全理解任务的内容，你能做到这一点吗？

撰写良好的工单可以节省评估、讨论和实施的时间，从而降低成本。在问题描述上多花一些时间，三思而后行，而不是做两遍。

欢迎使用和定制我们的指南。如果你觉得有用，请分享这篇文章。让我们彼此的工作更轻松。

额外福利

我们根据本指南开发了一个带有模板的插件。当你创建新任务时，它会自动添加问题、结果、解决方案部分。适用于 Google Chrome + Jira。 在此免费获取。