4、标注元素定义:需求编号、用户故事、验收条件、优先级

在需求拆解与原型说明标注方法中,标注元素是将用户访谈中模糊的“痛点”转化为结构化、可追溯、可验证的工程语言的核心工具。每个标注元素都有明确的定义、格式和职责边界。

本章从四个基础标注元素入手:需求编号(唯一标识)、用户故事(场景描述)、验收条件(可验证标准)、优先级(价值排序)。掌握它们的定义与协作关系,是后续RICE案例拆解与原型标注的基石。

课程上下文提醒:本章内容对应“用户场景 → 业务问题 → 用户访谈 → 需求拆解 → 方案表达 → 指标验证 → 验收标准 → 交付物模板”链条中的需求拆解与验收标准环节。标注元素将用户故事拆解为可交付的基本单元。

4.1 需求编号(Requirement ID)

需求编号是每个需求的全局唯一标识符,用于追溯、讨论和变更管理。常见格式采用模块前缀+流水号,如 REQ-LOG-001。

  • 模块前缀:如 LOG(登录)、ORD(订单)、PMT(支付)
  • 流水号:三位数字,从 001 起,按需求创建顺序递增
  • 禁止重用:即使需求被废弃,编号也不得重新分配给其他需求

典型的需求编号表格示例如下:

需求编号所属模块标题
REQ-LOG-001登录用户使用手机号+验证码登录
REQ-LOG-002登录30分钟内连续输错5次冻结账号
REQ-ORD-001订单用户下单后30分钟内可取消

4.2 用户故事(User Story)

用户故事是以用户视角描述功能的标准化格式,遵循 “As a [角色], I want [功能], so that [价值]” 结构。它从用户访谈中提炼,强调解决什么问题,而非如何实现。

用户访谈转化示例:
原始用户说:“每次下单后想取消,还要打电话给客服,太麻烦了。”
转化为用户故事:
As a 用户,I want 在订单详情页能直接点击“取消订单”按钮,so that 不需要联系客服就能自助取消。

用户故事三个要素必须完整:

  • 角色:谁在使用(用户、管理员、访客)
  • 功能:做什么(点击按钮、查看信息、提交表单)
  • 价值:为什么做(节省时间、提升体验、避免咨询)

4.3 验收条件(Acceptance Criteria)

验收条件是用户故事可测试的完成标准,通常以Given-When-Then格式描述。每个用户故事至少对应 2~3 条验收条件,覆盖主路径、边界和异常场景。

用户故事:用户取消30分钟内未支付的订单
验收条件:
1. Given 订单已创建且状态为“待支付”,
   When 用户点击“取消订单”按钮,
   Then 订单状态变为“已取消”,且支付页面关闭。
2. Given 订单支付时间已超过30分钟,
   When 用户点击“取消订单”按钮,
   Then 弹出提示“订单已超过可取消时间”。
3. Given 订单已取消,
   When 用户重新查看订单详情,
   Then 页面显示“已取消”状态。 
常见陷阱:验收条件写成“用户应该能顺利取消订单”——无法量化测试。必须包含具体的状态变化、错误信息、时间限制等可观测断言。

4.4 优先级(Priority)

优先级标注用于在资源冲突时排序。本课程采用 P0~P3 四级优先级体系,与RICE模型的 Impact 维度对齐:

级别含义RICE Impact示例
P0必须做,否则产品不可用极高(≥9)用户无法登录
P1用户关键路径,强烈推荐高(7~8)订单取消后自动退款
P2提升体验但非必需中(4~6)取消订单时显示预计退款时间
P3有则更好,低投入改进低(1~3)取消订单后弹窗打星评分

优先级应在需求拆解同时标注,避免后期推翻重排。优先级可随项目阶段调整(如 P2 在版本2 升为 P1)。

4.5 标注元素协作关系图

下图展示四个标注元素在需求文档中的协作关系:需求编号作为唯一锚点,用户故事提供功能动机,验收条件明确完成标准,优先级引导排期决策。箭头代表信息传递与约束方向。

标注元素协作关系图 用户故事 As a… I want… So that… 需求编号 REQ-MOD-001 验收条件 Given-When-Then 优先级 P0 / P1 / P2 / P3 每个需求编号关联一个用户故事,用户故事产出多条验收条件,优先级决定开发次序。

4.6 在原型说明中的标注位置

当将需求标注到原型(线框图 / 高保真原型)时,每个交互区域应附带一个标注块,包含以下字段:

  1. 需求编号 — 便于开发、测试快速定位原始需求卡
  2. 用户故事摘要 — 一句话说明角色与目标
  3. 验收条件引用 — 指向验收条件编号(例如 AC-001)
  4. 优先级 — 直观显示是否必须在当前版本实现
实践建议:在原型旁标注时,使用统一颜色的标签(如优先级P0用红底白字、P1用橙底白字),方便评审时快速识别版本范围。

下表总结了四个标注元素在需求文档与原型中的使用规则:

元素定义核心在原型中的体现形式生命周期管理
需求编号唯一标识符标注框左上角(如 #LOG-001)新建即固定,永不重用
用户故事角色→功能→价值标注框内原文引用需求变更时同步更新
验收条件可测试断言(Given-When-Then)卡片背面或链接至独立验收清单每个用户故事独立维护
优先级P0~P3,按价值/紧急度排序标注框右上角颜色标签每个版本结束后可调整

理解并正确使用这四个标注元素,是后续章节进行 RICE案例拆解 与 原型说明标注 的基础。在下一章(第五章)中,我们将把这些元素应用到具体的用户访谈记录,展示如何从一段对话中提取并标注完整的需求单元。

交付物模板提示:本章对应的交付物模板为《需求标注元素清单》,包含需求编号、用户故事原文、验收条件列表、优先级字段。该模板将在第六章的“交付物模板”章节中完整展示。