Applicable Scenarios
- Break functional modules into independently deliverable user stories
- Define testable acceptance criteria for each feature point
- Provide input for developers to break down tasks and for QA to write test cases
- Verify whether requirements are clear and executable enough
Core Format
Three-Part User Story
作为 <用户角色>
我希望 <完成某个动作>
以便 <获得某个价值>
Example:
✅ Good:
作为已登录的普通用户
我希望能在订单详情页一键申请退款
以便不用再发邮件给客服等待回复
❌ Bad:
作为系统
我要支持退款功能
(No user, no value, disguising a technical task as a user story)
Acceptance Criteria Given/When/Then
Given <前置条件>
When <用户行为>
Then <系统结果>
Example:
Given 用户已登录且订单状态为"已支付"
When 用户在订单详情页点击"申请退款"按钮
Then 系统创建退款申请并显示"已提交,预计 3 个工作日处理"
And 订单状态变为"退款审核中"
Each user story must contain at least:
- 1 main path acceptance criterion
- At least 1 exception path acceptance criterion
INVEST User Story Check
After writing each story, self-check with the following 6 items:
I - Independent(独立)
能否独立交付?是否依赖其他故事必须先完成?
N - Negotiable(可协商)
是否保留了协作和讨论空间?还是把实现细节写死了?
V - Valuable(有价值)
是否对用户有明确价值?还是技术内部需要?
E - Estimable(可估算)
能不能估出工期?信息是否足够?
S - Small(足够小)
AI 工作流能否 30~60 分钟内完成?超过就要继续拆。
T - Testable(可测试)
有没有 Given/When/Then 验收标准?能不能验证?
Splitting Patterns (Richard Lawrence's 9 Patterns)
When a story is too large, split it according to the following patterns:
1. 工作流步骤拆分
注册流程 → 填写信息 / 验证邮箱 / 完善资料
2. 业务规则变体
订单退款 → 7 天内 / 超过 7 天 / 已发货 / 未发货
3. 操作(CRUD)拆分
用户管理 → 创建 / 查询 / 修改 / 删除
4. 数据类型变体
附件上传 → 图片 / 文档 / 视频
5. 数据接口拆分
导入 → CSV / Excel / API
6. 延迟性能优化
先实现功能 / 后优化性能
7. 简单/复杂场景拆分
简单退款(自动) / 复杂退款(人工审核)
8. 主要/次要操作
主操作 / 撤销 / 历史记录
9. 横切关注点
先实现功能 / 后加权限 / 再加日志
Workflow
1. 接收功能需求或 PRD 第 6 节内容
↓
2. 识别用户角色(每个角色单独考虑)
↓
3. 列出每个角色要完成的任务
↓
4. 用三段式写故事
↓
5. 用 INVEST 检查
↓
6. 太大就用拆分模式继续拆
↓
7. 每条故事写主路径 + 异常路径验收标准
↓
8. 输出故事清单(含优先级)
Output Format
## US-001: 用户申请退款
**故事**:
作为已登录的普通用户
我希望能在订单详情页一键申请退款
以便不用再发邮件给客服等待回复
**优先级**:P0(Must Have)
**预估工期**:30 分钟(AI 节奏)
**依赖**:订单详情页(US-XXX)
**验收标准**:
主路径:
- Given 用户已登录且订单状态为"已支付"
- When 用户点击"申请退款"
- Then 创建退款申请,订单状态变为"退款审核中"
异常路径 1:订单已超过退款期限
- Given 订单已支付超过 30 天
- When 用户点击"申请退款"
- Then 显示"超过退款期限"提示,按钮置灰
异常路径 2:订单状态不允许退款
- Given 订单状态为"已退款"或"已取消"
- When 用户进入订单详情页
- Then 不显示"申请退款"按钮
**INVEST 检查**:
- [x] Independent:不依赖其他故事
- [x] Negotiable:实现方式可讨论
- [x] Valuable:用户价值明确
- [x] Estimable:30 分钟可完成
- [x] Small:足够小
- [x] Testable:有 G/W/T 标准
Quality Self-Check
□ 是否用了"作为...我希望...以便..."三段式?
□ 用户角色是否具体?(不能只写"用户")
□ 价值描述是否真实?(不能只写"为了完成功能")
□ 是否通过了 INVEST 6 项检查?
□ 是否同时有主路径和异常路径验收标准?
□ Given/When/Then 是否可测试?
□ 是否估算了 AI 工期?
Common Pitfalls
- Disguising a technical task as a user story——"As a system, I want..."
- Writing empty words in the value section——"In order to improve user experience"
- Writing only positive acceptance criteria——Exception scenarios are what QA cares about most
- Not splitting stories that are too large——Anything over 60 minutes must be split using the 9 patterns
- User roles that are too broad——"user" → change to "logged-in free user"
- G/W/T not testable——"Then the user feels satisfied" → change to specific observable system behavior
Supporting Templates
templates/user-story-template.md— Single story templatetemplates/acceptance-criteria-template.md— Story list template (including priority matrix)
Collaboration with Other Skills
上游:
prd-writing → 第 6 节功能需求转化为用户故事
mvp-scoping → 标注每条故事的优先级(Must/Should/Could/Won't)
下游:
转交项目经理 → 拆排期
转交 QA → 设计测试用例
转交开发 → 实现功能