用户故事设计范式（As a... I want to... So that...）

我们来详细解析一下用户故事（User Story），包括其结构、为什么重要、如何编写好的用户故事以及一个完整的示例。

1. 用户故事的基本结构：三段式模板

最经典和通用的用户故事模板就是您提到的三段式：

• As a [角色]:

  • 目的： 明确我们为谁构建这个功能。它定义了特定的用户类型或角色。

  • 示例： “As a 未登录的访客”， “As a 管理员”， “As一个经常出差的销售代表”。

• I want to [动作]:

  • 目的： 描述用户想要执行的具体操作或功能。这是故事的核心目标。

  • 示例： “I want to reset my password”， “I want to filter search results by date”， “I want to export my data as a CSV file”。

• So that [价值/收益]:

  • 目的：****这是最重要的一部分。它阐明了用户为什么要做这个动作，以及他们能从中获得什么商业价值或个人收益。这确保了团队是在为用户解决真实的问题，而不是仅仅实现一个功能。

  • 示例： “So that I can regain access to my account”， “So that I can quickly find last week’s transactions”， “So that I can analyze the data in Excel and prepare my report”。

---

2. 为什么这个格式如此重要？

这个简单的格式迫使团队（包括产品负责人、开发、测试等）在讨论功能时始终思考三个关键问题：

1. 为谁设计？ （用户中心）

2. 要做什么？ （功能需求）

3. 为什么做？ （商业价值）

这避免了团队在不明就里的情况下开发一些“听起来不错”但实际上没有价值的功能。

---

3. 一个完整的用户故事还包含哪些部分？

在实际项目中，一个用户故事卡片（无论是在Jira、Trello还是物理便利贴上）通常还会包含以下关键信息：

• 对话 (Conversation): 用户故事不是一个详细的需求文档，而是一个承诺进行对话的提醒。开发团队和产品负责人需要不断沟通以澄清细节。这些对话通常记录在卡片上或相关的会议中。

• 验收标准 (Acceptance Criteria - AC): 这是定义故事何时“完成”的规则列表。它是一组可测试的条件，通常以“Given/When/Then”（GWT）格式编写。

  • 示例（针对重置密码的故事）：

    • text

      Given 我在登录页面，当我点击“忘记密码”链接，Then 我应该被带到一个可以输入邮箱的页面。

    • text

      Given 我输入了已注册的邮箱并提交，Then 系统应发送一封包含重置链接的邮件。

    • text

      Given 我点击了邮件中的有效重置链接，Then 系统应提示我输入新密码。

    • text

      Given 我输入了新密码并确认，Then 我的密码应该被更新，并且我可以用新密码登录。

• 优先级和估算: 产品负责人会为故事排列优先级，开发团队会估算完成它所需的工作量（通常用故事点表示）。

---

4. 如何编写好的用户故事？—— INVEST 原则

一个好的用户故事应该符合 INVEST 标准：

• Independent (独立的): 尽可能与其他故事减少依赖，便于规划和排序。

• Negotiable (可协商的): 故事不是合同，其细节可以通过对话来调整。

• Valuable (有价值的): 必须对用户或客户交付价值（So that...部分确保了这一点）。

• Estimable (可估算的): 团队应该能够估算其工作量，规模不能太大或太模糊。

• Small (小的): 故事应该足够小，以便在一个迭代（Sprint）中完成多个。大型故事需要被拆解。

• Testable (可测试的): 必须有明确的验收标准来验证是否完成。

---

5. 示例：从模糊需求到完整的用户故事

模糊的需求： “我们需要一个密码重置功能。”

一个优秀的用户故事：

标题： 用户重置密码

用户故事：

• As a 忘记密码的注册用户

• I want to 通过电子邮件接收一个链接来重置我的密码

• So that 我可以在不联系客服的情况下自行恢复账户访问权限。

验收标准 (AC):

• Given 用户点击了“忘记密码”链接，When 他们输入了一个在系统中未注册的邮箱地址并提交，Then 应显示一条通用成功消息（如“如果邮箱已注册，重置链接已发送”），而不会透露邮箱是否注册。

• Given 用户点击了“忘记密码”链接，When 他们输入了一个已注册的邮箱地址并提交，Then 系统应向该邮箱发送一封包含唯一重置链接的邮件。

• Given 用户点击了邮件中的重置链接，When 链接在24小时有效期内，Then 用户应被引导至一个设置新密码的页面。

• Given 用户点击了邮件中的重置链接，When 链接已过期，Then 用户应看到错误消息，并提示他们重新申请重置链接。

• Given 用户在设置新密码页面，When 他们提交了符合复杂度要求的新密码，Then 系统应更新密码，并提示用户密码已重置成功，并允许他们用新密码登录。

---

总结

用户故事是一个强大而简单的工具，它将需求从冰冷的“系统应该”陈述，转变为以用户和价值为中心的对话。记住：“As a... I want to... So that...” 是核心，对话和验收标准是使其完整和可执行的关键。