缺陷分诊记录需要保留哪些信息:字段清单与填写方法

缺陷分诊记录要保留四类信息:缺陷标识与来源、受理判断依据、分诊结论与责任归属、后续跟踪所需的变更痕迹。记录的目标是让未参与分诊的人也能还原“为什么这样定级、为什么派给这个人、下一步谁在什么时间做什么”。本文给出字段清单、逐项填写方法、角色分工、完整示例和合格检查表,适用于缺陷受理决策环节。



要点总览(TL;DR)


  • 缺陷分诊记录按四组信息组织:缺陷标识与来源、受理判断依据、分诊结论与责任归属、跟踪痕迹;缺一组就难以复核。
  • 影响定级、定责和时限的字段设为必填,包括缺陷编号与标题、环境版本、复现步骤与影响范围、严重度与优先级及理由、分诊人与时间、责任模块与责任人、结论及理由;协办人、计划修复版本、关联项按条件填写。
  • 提交者提供可复现信息,分诊人负责定级定责与结论记录,模块负责人确认接收或提出异议,记录维护方检查完整性并督促补充;转派、重新定级、时限调整以追加方式留痕,不覆盖历史结论。
  • 分诊完成时按检查表逐项核对,信息不完整、无法复现、定级理由缺失、责任人不明、结论无理由或变更未留痕均属阻断项,退回补充后再进入修复排期。


分诊记录先回答哪四个问题


分诊记录按四组信息组织,每组回答一个具体问题。字段数量可以随团队规模调整,四组信息缺一组,记录就难以被复核。


信息组 回答的问题 典型字段 填写要求
缺陷标识与来源 这是哪个缺陷,从哪里来,在什么环境出现 缺陷编号、标题、来源渠道、发现环境与版本、提交人、提交时间 必填
受理判断依据 凭什么判断它严重、紧急、需要修复 复现步骤、实际结果、期望结果、影响范围、严重度、优先级及判定理由 必填
分诊结论与责任归属 受理还是驳回,由谁负责,何时修复 分诊结论、结论理由、责任模块、责任人、协办人、分诊人、分诊时间、计划修复版本与时限 结论、理由、责任人、分诊人及时间为必填;协办人、计划修复版本按条件填写
跟踪痕迹 分诊之后发生了什么变化 关联需求或缺陷、状态变更记录、转派记录、补充信息记录 状态与责任变更必留痕;关联项按条件填写

必填与条件填写的划分依据是“缺少后是否影响复核”。影响定级、定责和时限判断的字段设为必填;只在特定情形下才存在的字段,如多人协作时的协办人、已排期后的计划修复版本,按条件填写。团队可以在项目配置中把必填项设为提交或流转的校验条件,减少事后补录。



逐字段填写:从缺陷标识到责任归属


下表把四组框架落到具体字段,每个字段说明输入来源、填写动作和合格标准。填写时以“他人能否据此复核”为尺度,不以字数多少为标准。


字段 输入来源 填写动作 合格标准
缺陷编号 系统生成 提交时自动生成,不在标题或正文中手工改写 唯一、可检索,与其他记录引用时保持一致
标题 提交者 用“模块+现象+条件”概括,如“订单页提交后金额显示为0(使用优惠券时)” 不看正文也能判断大致问题,避免“有问题”“报错”一类标题
来源渠道 提交者或系统 标注来自测试执行、用户反馈、线上监控、内部试用等 能区分问题发现场景,便于判断影响面
发现环境与版本 提交者 写明环境类型(开发、测试、预发、生产)、应用版本、必要的设备与浏览器信息 他人可按同样条件复现;生产问题注明影响版本范围
复现步骤 提交者 按操作顺序编号,每步写清操作对象和输入数据 按步骤操作能得到相同结果;偶现问题注明出现频率和尝试次数
实际结果与期望结果 提交者 分别描述观察到什么、按需求应是什么 两者形成明确差异,期望结果有需求或设计依据
影响范围 提交者与分诊人共同补充 写明受影响的功能、用户群体、数据范围,以及是否有临时规避方案 能支撑严重度判断,如“全部新用户无法完成注册,无规避方案”
严重度 分诊人 按团队定义选择等级,并在记录中写明判定理由 理由包含影响用户范围、是否阻断主流程、有无规避方案等具体事实
优先级 分诊人,必要时与模块负责人协商 结合严重度、业务节点、修复成本确定,并写明依据 能解释为何与严重度一致或不同,如“严重度高但已有规避方案,优先级降为中”
责任模块 分诊人 定位到具体功能模块或服务,不停留在“前端”“后端”层面 模块划分与团队代码或服务归属一致
责任人 分诊人指定或模块负责人指派 填写具体人员,并确认其已知晓 责任人为实际处理人,非仅挂名;接收动作有记录
协办人 分诊人或责任人 涉及跨模块协作时填写,注明协作内容 协办事项具体,如“提供接口日志”“确认数据口径”
分诊人与分诊时间 分诊人 完成定级定责后填写,时间精确到日 可与提交时间区分,便于统计分诊时效
分诊结论及理由 分诊人 从受理、驳回、转派、待补充信息中选择,并写明理由 理由指向具体依据;驳回与待补充信息须写明下一步由谁在何时处理
计划修复版本与时限 分诊人或模块负责人 排期确定后填写版本号与目标日期 与迭代计划一致;未排期时注明“待排期”及预计排期时间
关联需求或缺陷 分诊人或提交者 关联对应需求、测试用例或重复缺陷 重复缺陷指向主缺陷编号,避免多头跟踪

