Repair Prevention Assessment
职责
本 Skill 是所有 repair task 的稳定、默认部署完成门禁,唯一拥有 RepairPreventionAssessmentGate 与 RepairPreventionAssessmentV1。它判断当前问题能否关闭,并要求为长期控制给出诚实的前瞻计划;不负责计算返工率、验证控制长期有效或自动晋级候选,这些试验性职责归 gray rework-prevention-engineering。
机器结构以 repair-prevention-assessment.schema.json 为准,确定性判定以 scripts/lib/repair-prevention-assessment.js 为准。其他 Skill、Prompt、报告与清单只能引用本 Owner,不复制字段定义。
RepairPreventionAssessmentGate
任何 repair——包括 fix、dev 中的修复切片、self-fix、审查 finding 修复与发布阻断修复——在 accepted 前必须形成有效 RepairPreventionAssessmentV1。当前修复重跑只允许进入 immediateClosureEvidence,不得写成长期 prevention 已有效。
双根因与证据
| 字段 | 要求 |
|---|---|
defectRootCause | 缺陷、遗漏或错误判断本身为什么发生 |
controlFailure | 哪个需求、方案、实现、测试、复审或发布控制应拦截却未拦截 |
escapedFrom / detectedAt | 应发现阶段与真实发现阶段 |
regressionSeeds / negativeCases | 当前回归输入与能证明控制边界的负例 |
controlOwner / consumers | 控制真相源、执行消费者与验证消费者 |
immediateClosureEvidence | 当前 repair 的 fresh 关闭证据 |
prospectiveEvidencePlan | 后续可比较 WorkUnit、独立上下文、指标防作弊与回滚准备 |
rollbackOrSunset | 误报、成本或无效时的回退与退役条件 |
风险模式
- 低/普通风险首次 repair 可使用
mode=light,但双根因、回归 seed、负例、当前关闭证据与 rollback/sunset 仍不可缺。 - P0/P1、安全、控制面、公共契约、发布、多批次、角色交接、
high/critical或 repeat escape 必须mode=full,追加whyMissed / authorizationEvidence / independentReReviewPlan。 - repeat escape 不得选择
no-new-control或只恢复说明文案;必须使用new-control-provisional,紧急高风险才允许emergency-active。
preventionDecision
| 决策 | 使用条件 | 生命周期结论 |
|---|---|---|
existing-control-restored | 已有 active 控制因接线或执行偏差未生效 | 保持既有控制;本次重跑不重新证明效果 |
new-control-provisional | 新增或实质修改 prompt/contract/checklist/probe/test/hook/tool | 新控制保持 gray/provisional,等待前瞻证据 |
no-new-control | 已有控制足够、一次性不可泛化、成本高于风险或无更早发现点 | 必须使用标准 reason 与独立 evidence |
emergency-active | P0、安全或高风险控制面必须先阻断 | active-expiring;必须有明确授权、补证与回退 |
prospectiveEvidencePlan.status=sufficient 只有在不少于 3 个可比 WorkUnit 或 2 个独立上下文、metricGaming=false 且 rollbackReady=true 时有效。当前事件唯一重跑必须保持 retrospective-only。
与 gray 返工工程的边界
- 本 Skill 始终处理“当前 repair 能否 accepted”,属于 active correctness gate。
- 只有用户或任务涉及返工率、一次通过率、重复逃逸簇、whyMissed 复发、PreventionHitRate 或长期效果判定时,才额外选择 gray
rework-prevention-engineering。 - active workflow 不得把 gray Skill 作为 mandatory dependency。gray 不可用时,本 Skill 仍须完整执行,不允许跳过 assessment。
验证与失败语义
最小验证:node scripts/test-repair-prevention-assessment.js,并由 V94、review checklist、report 与默认安装 replay 复证。以下任一情况阻断 accepted:
- assessment 缺失、schema/identity 无效或风险模式不足;
- immediate closure 与 prospective evidence 混写;
- repeat escape 继续使用旧说明文字或无理由
no-new-control; - active consumer 强依赖默认不部署的 gray Skill;
- mandatory Skill 未进入默认部署面;
- rollback/sunset 或独立复审计划缺失。
反模式
- 用“测试通过”同时证明当前修复与长期有效。
- 为降低返工指标而隐藏 finding、缩小 WorkUnit 或把返工改名为计划迭代。
- 把所有低风险 repair 扩大为完整事故报告。
- 为避免生命周期拆分而无证据晋级 gray Skill。


