需求拆解:用户故事与验收标准
本篇要点:把一段读起来像需求文档的文字,切成一批两三天能做完、做完能在评审会上演示、演示完有人能判断对错的故事卡。 前置文章:[《看板与流动效率》](/guide/agile/kanban-flow-metrics.html)我们看清了卡片在列与列之间怎么流动;这一章回头处理流进来的东西本身——卡片太大,WIP 限制也救不了。
一、为什么需要它
2026 年 4 月,一家做跨境电商的团队排了「优惠券叠加」,需求文档 1 200 字。计划会上开发估了 13 点,拆成三张卡:券服务改造、结算页改造、风控校验。第二个迭代第 6 天,测试在验收时问:三张券能不能同时用?产品答最多两张,同类型互斥,不同类型按面额从大到小抵扣。开发做的是任意张数自由叠加。返工五天,迭代目标没完成。
问题出在三个地方。
卡片按技术层切。三张卡都能「做完」,没有一张能单独拿给用户看。券服务改完了结算页没改,用户看到的东西一点没变,这种卡在评审会上无法演示,也就失去了提前发现理解偏差的机会。
验收标准写的是愿望,不是条件。原文只有一句「支持多券叠加,保证金额计算正确」。先打折还是先满减?100 元的订单用一张满 100 减 20 加一张 9 折券,实付多少?没有一条写清楚。开发只能自己选顺序,测试也只能按自己的理解写用例。
澄清发生在编码之后。风控里的「同类型互斥」是测试执行用例时才提的,此时三个模块已经写完,改动成本远高于动笔之前。
需求拆解处理的就是从「一段需求」到「一批能开工的卡」这段路。它不产出更漂亮的文档,产出能被演示、被验证、被拒绝的小块交付。
二、核心概念
4.1 故事卡是索引,不是规格书
用户故事(user story)用一句话描述一个价值单元,句式固定:
作为 <角色>,我想要 <能力>,以便 <价值>。
三个空都要落到具体的人和事上。「作为用户,我想要更好的体验,以便更满意」看着完整,三个空却都不可验证。换成「作为运营,我想要批量导出一个月对账明细,以便和财务核对」,就有可检查的内容。
卡片背后还有两样东西:围绕它谈出来的规则与取舍叫对话(conversation),写下来的对错判断叫确认(confirmation)。加卡片即是 Ron Jeffries 说的 3C。卡里塞满规则,得到一份缩小的需求文档,而对话照样发生,只是挪到编码之后。
判断一张卡合不合格,用 INVEST 六条自检(Bill Wake,2003)。六条里最常被跳过的是 S 和 T。
| 自检项 | 含义 | 不合格的样子 | 怎么改 |
|---|---|---|---|
| Independent 可独立 | 能单独排期、单独验收 | 「先做服务,再做页面」互为前置 | 改纵向切片 |
| Negotiable 可协商 | 细节留给对话 | 卡里写满字段类型与接口签名 | 只留规则与边界 |
| Valuable 有价值 | 用户或业务能感知 | 「升级 Redis 到 7.2」 | 说明它支撑哪个可感知变化,或降级为技术任务 |
| Estimable 可估算 | 团队能给出量级 | 「优化搜索相关性」 | 挂 spike(限时调研)压低未知 |
| Small 足够小 | 迭代内完成,通常 1 到 3 天 | 一张卡估 13 点 | 按 4.3 切开 |
| Testable 可验证 | 能写出对错判断 | 「提升结算体验」 | 写成 Given-When-Then 场景 |
4.2 验收标准把「正确」写成可执行条件
验收标准(acceptance criteria)的通用格式是 Given-When-Then:给定什么前提,做了什么动作,看到什么结果。写法来自行为驱动开发(BDD,behavior-driven development),Dan North 在 2006 年把它整理成一条从需求直通自动化测试的路。写的时候守三条纪律。
一条场景只验证一条规则。Then 后面出现三次「并且」,说明其实是两个规则。
Then 写可观察的结果,不写内部实现。「Then coupon_usage 表新增一条记录」一次表结构重构就失效;「Then 应付金额显示 72.00 元」才是用户看得见、也能被自动断言的结果。
异常和边界单独成场景。多数返工不是主流程没写,而是没人写下「券过期了怎么办」「金额刚好等于门槛算不算」。用场景大纲(Scenario Outline)配 Examples 表,一行一个边界。
原标准只有一句「支持多券叠加,保证金额计算正确」,改写后:
| 场景 | 前置 | 动作 | 结果 |
|---|---|---|---|
| 满减与折扣叠加 | 购物车 100.00 元,两张券都在有效期 | 先用满 100 减 20,再打 9 折 | 应付 72.00 元 |
| 刚好达到门槛 | 购物车 99.99 元 | 使用满 100 减 20 | 提示未达门槛,应付 99.99 元 |
| 同类型互斥 | 两张品类券 | 同时勾选 | 只生效面额较大的一张 |
顺序值得单独算:100 元先减 20 再打 9 折是 72.00,先打 9 折再减 20 是 70.00,差 2 元就是两个需求。不写顺序,团队各自实现一个,然后在验收会上吵。
4.3 切片策略:纵向切,不横向切
把大需求切成小故事,最省事的切法是按层切(前端、后端、数据库),最不该用的也是它。正确的切法叫纵向切片(vertical slice):每一片从界面穿到存储,单独交付就有用户可见的变化。像切蛋糕,每块都该同时有奶油和蛋糕胚;按层切拿到的是那盘奶油,技术上「完成」了,谁也吃不上。
切片方式有五种,选哪种取决于这条需求最大的不确定性在哪。
| 策略 | 适用场景 | 例子 | 风险 |
|---|---|---|---|
| 按工作流步骤 | 长流程、多角色 | 先只做货到付款下单,再做在线支付 | 前几片价值低,需要产品认可 |
| 按业务规则 | 规则复杂、可分级 | 先支持一种券,再叠加,再互斥 | 规则引擎容易过早抽象 |
| 按数据范围 | 多币种、多租户 | 先人民币单商户,再扩展 | 数据结构后期改动成本高 |
| 按粗糙度 | 链路长、集成多 | 先做端到端最薄通路,再补交互 | 骨架需要额外返工打磨 |
| 按异常路径 | 主流程清晰、分支多 | 主流程一张卡,超时与补偿一张卡 | 异常卡依赖主流程先上线 |
表里那个「端到端最薄通路」有个名字叫可行走骨架(walking skeleton),不做美化,只要从入口到存储全通。它不交付价值,作用是尽早暴露集成问题——第三方鉴权、时区、金额精度这类坑,骨架阶段发现要半天,功能全做完要一周。
先看两种切法的交付节奏差在哪。
图 4-1 横向切片与纵向切片的交付节奏差异
如图 4-1 所示,13 点拆成 3+3+2+2+3,总点数没变,第 3 天却有东西可演示。产品那时说「顺序反了」,也只损失一张卡。
4.4 需求澄清会:三个角色,45 分钟
需求澄清会(backlog refinement,早期也叫 grooming)不是把需求讲一遍,是把卡片从「读得懂」推到「能开工」。产品、开发、测试三方到场,业内叫 three amigos——产品问价值,开发问实现,测试问边界。
会前 48 小时,产品把卡片和标准草稿贴到看板,开发和测试各留至少两条疑问。没有会前准备,45 分钟里 30 分钟在念文档。
一次会议处理 4 张卡,节奏固定:
| 时段 | 动作 | 产出 |
|---|---|---|
| 前 5 分钟 | 过一遍上轮遗留问题 | 关闭或重新排期 |
| 每卡 8 分钟 | 产品讲价值与规则,不讲解实现 | 团队能复述「做完是什么样」 |
| 每卡 4 分钟 | 开发与测试提问,只问边界和反例 | 新增的验收标准 |
| 每卡 3 分钟 | 当场改卡:补场景、标依赖、定点数或 spike | 卡片状态更新 |
散会时每张卡要么满足就绪定义(DoR,definition of ready),要么明确退回。DoR 四条够用:角色与价值明确;验收标准可测且至少一个异常场景;依赖已识别;能估出点数,估不出就挂限时 spike。
三、动手实践
下面用「优惠券叠加」走一遍:写卡、写标准、跑自动校验。环境为 Python 3.11、pytest 8、pytest-bdd 7。
步骤一:把故事卡写成可校验的 YAML
先用结构化格式写卡,后面的脚本才检查得动。字段不用贪多。
# stories/us-042.yaml
id: US-042
title: 两张不同类型的券可以叠加
as_a: 消费者
i_want: 在结算页同时使用一张满减券和一张折扣券
so_that: 一次下单拿到最大优惠
points: 3
acceptance:
- scenario: 满减券与折扣券叠加
kind: 正常
given: 购物车金额 100.00 元,两张券都在有效期内
when: 先使用满 100 减 20 的品类券,再使用 9 折平台券
then: 应付金额显示 72.00 元
- scenario: 满减券未达门槛时置灰
kind: 边界
given: 购物车金额 95.00 元
when: 使用满 100 减 20 的品类券
then: 该券置灰,提示「未达到使用门槛」
- scenario: 退款后券退回原状态
kind: 异常
given: 已用两张券完成支付
when: 订单全额退款
then: 两张券恢复为未使用且有效期不变运行结果:
$ yq '.acceptance[].scenario' stories/us-042.yaml
满减券与折扣券叠加
满减券未达门槛时置灰
退款后券退回原状态步骤二:把验收标准翻译成可执行的 Gherkin
Gherkin 是 Cucumber 系工具读的语法,关键字固定英文,句子写中文。翻译只做一件事:把 YAML 里的三段搬到 Given/When/Then 后面。
# features/coupon_stack.feature
Feature: 优惠券叠加
作为消费者
我希望在结算页同时使用满减券和折扣券
以便一次下单拿到最大优惠
Scenario: 满减券与折扣券叠加
Given 购物车金额 100.00 元,两张券都在有效期内
When 先使用满 100 减 20 的品类券,再使用 9 折平台券
Then 应付金额显示 72.00 元
Scenario Outline: 门槛边界
Given 购物车金额 <金额> 元
When 使用满 100 减 20 的品类券
Then 该券<状态>
Examples:
| 金额 | 状态 |
| 99.99 | 置灰并提示未达门槛 |
| 100.00 | 可用 |运行结果:
$ pytest --bdd-features-base-dir features -q
...
1 feature passed, 0 failed
3 scenarios passed, 0 failed
9 steps passed, 0 failed100.00 那一行是关键:门槛判断用「大于等于」还是「大于」,只有把 99.99 和 100.00 并排放进 Examples,这个分歧才藏不住。
步骤三:用脚本给一批卡片做体检
一个人写卡容易自我感觉良好,十张一起看就暴露了。脚本查四件事:标准条数、GWT 是否齐全、有无异常场景、点数是否过大。
# check_stories.py
import sys
import yaml
def audit(card):
problems = []
acs = card.get("acceptance", [])
if not 3 <= len(acs) <= 7:
problems.append(f"验收标准 {len(acs)} 条,应为 3-7 条")
for ac in acs:
missing = [k for k in ("given", "when", "then") if not ac.get(k)]
if missing:
problems.append(f"{ac.get('scenario')} 缺 {','.join(missing)}")
if not any(ac.get("kind") == "异常" for ac in acs):
problems.append("没有异常场景")
if card.get("points", 0) > 5:
problems.append(f"{card['points']} 点,超过 5 点建议再切")
return problems
cards = [yaml.safe_load(open(p, encoding="utf-8")) for p in sys.argv[1:]]
bad = 0
for c in cards:
p = audit(c)
print(("FAIL " if p else "PASS ") + f"{c['id']} {c['title']}")
for item in p:
print(f" - {item}")
bad += bool(p)
print(f"\n{len(cards)} 张卡,{bad} 张待修改")
sys.exit(1 if bad else 0)运行结果:
$ python check_stories.py stories/*.yaml
PASS US-041 用一张满减券下单
PASS US-042 两张不同类型的券可以叠加
FAIL US-043 券模板批量导入
- 验收标准 9 条,应为 3-7 条
FAIL US-045 退款后券的退回与失效
- 没有异常场景
- 8 点,超过 5 点建议再切
4 张卡,2 张待修改US-043 的 9 条标准是最典型的信号:超过 7 条基本可以断定卡没切开。把它放进 CI,有人往卡里加标准就提醒一次,比在回顾会上说「注意卡片大小」有效。
四、常见误解
很多人以为 INVEST 里的 Independent 是说故事之间不能有依赖。几乎不存在零依赖的故事:同一张表的字段、同一个接口的鉴权,前后必然有关。这条要的是「能独立排期与验收」——先做哪张由价值决定,不由技术决定。真要强顺序,用可行走骨架先打通通路。
很多人以为验收标准写得越多越严谨。一张 8 条标准的卡,问题在第 8 条暴露时,前几条的代码可能都要改。另一种混淆是把标准当测试用例:一条标准能派生十几个用例(不同金额、券组合、时区)——标准描述规则,用例覆盖取值。
很多人以为澄清会就是产品讲、大家听、听完记下问题。有价值的产出是「新增的边界条件」和「被切小的卡」。判断标准很朴素:散会时卡片有没有被改动。一张没动过的卡,要么足够清楚,要么这个会白开了,多数是后者。
五、小结
[《看板与流动效率》](/guide/agile/kanban-flow-metrics.html)讲的是卡片在列之间怎么流动,这一章处理卡片本身的大小与清晰度。
- 故事卡是索引,不是规格书。3C 里的对话和确认才是内容;规则全写进描述,对话只是被推到编码之后。
- INVEST 六条里,S(够小)和 T(可验证)最能提前暴露问题,其余四条多数卡天然满足。
- 验收标准用 GWT,一条场景一个规则,Then 写可观察结果。顺序、精度、时区不写,就是各做各的。
- 切片按纵向切:流程长的按步骤切,规则复杂的按业务规则切,集成多的先做可行走骨架。
- 澄清会 45 分钟处理 4 张卡,散会时每张卡必须被改动,或者被退回。
六、相关文章
卡片切小了、标准写清了,下一个问题紧跟着来:这张 3 点的卡,凭什么说它是 3 点?[《估算与预测:故事点与蒙特卡洛》](/guide/agile/estimation-forecasting.html)讲估算与预测:相对估算怎么用参考故事锚定,计划扑克为什么常跑成「谁职级高听谁的」,以及怎样用 8 个迭代的历史数据算出一句「85% 概率在 5 个迭代内」,而不是再答一句「差不多」。
继续阅读:[《估算与预测:故事点与蒙特卡洛》 估算与预测:故事点与蒙特卡洛](/guide/agile/estimation-forecasting.html)