修复验证与防复发模板

字段	值
版本	v1.0
最后更新	2026-07
使用时机	问题修复后回归验证和沉淀时
填写角色	修复 Owner+评测工程师
下游消费者	Regression Set、发布门禁

适用场景

用于将 Bad Case 修复动作转化为可验证、可回归、可防复发的长期资产。

字段说明

字段	说明
source_bad_case_id	来源 Bad Case 标识
root_cause	已确认的主根因
contributing_factors	贡献因素和暴露条件
evidence_level	E0—E4 归因证据成熟度
evidence_strength	高、中、低会诊治理标签及其依据
falsification_check	可能推翻当前根因的反证和尚需验证项
fix_actions	分层修复动作、动作 Owner 和预期证据
regression_scope	必跑回归范围
release_path	热修、灰度、常规发布或回滚
verification_evidence	修复完成所需证据
regression_admission	Regression Case 的 R 级复用审核、Rubric 和审批状态
prevention_assets	Regression Case、Gate、Watch Metric 和 Runbook
review_cycle	修复关闭后的复查周期

本模板对应第 22 章修复工单与防复发流程，并沿用第 19.4.1 节的通用治理字段。只有根因已有证据、问题进入修复执行时才创建本记录。

release_path 只记录计划采用的修复交付路径，不构成发布授权；Gate Result 通过后，仍需由第 19 章责任流程记录独立发布决定。

模板

fix_record:
  record_id:
  record_type: remediation
  source_id:
  source_bad_case_id:
  root_cause:
  contributing_factors:
  evidence_level:
  evidence_strength:
  falsification_check:
  affected_scope:
  fix_actions:
    - action:
      layer:
      owner:
      evidence:
  regression_scope:
    -
  release_path:
  verification_evidence:
    -
  verification:
    original_case:
    same_cluster_cases:
    adjacent_cases:
    regression_set:
    online_gray:
  regression_admission:
    reuse_readiness:
    rubric_status:
    review_status:
  prevention_assets:
    regression_case:
    gate_rule:
    watch_metric:
    runbook:
  owner:
  deadline:
  status:
  evidence_links: []
  created_at:
  updated_at:
  review_cycle:

填写示例

以下日期、样本数、观察时长和结果均为字段填写示例，不代表真实项目成效或通用关闭阈值。

fix_record:
  record_id: fix_refund_policy_20260708_001
  record_type: remediation
  source_id: incident_refund_policy_20260708
  source_bad_case_id: bc_refund_policy_20260708_001
  root_cause: RAG Query 未召回会员积分扣回规则
  contributing_factors: Agent 未在金额权益场景强制调用退款规则工具
  evidence_level: E4
  evidence_strength: high_governance_label
  falsification_check: 若原 Query 已稳定召回正确规则，则重新检查上下文构造、Prompt 和生成忠实性
  affected_scope: 会员部分退款、refund_agent_v12、P1
  fix_actions:
    - action: 增加 Query 实体扩展
      layer: RAG
      owner: rag_engineer
      evidence: Recall@5 恢复
    - action: 金额权益问题强制调用退款规则工具
      layer: Agent
      owner: agent_engineer
      evidence: Trace Case 通过
  regression_scope:
    - 原失败样本与同簇样本
    - 退款 Regression Set
    - 高风险工具与安全样本
  release_path: 限定场景灰度
  verification_evidence:
    - 评测 Run 报告
    - Trace 回放
    - 48 小时线上观察
  verification:
    original_case: pass
    same_cluster_cases: 25/27 pass；2 条残余失败待归因和处置
    adjacent_cases: pass
    regression_set: pass
    online_gray: 48h 稳定
  regression_admission:
    reuse_readiness: R4
    rubric_status: complete
    review_status: approved
  prevention_assets:
    regression_case: reg_refund_member_partial_001
    gate_rule: refund_policy_high_risk_gate
    watch_metric: refund_policy_error_rate
    runbook: refund_policy_diagnosis_runbook
  owner: ai_quality_refund
  deadline: 2026-07-12
  status: verifying
  evidence_links: [run_refund_fix_001, report_refund_gray_001]
  created_at: 2026-07-08
  updated_at: 2026-07-10
  review_cycle: monthly

常见误区

误区	修正方式
只验证原失败样本	同时验证同簇样本、相邻场景和回归集
修复后不沉淀资产	建立 Regression Case、Gate、Watch Metric 和 Runbook
没有线上验证	灰度观察相关线上指标
责任不清	每个动作绑定 Owner