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 标注元素协作关系图
下图展示四个标注元素在需求文档中的协作关系:需求编号作为唯一锚点,用户故事提供功能动机,验收条件明确完成标准,优先级引导排期决策。箭头代表信息传递与约束方向。
4.6 在原型说明中的标注位置
当将需求标注到原型(线框图 / 高保真原型)时,每个交互区域应附带一个标注块,包含以下字段:
- 需求编号 — 便于开发、测试快速定位原始需求卡
- 用户故事摘要 — 一句话说明角色与目标
- 验收条件引用 — 指向验收条件编号(例如
AC-001) - 优先级 — 直观显示是否必须在当前版本实现
下表总结了四个标注元素在需求文档与原型中的使用规则:
| 元素 | 定义核心 | 在原型中的体现形式 | 生命周期管理 |
|---|---|---|---|
| 需求编号 | 唯一标识符 | 标注框左上角(如 #LOG-001) | 新建即固定,永不重用 |
| 用户故事 | 角色→功能→价值 | 标注框内原文引用 | 需求变更时同步更新 |
| 验收条件 | 可测试断言(Given-When-Then) | 卡片背面或链接至独立验收清单 | 每个用户故事独立维护 |
| 优先级 | P0~P3,按价值/紧急度排序 | 标注框右上角颜色标签 | 每个版本结束后可调整 |
理解并正确使用这四个标注元素,是后续章节进行 RICE案例拆解 与 原型说明标注 的基础。在下一章(第五章)中,我们将把这些元素应用到具体的用户访谈记录,展示如何从一段对话中提取并标注完整的需求单元。