用例编写规范:评审流程、责任分工与修正机制设计
用例编写规范要真正执行,需要三件事配套:可检查的规范条目与编写步骤、分级评审流程、不合规修正闭环。本文按“先定标准、再定流程与人、最后处理问题”的顺序,给出可直接落地的条目清单、角色职责表、整改规则和一个完整示例,适用于正在建立或修订用例评审机制的测试与需求团队。
Table of Contents
要点总览(TL;DR)
- 把规范条目写成可逐条判定的表述,并固定从需求到用例初稿的编写步骤,评审才有统一依据。
- 评审按作者自检、同行走查、正式评审分级,在初稿完成、需求变更后、版本基线前三个节点触发,结论限定为通过、有条件通过、退回。
- 作者负责编写与整改,评审人只判断规范条目符合性,规范负责人裁定争议并维护规范,需求方确认业务覆盖,测试执行方反馈可执行性。
- 不合规问题按严重、一般、轻微分级设定整改时限,由原评审人复评后关闭;同类问题反复出现时先辅导,再检查规范条目本身是否需要修订。
- 用评审覆盖率、评审及时性、问题关闭率、反复问题次数和规范更新跟进五项指标定期检查机制是否真正运转。
先定规范条目与编写步骤:让评审有据可依
评审要能给出“通过”或“退回”的结论,前提是规范条目本身可以被逐条判定。把“描述清晰、逻辑完整”这类要求改写成可检查的表述,评审人才有统一的判断口径,作者也知道写到什么程度算完成。
规范应覆盖的用例要素
建议把以下要素写成规范条目,每条都附带判定方式,形成一份可勾选的检查清单:
| 要素 | 可检查的表述示例 | 判定方式 |
|---|---|---|
| 标识 | 每条用例有唯一编号,编号在用例库内不重复 | 查重、核对编号规则 |
| 关联需求 | 每条用例至少关联一条需求条目,关联关系可在用例详情中查看 | 抽查关联字段是否为空 |
| 前置条件 | 前置条件写明执行前必须满足的数据、权限或环境状态,不写“系统正常”这类笼统描述 | 逐条阅读,确认可复现 |
| 操作步骤 | 每个步骤只包含一个可执行动作,步骤中出现的输入数据有具体值或取值来源 | 按步骤试走一遍 |
| 预期结果 | 每个步骤或每组步骤对应明确的预期结果,结果可观察、可判断对错 | 核对步骤与结果的对应关系 |
| 优先级 | 优先级按团队约定的档位填写,并与需求优先级或风险等级有对应说明 | 核对档位取值与对应规则 |
条目数量控制在团队能执行的范围内。条目越多,评审成本越高,执行率反而下降。可以先从标识、关联需求、步骤、预期结果四项起步,运行一段时间后再补充。
从需求到用例的编写步骤
编写步骤要说明输入、动作和输出,让作者按固定路径产出用例,也让评审人知道用例应当来自哪里:
- 输入需求条目:从需求池取出待覆盖的需求,确认需求已通过澄清,不存在待定项。输出是一份待编写用例的需求清单。
- 拆分测试场景:按业务路径、边界条件和异常分支列出场景,每个场景对应一条或一组用例。输出是场景清单。
- 按模板填写用例:套用统一模板填写要素,步骤与预期结果成对出现。输出是用例初稿。
- 作者自检:对照规范条目清单逐项勾选,修正明显缺项。输出是自检通过的用例,进入评审。
完成标志可以定为:需求清单中的每条需求都有对应用例,且每条用例通过自检清单的全部必检项。
评审流程怎么设计:分级、时点与结论
评审不必所有用例都开会。按用例的影响范围和变更性质分级,把评审资源放在高风险和基线相关的用例上,是流程能长期运转的关键。
分级评审的层级与适用条件
| 层级 | 适用条件 | 参与角色 | 方式 |
|---|---|---|---|
| 作者自检 | 全部用例,无例外 | 用例作者 | 对照清单逐项勾选 |
| 同行走查 | 常规功能用例、迭代内新增用例 | 作者与一名同行评审人 | 异步评审,书面反馈 |
| 正式评审 | 核心业务流程、跨系统交互、安全与资金相关用例,以及版本基线前的用例集 | 作者、测试负责人、需求方、规范负责人 | 会议评审或带结论的异步评审 |
小团队可以把同行走查与正式评审合并为一次评审,但自检环节不建议省略,它是成本最低的一道过滤。
评审时点
评审时点决定问题发现的早晚。建议固定在三个节点触发:用例初稿完成后进入同行走查;需求发生变更后,对受影响用例重新评审,范围限于变更涉及的场景;版本基线前对纳入本次发布的用例集做正式评审,确认覆盖完整、结论明确。
评审方式与结论类型
走查适合条目多、问题分散的常规用例;会议评审适合需要多方对业务理解达成一致的场景;异步评审适合跨地域或排期紧张的团队,但需要规定反馈时限,否则容易搁置。三种方式都应给出明确结论,结论只有三类:
- 通过:全部必检项满足,可直接进入用例库基线。
- 有条件通过:存在轻微问题,不影响用例使用,但需在约定期限内修正并记录。
- 退回:存在必检项缺失或预期结果不可判定等问题,修正后重新提交评审。
评审记录与留痕
每次评审至少记录:评审对象与版本、评审人与评审日期、逐条问题的位置与违反的规范条目、结论类型、整改责任人与期限。记录的作用不只是存档,它是后续统计问题分布、判断规范是否需要修订的数据来源。评审记录、问题整改与复评状态可以在工作项与文档流程中承载,使结论和整改进度可跟踪;具体承载方式按团队现有工具配置。
责任分工:作者、评审人、规范负责人各管什么
评审流于形式,常见原因是角色边界模糊:作者认为评审人会补全,评审人认为规范负责人会裁定,结果问题在环节之间来回传递。用一张职责表把动作、输出和时点固定下来,可以减少这类空转。
| 角色 | 主要动作 | 输出 | 时点 |
|---|---|---|---|
| 用例作者 | 按模板编写用例,对照清单完成自检,响应评审意见并整改 | 用例初稿、自检记录、整改后的用例 | 初稿完成时、收到评审意见后 |
| 同行评审人 | 按规范条目逐项检查,指出问题位置与违反条目,给出结论建议 | 评审意见清单 | 初稿提交后约定时限内 |
| 规范负责人或评审主持人 | 组织正式评审,对争议条目作出裁定,维护规范条目与模板,统计问题分布 | 评审结论、裁定记录、规范修订 | 正式评审时、周期性复盘时 |
| 需求方 | 确认用例覆盖的业务场景与预期结果是否符合需求意图 | 覆盖确认意见 | 正式评审时 |
| 测试执行方 | 从可执行角度反馈步骤是否可操作、预期结果是否可判断 | 可执行性反馈 | 同行走查或正式评审时 |
几条边界需要写清楚:评审人只对规范条目的符合性负责,不对需求本身的正确性作判断,需求内容的判断归需求分析与澄清环节;作者不能评审自己编写的用例;当评审人与作者存在直接汇报或共同交付关系、可能影响判断时,应更换评审人。争议条目由规范负责人裁定,裁定结果记录在案,作为后续同类问题的处理依据。
不合规用例的修正机制:从问题到关闭
评审给出“退回”只是开始。修正机制要保证每个问题都有责任人、有期限、有复评,最终有明确的关闭状态。
问题分级与整改时限
| 级别 | 典型问题 | 整改时限 | 复评方式 |
|---|---|---|---|
| 严重 | 缺少预期结果、步骤无法执行、未关联需求 | 下一个工作日内 | 原评审人复评,通过后方可进入基线 |
| 一般 | 前置条件不完整、输入数据无具体值、优先级档位错误 | 三个工作日内 | 原评审人或指定复评人确认 |
| 轻微 | 表述冗余、格式不统一 | 随下次修改一并处理 | 抽查确认 |
时限按团队节奏调整,关键是每个级别都有明确期限,且期限与版本基线时间不冲突。
整改与复评的触发条件
问题记录应包含用例位置、违反的规范条目、级别、责任人和期限。作者完成修改后,将问题状态更新为“待复评”,复评由原评审人执行;原评审人不可用时,由规范负责人指定复评人。复评只核对问题是否消除以及是否引入新问题,通过后关闭,未通过则退回并重新计时。
反复不合规的处理
同一作者或同一模块在连续两个评审周期内出现同类严重问题,先做针对性辅导,由规范负责人结合具体用例讲解条目要求;辅导后仍反复出现,再检查规范条目本身是否表述不清或与业务实际不符,必要时修订条目并同步更新模板。把问题按作者和模块统计,能区分是个人执行问题还是规范设计问题,避免一律归因于作者。
修正记录如何回写规范
周期性汇总评审问题,按违反条目归类。某一类问题持续高发,说明该条目要么难以执行,要么缺少配套模板或示例,应优先修订条目或补充示例,而不是反复要求作者注意。修订后的规范需要通知到所有作者和评审人,并在下一次评审中按新条目执行。
示例:一条不合规用例的完整处理过程
以下为演示情景,不对应真实项目数据。
问题表现:某条“订单取消”用例的步骤写着“用户取消订单,系统处理”,预期结果只写“取消成功”。同行走查时,评审人对照规范条目发现三处问题:步骤包含多个动作且无具体输入,预期结果不可判断对错,用例未关联对应的需求条目。结论为退回,问题级别定为严重。
整改要求:评审意见记录了三处问题的位置和违反的条目,责任人为用例作者,期限为下一个工作日。要求拆分为“进入订单详情—点击取消—选择取消原因—确认提交”等单动作步骤,预期结果写明订单状态变化和页面提示内容,并补上需求关联。
复评与关闭:作者修改后提交复评,原评审人核对三处问题均已消除,步骤可试走,预期结果可判断,结论改为通过,问题状态关闭。该用例随后纳入版本基线。
对规范的反馈:复盘时发现同类“步骤合并多个动作”的问题在该模块多次出现,规范负责人据此在模板中增加步骤拆分的填写示例,并在下一次评审前向作者做了简短说明。这条用例的处理过程由此转化为规范改进的输入。
完成检查:机制是否真正运转
机制建立后,需要定期用可核验的指标判断它是否在执行,而不是只看规范文档是否存在。
- 评审覆盖率:纳入基线的用例中,有评审记录的比例;正式评审是否覆盖了核心业务与高风险用例。
- 评审及时性:从用例提交到给出结论的平均时长,是否在约定时限内;退回后重新提交的间隔是否超期。
- 问题关闭率:已记录问题的关闭比例,超期未关闭问题的数量与分布。
- 反复问题:同一作者或模块连续出现同类严重问题的次数,是否已触发辅导或规范修订。
- 规范更新与培训:规范修订后是否通知到全部作者与评审人,新增成员是否在首次提交用例前接受过条目说明。
如果评审覆盖率长期偏低,先检查评审时点是否与迭代节奏冲突;如果问题关闭率低,检查整改时限是否合理、复评人是否明确;如果同类问题反复出现,优先修订规范条目和模板,再考虑加强辅导。检查结果应形成下一周期的调整动作,让机制随团队实际情况持续校准。
常见问题
用例评审应该由谁发起,评审人怎么指派?
通常由用例作者在初稿完成并自检通过后发起评审,评审人由规范负责人或测试负责人按用例所属模块指派。指派时需要考虑两点:评审人应熟悉该模块的业务场景,且与作者不存在直接汇报或共同交付关系,以免影响判断。正式评审还需要邀请需求方确认业务覆盖、测试执行方反馈可执行性。评审人不可用时,由规范负责人指定替代人选,避免评审在等待中搁置。
需求变更后,已经评审通过的用例需要重新评审吗?
需要,但范围可以限定在变更涉及的场景。建议在需求变更确认后,由作者标记受影响的用例,重新走同行走查;如果变更涉及核心业务流程或跨系统交互,则升级为正式评审。重新评审时重点核对三件事:用例覆盖是否仍与需求一致、预期结果是否随需求调整、是否新增了需要覆盖的异常分支。未受影响的用例不必重复评审,以控制评审成本。
小团队人手有限,评审流程可以简化到什么程度?
可以把同行走查与正式评审合并为一次评审,但作者自检环节建议保留,它是成本最低的一道过滤。合并后仍需明确三件事:评审由谁组织、按什么清单检查、给出哪类结论。对于常规功能用例,可以采用异步评审并规定反馈时限;对于核心业务和高风险用例,保留一次带结论的会议评审。流程简化后,评审记录仍要保留,否则后续无法统计问题分布和判断规范是否需要修订。
评审发现的问题应该记录在哪里,才能保证整改不遗漏?
问题记录至少包含用例位置、违反的规范条目、严重级别、责任人和整改期限,并设置待整改、待复评、已关闭等状态。记录可以放在团队现有的工作项或文档流程中,让每条问题对应一个可跟踪的条目,复评时逐条核对。ONES 测试管理支持用例库的组织管理、自定义属性以及缺陷的一键创建与关联,团队可以按实际配置把评审问题与用例、需求关联起来;具体字段和流转方式需按实际环境确认。
同一类不合规问题反复出现,应该先处理人还是先改规范?
先用数据区分问题来源。按作者和模块统计问题分布,如果集中在个别作者,先做针对性辅导,结合具体用例讲解条目要求;如果同类问题在多个作者或多个模块普遍出现,更可能是规范条目表述不清、缺少模板或示例,应优先修订条目并补充填写示例。辅导后仍反复出现严重问题的,再检查规范与业务实际是否匹配。修订后的规范要通知到全部作者和评审人,并在下一次评审中按新条目执行。



