Skip to content

需求拆解:用户故事与验收标准 ​

本篇要点:把一段读起来像需求文档的文字,切成一批两三天能做完、做完能在评审会上演示、演示完有人能判断对错的故事卡。 前置文章:[《看板与流动效率》](/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 ​

先用结构化格式写卡,后面的脚本才检查得动。字段不用贪多。

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: 两张券恢复为未使用且有效期不变

运行结果:

text
$ yq '.acceptance[].scenario' stories/us-042.yaml
满减券与折扣券叠加
满减券未达门槛时置灰
退款后券退回原状态

步骤二:把验收标准翻译成可执行的 Gherkin ​

Gherkin 是 Cucumber 系工具读的语法,关键字固定英文,句子写中文。翻译只做一件事:把 YAML 里的三段搬到 Given/When/Then 后面。

gherkin
# 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 | 可用               |

运行结果:

text
$ pytest --bdd-features-base-dir features -q
...
1 feature passed, 0 failed
3 scenarios passed, 0 failed
9 steps passed, 0 failed

100.00 那一行是关键:门槛判断用「大于等于」还是「大于」,只有把 99.99 和 100.00 并排放进 Examples,这个分歧才藏不住。

步骤三:用脚本给一批卡片做体检 ​

一个人写卡容易自我感觉良好,十张一起看就暴露了。脚本查四件事:标准条数、GWT 是否齐全、有无异常场景、点数是否过大。

python
# 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)

运行结果:

text
$ 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)