结论写法上,四类结论各有要求。受理需写明定级与责任人;驳回需说明不属于缺陷、无法复现或重复的具体理由;转派需记录转出与转入的模块和人员;待补充信息需列出缺什么信息、由谁补充、截止时间。只写“已处理”“转研发”这类结论,无法支撑后续复核。



角色分工:谁填、谁确认、谁维护


分诊记录的质量取决于提交、分诊、接收三个环节的交接是否清楚。每个角色对记录承担不同责任,交接点要有明确的完成标志。


角色 关键动作 交付物 完成标志
提交者 提供可复现的步骤、实际与期望结果、环境版本和影响线索 信息完整的缺陷提交 他人按步骤可复现,或已注明偶现频率
分诊人 核实信息、判定严重度与优先级、定位责任模块、指定责任人、记录结论与理由 分诊结论与定级定责记录 结论、理由、责任人、分诊时间均已填写
模块负责人 确认接收或提出异议,安排修复版本与时限 接收确认或异议说明 接收动作有记录;异议时给出重新分诊的依据
责任人 处理缺陷,更新状态与修复信息 修复记录与状态更新 状态变更与修复说明可追溯
记录维护方(通常为测试或质量角色) 检查字段完整性,督促补充信息,维护变更留痕规则 定期检查结果与补录记录 检查发现的问题有跟进闭环

变更留痕的责任归属需要事先约定:谁修改谁追加,历史结论不覆盖。转派、重新定级、时限调整都以追加记录的方式写入同一条缺陷,保留原结论和调整理由。这样在复盘分诊质量时,能看到判断变化的过程,而不只是最终状态。


当团队使用 ONES 承载缺陷流程时,分诊记录可以落在缺陷工作项的字段、责任人和状态流转上。ONES Project 支持缺陷跟踪管理,与 TestCase 数据互通并可一键提 Bug,支持一键提交 Bug 至对应项目或迭代中记录和跟踪修复情况;ONES TestCase 支持未通过的用例快速创建缺陷任务,使缺陷在测试与研发团队间流转。分诊所需的字段配置需按团队流程在项目中自定义,具体可配置范围以实际版本为准。



一条完整的分诊记录示例


以下为演示情景,用于说明字段如何组合,非真实案例。


背景与原始提交:测试人员在预发环境执行“优惠券下单”用例时发现,使用满减券提交订单后,订单金额显示为原价。缺陷标题为“订单确认页使用满减券后金额未扣减(预发环境)”,来源渠道为测试执行,发现环境为预发环境、应用版本 V3.2.0,复现步骤为:登录测试账号→加入两件商品→选择满100减20券→提交订单→查看订单确认页金额。实际结果为显示原价180元,期望结果为160元。提交者注明该问题在近三次执行中均出现。


分诊判断过程:分诊人核实复现步骤后确认问题稳定出现,影响范围为所有使用满减券的订单,主流程可继续提交但金额错误,存在资损风险,暂无规避方案。据此定为严重度高;结合本周有营销活动上线,优先级定为高。判定理由写入记录:影响全部用券订单、涉及金额准确性、无临时规避方案、临近活动节点。


