第4章:需求描述与用户故事 — 结构化模板与验收表达
需求描述是PRD中最容易被误解和敷衍的字段。多数产品经理习惯用“用户需要一个登录功能”这种模糊表达,导致开发反复确认、测试用例缺失、验收无据可依。本章从用户故事标准格式出发,提供一套可直接填入字段的结构化描述模板,让需求从“一句话”变成“可执行、可验证”的完整单元。
核心认知: 用户故事不是“写给用户看的故事”,而是产品、开发、测试三方围绕一个价值的对齐协议。As a / I want / So that 三个要素必须同时存在,缺少任何一项都会导致需求歧义。
4.1 用户故事标准格式(As a… I want… So that…)
业界最通用的需求载体是用户故事,其结构看似简单,但每个分句都有严格的职责边界:
| 分句 | 职责 | 常见错误 |
|---|---|---|
| As a… | 定义谁在使用系统,明确用户角色或系统角色 | 写“用户”过于宽泛,应具体到“已认证的商家管理员” |
| I want… | 描述什么动作或能力是用户期望的 | 混合多个需求写成一句话,应一个故事只表达一个价值 |
| So that… | 说明为什么要做,即背后的业务价值或用户目标 | 写成技术实现方式,而非业务收益 |
正确示例:
As a 已认证的商家管理员,
I want 在订单列表页中按发货状态批量筛选订单,
So that 我可以快速定位未发货订单并进行集中处理,提升发货效率。
As a 已认证的商家管理员,
I want 在订单列表页中按发货状态批量筛选订单,
So that 我可以快速定位未发货订单并进行集中处理,提升发货效率。
4.2 结构化描述模板 — 从一句话到完整字段
仅靠一句话的用户故事不足以驱动开发与验收。在PRD字段中,需要将用户故事扩展为结构化描述模板,覆盖前置条件、业务规则、验收要点三个维度。
| 字段块 | 字段名 | 填写说明 |
|---|---|---|
| 角色与场景 | 用户角色 | 映射到用户故事中的 As a 部分,需引用权限模型中的角色名称 |
| 触发场景 | 用户在什么页面/流程节点产生此需求,建议附带用户旅程步骤编号 | |
| 需求描述 | 功能概述 | 一句话提炼 I want 的动作,用于快速检索(如:批量筛选未发货订单) |
| 详细逻辑 | 分步骤描述操作过程、系统响应、异常分支 | |
| 价值与验收 | 业务价值 | 对应 So that,用可量化指标表达(如:减少订单处理时间30%) |
| 验收标准 | 具体的通过/不通过条件,一个故事至少包含 3~5 条验收项 | |
| 约束与依赖 | 前置条件 / 外部依赖 | 角色已登录、订单数据已同步、第三方服务可用等 |
避坑提醒: 结构化模板不是让字段变多,而是让模糊空间消失。如果一条需求在填入模板后发现“业务价值”写不出来或很牵强,说明这个需求本身的必要性存疑,应先做价值论证再进入PRD。
4.3 用户故事与结构化模板的映射关系
很多团队认为用户故事和PRD字段是两套东西,实际上它们是同一需求在不同粒度下的表达。下表展示如何从一句话用户故事映射到结构化模板的每个字段:
| 用户故事要素 | 对应模板字段 | 填表示例 |
|---|---|---|
| As a 已认证的商家管理员 | 用户角色 + 前置条件 | 角色:商家管理员;前置:已完成企业认证 |
| I want 按发货状态批量筛选 | 功能概述 + 详细逻辑 | 概述:批量筛选订单;逻辑:选择状态→点击筛选→列表刷新 |
| So that 快速定位未发货订单 | 业务价值 | 减少人工翻页查找时间,预计每单处理提速40% |
在实际撰写时,先写出用户故事的三段式骨架,再逐句展开填充模板,最后补充验收标准,这是当前主流互联网公司普遍采纳的“三段填充法”。
4.4 验收标准如何从用户故事中生长
验收标准不是凭空编造,而是从用户故事的每个分句中抽取出可验证的条件。以下是从同一个用户故事生长出的验收清单:
| 验收编号 | 验收项 | 来源分句 |
|---|---|---|
| AC-01 | 未认证的商家管理员不显示筛选按钮 | As a(角色权限边界) |
| AC-02 | 筛选下拉选项包含:未发货、部分发货、已发货、全部 | I want(动作粒度) |
| AC-03 | 选择“未发货”后列表仅展示待发货订单,不包含已取消订单 | I want(业务规则) |
| AC-04 | 筛选结果超过一页时支持分页,每页20条 | So that(可用性保障) |
| AC-05 | 点击“批量发货”后系统校验所选订单均符合发货条件,否则给出弹窗提示 | So that(价值不因异常而失效) |
验收标准铁律: 每一条验收项必须能用“是/否”或通过/不通过直接判定。避免使用“看起来美观”“响应较快”等主观描述。
4.5 用户故事结构化流程
下面这张流程图展示了从原始需求到完整结构化描述模板的转换路径,包含角色绑定、场景锚定、逻辑展开、价值量化、验收推导五个关键步骤:
整个流程强调不可跳跃:跳过角色锚定直接写逻辑,会导致权限遗漏;跳过价值量化直接写验收,会导致验收项与业务目标脱节。每步的输出都是下一步的输入。
4.6 避坑清单与自检要点
- 把用户故事写成了系统功能: “As a 系统,I want 返回错误码” — 用户故事的主角必须是真实用户角色或业务角色,系统行为应放在详细逻辑或验收标准中。
- So that 写成技术方案: “So that 我可以在API中传递token” — 应改为“So that 我可以安全地访问我的订单数据”。
- 一个故事包含多个需求: “I want 筛选、导出、打印订单” — 应拆分为三个独立用户故事,每个故事对应独立的验收标准。
- 验收标准重复需求描述: “系统应能筛选订单” — 验收标准必须具体到条件、操作、预期结果三者齐全。
自检五问(每条需求填写完成后逐一核对):
① As a 角色是否来自权限模型或用户画像,而非宽泛称谓?
② I want 是否只表达一个原子动作?
③ So that 是否可被定量或定性验证?
④ 验收标准是否至少覆盖正常路径、异常路径、边界条件?
⑤ 结构化模板中的“前置条件”是否与用户故事中的角色绑定?
① As a 角色是否来自权限模型或用户画像,而非宽泛称谓?
② I want 是否只表达一个原子动作?
③ So that 是否可被定量或定性验证?
④ 验收标准是否至少覆盖正常路径、异常路径、边界条件?
⑤ 结构化模板中的“前置条件”是否与用户故事中的角色绑定?
4.7 交付物模板:用户故事结构化卡片
在PRD中,建议每个需求以“卡片”形式呈现,便于开发与测试直接取用。以下为模板结构,可直接复制到文档中:
| 字段 | 内容示例 |
|---|---|
| 用户故事 | As a 已认证商家管理员,I want 在订单列表按发货状态批量筛选,So that 快速定位未发货订单集中处理 |
| 用户角色 | 商家管理员(已认证) |
| 触发场景 | 订单管理 → 订单列表页(默认展示全部订单) |
| 功能概述 | 发货状态批量筛选 |
| 详细逻辑 | 1. 列表上方显示筛选下拉框,选项:全部、未发货、部分发货、已发货; 2. 默认选择“全部”; 3. 选择后列表自动刷新,仅展示对应状态订单; 4. 筛选结果支持分页。 |
| 业务价值 | 减少商家翻页查找时间,预计每单处理效率提升40% |
| 验收标准 | AC-01 未认证角色不显示筛选按钮; AC-02 选项包含全部/未发货/部分发货/已发货; AC-03 筛选结果不包含已取消订单; AC-04 超过20条时自动分页; AC-05 批量发货时校验合法性。 |
| 前置条件 | 商家已登录且认证状态为“已认证”;订单数据已同步至系统。 |
以上模板可直接嵌入PRD的需求明细章节。每张卡片对应一个用户故事,开发与测试按卡片字段逐项执行,不再需要在需求文档和沟通记录之间来回翻找。
团队落地建议: 在需求评审前,要求产品经理将每条需求都填入此模板。评审时先过“用户故事”骨架,再过“验收标准”,最后确认“详细逻辑”。这个顺序能杜绝大部分因角色遗漏或价值模糊导致的返工。