判断用例粒度是否合适,可以围绕三个问题自查:每个用例是否对应一个可独立验收的参与者目标,主成功场景能否在一个验收周期内走完,同一用例集中的用例是否处在相近的目标层级。把这三条转化为目标覆盖度、场景完整度、层级一致性三项指标,再结合评审证据,就能定位过粗或过细的用例,并决定拆分还是合并。
要点总览(TL;DR)
- 判断用例粒度是否合适,先看三条:每个用例是否对应单一可独立验收的参与者目标,主成功场景能否在一个验收周期内走完,同一用例集里的用例是否处在相近目标层级。
- 把三条标准转成可算的指标:目标覆盖度看验收条件是否被主成功场景覆盖,场景完整度看用例是否具备前置条件、触发事件、主成功路径和结果,层级一致性看用例集内部切分是否均衡。
- 识别过粗的信号是评审时需要拆成多个目标才能说清,识别过细的信号是只能描述某个步骤或界面操作;调整方式分别是按目标拆分和合并回上层用例。
- 阈值以团队自身基线对比为主,首次评估记录基线,后续看趋势;分母为零或样本过小时只作参考,不单独下结论。
- 调整后要重新计算指标并复核,粒度评估随迭代滚动进行,一次结论只代表当前版本状态。
评估目标:粒度合适要回答什么问题
粒度评估针对的是用例的“切分方式”,即一个用例承载多少目标、多少场景、多少验收信息。它不判断需求内容本身是否正确,也不判断系统架构是否合理。需求内容有误,应由需求分析与澄清解决;模块如何划分,属于架构设计。粒度评估只回答:这份用例集是否便于理解、评审和验收。
具体要回答三个问题。第一,目标是否单一:一个用例是否只服务一个参与者想要达成的结果,而不是把多个目标捆在一起。第二,场景是否可验收:用例是否具备明确的前置条件、触发事件、主成功路径和可观察结果,使验收人员能据此判断通过与否。第三,层级是否一致:同一用例集里的用例是否处在相近的目标层级,避免有的用例描述一个完整业务目标,有的只描述一次界面操作。
判定对象包括两个层面:单个用例,以及该用例所在的用例集。单个用例看目标与场景是否自洽;用例集看整体切分是否均衡、有无遗漏或重复。评估前先明确这两层对象,后续指标才有稳定的统计单位。
指标与范围:三个可自查的粒度指标
三项指标都按比例计算,分子是符合要求的数量,分母是纳入统计的总量。使用前先固定统计范围,否则不同批次的数据无法比较。
| 指标 | 计算方式 | 分子 | 分母 | 反映的问题 |
|---|---|---|---|---|
| 目标覆盖度 | 被至少一个用例主成功场景覆盖的验收条件数 ÷ 验收条件总数 | 已被覆盖的验收条件数 | 验收条件清单中的条目总数 | 用例切分是否遗漏验收要求 |
| 场景完整度 | 要素齐全的用例数 ÷ 用例总数 | 同时具备前置条件、触发事件、主成功路径和结果的用例数 | 纳入统计的用例总数 | 单个用例是否写到可验收的程度 |
| 层级一致性 | 目标层级相同的用例数 ÷ 用例总数 | 与用例集主导层级相同的用例数 | 纳入统计的用例总数 | 用例集内部切分是否均衡 |
统计范围建议限定在同一需求域、同一迭代或同一用例集内,并记录统计时间窗。跨需求域合并计算会掩盖局部问题;跨迭代比较则要先确认验收条件清单的口径一致。单位统一为“条”和“个”,比例结果保留一位小数即可,便于团队沟通。
三项指标各有侧重:目标覆盖度偏低,通常意味着用例切得过粗,多个验收条件挤在少数用例里,或者存在遗漏;场景完整度偏低,说明部分用例只写了标题或步骤梗概,尚未达到可验收状态;层级一致性偏低,说明用例集里混入了不同抽象层级的条目,需要重新归层。
数据口径与证据:从哪里取数、如何判定
指标取数主要来自三类材料:用例文档、验收条件清单、评审记录。用例文档提供前置条件、触发事件、主成功路径和结果等要素;验收条件清单提供分母;评审记录提供定性判断的依据。三者应来自同一版本,避免用旧清单核对新用例。
定性证据的判定标准是:在评审中,评审人能否指出该用例对应的单一参与者目标,并说明其主成功场景的结果如何验收。能明确指出,记为通过;需要拆成两三个目标才能说清,记为过粗信号;只能描述某个步骤或界面操作,记为过细信号。评审记录中保留这些判断,便于后续复核。
缺失值需要单独处理。验收条件缺失时,相关用例不计入目标覆盖度的分母,并在清单中标注“待补验收条件”,避免用不完整的分母得出虚高比例。用例缺少前置条件或结果时,仍计入场景完整度的分母,但分子不计,以如实反映完整度。
不可比情况要隔离。不同目标层级的用例不混入同一分母计算层级一致性;业务用例与子功能用例应分组统计。若某组用例数量过少,例如少于五条,比例波动大,只作参考,不据此下结论。
计算与评估步骤:从取数到结论
评估按以下四步执行,结果可复算、可复核。
- 圈定用例集与验收条件清单。确定本次评估的需求域或迭代范围,锁定用例文档版本和验收条件清单版本,记录统计时间窗。
- 逐条标注目标层级与场景要素。为每个用例标注参与者目标、目标层级,并核对前置条件、触发事件、主成功路径、结果四项要素是否齐全。
- 计算三项指标。按上一节的公式分别计算目标覆盖度、场景完整度和层级一致性,记录分子、分母和结果。
- 结合评审证据定位问题用例。对未覆盖的验收条件、要素缺失的用例、层级偏离的用例逐一查看评审记录,判断属于过粗、过细还是单纯遗漏。
阈值的使用应以基线对比为主。首次评估时记录当前数值作为基线,后续迭代比较变化趋势;若团队已有历史数据,可参考历史区间判断本次是否异常。通用达标线容易脱离具体项目,不建议直接套用。指标下降时,先确认是切分变化还是统计口径变化,再决定是否调整用例。
在用例与验收条件的管理环节,可以把验收条件清单和用例放在同一工作项体系内维护,让覆盖关系可追溯。ONES 支持在工作项与文档中记录用例要素、关联验收条件,并通过评审流转保留判断记录,便于按迭代复算上述指标。工具承载的是记录与追溯,粒度是否合适仍由团队按本文标准判断。
例子:一份用例集的粒度自查
以下为演示情景,用于说明计算过程,数值为示例数据。
某需求域一个迭代内共有 12 个用例,验收条件清单共 20 条。逐条核对后发现:18 条验收条件被至少一个用例的主成功场景覆盖;9 个用例四项场景要素齐全;10 个用例与用例集主导层级相同。
| 指标 | 分子 | 分母 | 结果 |
|---|---|---|---|
| 目标覆盖度 | 18 | 20 | 90.0% |
| 场景完整度 | 9 | 12 | 75.0% |
| 层级一致性 | 10 | 12 | 83.3% |
结合评审记录定位问题。未覆盖的 2 条验收条件集中在“订单取消后的退款时效”,说明相关用例切分时遗漏了这一分支,属于覆盖缺口。3 个要素缺失的用例中,有 1 个把“下单、支付、发货通知”三个目标写在同一用例里,评审时需要拆成三个目标才能说清,属于过粗;另外 2 个只写了“点击结算按钮后跳转”这类步骤,缺少前置条件和结果,属于过细。层级偏离的 2 个用例中,1 个描述的是完整业务流程,高于用例集主导层级,应上移或拆分;1 个只描述单个界面操作,应下沉为子功能用例或并入上层用例的步骤。
调整动作:将过粗用例按参与者目标拆为三个用例,并补齐退款时效相关验收条件;将过细用例合并回其所属的上层用例,作为主成功路径中的步骤;对层级偏离的用例重新归层。调整后重新计算,目标覆盖度升至 100%,场景完整度升至 91.7%,层级一致性升至 100%。这些变化说明切分更均衡,但仍需下一轮评审确认新拆出的用例是否各自可独立验收。
解读与限制:指标说明什么、不说明什么
三项指标反映的是用例集的覆盖情况与切分一致性,不直接等于需求质量。覆盖度高,说明验收条件在用例中有对应场景,不代表这些场景描述的业务规则正确;层级一致,说明切分均衡,不代表每个用例的目标选得有价值。指标是自查工具,不能替代需求评审和业务确认。
分母为零时需要特别说明。若某用例集没有验收条件清单,目标覆盖度无法计算,应先补清单再评估,不能记为 0% 或 100%。样本过小时,例如用例不足五条,比例对单条变化非常敏感,应结合逐条评审判断,不单独依据比例下结论。
粒度合适是相对判断,取决于团队规模、验收节奏和需求复杂度。同一份用例,在快速迭代的小团队中可能偏细,在跨部门验收的场景中可能仍偏粗。评估结论应写明适用范围和统计时间窗,便于后续比较。
调整后需要复核。拆分或合并会改变分母和覆盖关系,调整后的指标应重新计算,并由评审确认新用例是否满足单一目标和可验收要求。粒度评估通常随迭代滚动进行,一次结论只代表当前版本的状态,不宜作为长期定论。
常见问题
团队第一次做粒度评估,没有历史基线,阈值怎么定?
首次评估不设达标线,先把当前数值记为基线。做法是:圈定一个需求域或一个迭代的用例集,按目标覆盖度、场景完整度、层级一致性三项指标算出结果并记录分子分母,同时保留评审记录中的判断依据。下一轮评估时比较同一口径下的变化,若某项指标下降,先确认是切分变化还是统计口径变化,再决定是否调整用例。基线本身也可以随团队验收节奏逐步修正,不必一次定死。
一个用例里包含多个参与者协作完成的目标,算过粗吗?
要看这些参与者是否在服务同一个可验收的业务结果。如果多个参与者围绕同一结果协作,例如下单流程中买家提交、系统校验、仓库接单,可以放在一个用例中,用不同参与者与系统交互的步骤来描述。如果在评审时需要拆成两三个独立目标才能说清各自的验收结果,就属于过粗,应按参与者目标拆分为多个用例,再用包含关系或前置条件衔接。判断依据是验收时能否用一句话说明该用例通过与否。
验收条件清单不完整时,目标覆盖度还能算吗?
可以算,但要先处理分母。验收条件缺失的条目不计入分母,并在清单中标注“待补验收条件”,避免用不完整的分母得出虚高比例。同时应把补清单作为前置动作,因为目标覆盖度的意义在于核对用例是否覆盖了全部验收要求,清单本身残缺时,指标只能反映已登记部分的情况。补全清单后重新计算,并与补全前的数据分开记录,便于比较口径变化。
用例数量很少的项目,三项指标还有参考价值吗?
用例不足五条时,比例对单条变化非常敏感,增删一个用例就可能让指标跳动十几个百分点。这种情况下指标只作参考,判断应以逐条评审为主:逐个确认用例是否对应单一参与者目标、场景要素是否齐全、层级是否与用例集主导层级一致。指标可以保留记录,用于后续用例增多后的趋势对比,但不建议据此单独下“过粗”或“过细”的结论。
拆分或合并用例后,如何确认调整到位?
调整后重新计算三项指标,并组织一次小范围复核。复核重点看新拆出的用例是否各自对应单一参与者目标、主成功场景能否独立验收,合并后的用例是否仍保留原有验收条件的覆盖。指标上升说明切分更均衡,但覆盖关系变化后仍需确认没有引入新的遗漏。复核记录与调整前的数据一并保留,下一轮评估时可直接对比。