责任分配与计划:责任模块定为“订单计价服务”,责任人指定为该模块开发人员,协办人为优惠券服务接口负责人,协作内容为确认券金额计算口径。分诊结论为受理,计划修复版本 V3.2.1,时限为活动上线前两个工作日。关联需求为“满减券营销活动”,关联测试用例为“优惠券下单校验”。


后续变更追加:次日优惠券服务确认口径无误,协办人记录追加“券面金额计算正确,问题在订单侧汇总逻辑”。责任人将状态更新为修复中,并追加修复说明。修复完成后追加验证结果与关闭记录。原分诊结论、定级理由和时限均保留,调整时限时另起一条追加记录说明原因。



完成检查:分诊记录是否合格


分诊完成时按下表逐项核对。任一阻断项不通过,记录退回补充,不进入修复排期。


检查类别 检查项 是否阻断
信息完整性 缺陷编号、标题、来源渠道、发现环境与版本齐全 是
信息完整性 复现步骤、实际结果、期望结果、影响范围可支撑判断 是
判断依据可复核 严重度与优先级均有判定理由,理由含具体事实 是
判断依据可复核 他人按记录可复现问题,或偶现频率已注明 是
责任与时限 责任模块与责任人明确,责任人已确认接收 是
责任与时限 分诊人与分诊时间已填写 是
责任与时限 计划修复版本与时限明确,或注明待排期及预计排期时间 否,但需有跟进记录
结论规范 结论属于受理、驳回、转派、待补充信息之一,并附理由 是
结论规范 驳回与待补充信息写明下一步由谁在何时处理 是
变更留痕 转派、重新定级、时限调整以追加方式记录,历史结论未被覆盖 是
变更留痕 重复缺陷已关联主缺陷编号 否,但需在关闭前补齐

不通过时的处理方式按阻断程度区分:信息不完整或无法复现的,退回提交者补充,记录保持“待补充信息”状态并注明截止时间;定级理由缺失或责任人不明的,退回分诊人重新判断;责任人提出异议的,由模块负责人组织重新分诊,原结论保留并追加新结论。检查结果本身也建议留一条记录,便于统计分诊返工情况,持续改进字段规范。



常见问题


缺陷提交时信息不全,分诊人可以先定级再让提交者补充吗?


可以,但记录要体现这个顺序。分诊人先按现有信息给出初步判断时,结论应记为“待补充信息”,写明缺哪些信息、由谁补充、截止时间,并保留初步定级及其依据。补充完成后追加正式结论,原记录不覆盖。若缺失的是复现步骤或环境版本这类直接影响判断的信息,建议先退回补充,避免基于不完整信息定责。


严重度和优先级由分诊人定,模块负责人有不同意见怎么办?


由模块负责人提出异议并给出依据,分诊人组织重新分诊,原结论保留,新结论以追加方式写入同一条记录。异议理由应指向具体事实,例如影响范围判断不同、已有规避方案、修复成本与排期冲突。重新分诊后同步更新责任人和计划修复版本,避免记录里同时存在两套有效结论。


驳回的缺陷还需要保留完整分诊记录吗?


需要。驳回同样是一次受理决策,记录应包含驳回理由(不属于缺陷、无法复现、重复等)、判断依据和下一步安排。无法复现的注明尝试次数与环境;重复的关联主缺陷编号;不属于缺陷的说明应转往何处。缺少这些信息,后续同类问题再次提交时无法判断是否已处理过。


分诊记录里的变更痕迹要记到什么程度?


以“能看出判断变化的过程”为准。转派记录转出与转入的模块和人员,重新定级记录新等级与调整理由,时限调整记录原时限、新时限和原因。每次变更以追加方式写入,保留原结论和时间。只保留最终状态、不保留调整过程的记录,在复盘分诊质量时无法区分判断失误与情况变化。


团队用工具承载分诊记录时,字段配置要注意什么?


把必填字段设为提交或流转的校验条件,减少事后补录;分诊人、分诊时间、结论理由这类字段单独配置,便于统计分诊时效和返工情况。使用 ONES 时,分诊记录可以落在缺陷工作项的字段、责任人和状态流转上,ONES Project 支持缺陷跟踪管理,与 TestCase 数据互通并可一键提 Bug;具体字段配置需按团队流程在项目中自定义,可配置范围以实际版本为准。