用途:在 commit、push 或创建 PR 前进行部署前终极验证,把测试质量、覆盖率、风险、验收标准(AC)可追溯性聚合为单一置信指数(0-100),判断 PR 是否就绪。它只做审计与报告,不修改代码,也不执行 git add、git commit、git push。
主要能力:按五个维度打分——执行完整性 25%、覆盖率充分性 25%、测试质量 20%、风险与测试对齐 20%、证据治理 10%。支持 --mode fast|deep 控制深度(默认 fast)、--strict 在 PR-Blocked 时返回非零退出码、--json 输出机器可读结果、--base <ref> 指定比较基准(默认 HEAD)。工作流分四阶段:收集(读取 precommit 门禁状态、调用 /risk-assess、检测变更文件并映射测试)、定向检查(对高风险模块运行 /codex-test-review,deep 模式额外做覆盖率与 AC 追溯)、聚合、输出报告与置信指数。模块选择基于 /risk-assess 的 top_affected,按 dependent_count 降序、file 升序稳定排序,fast 取 top-3、deep 取 top-10 并补充变更文件。
评分与门禁:检查项 pass=1、partial=0.5、fail=0、N/A 排除;维度分为适用项求和/数量×100;原始分为加权平均(N/A 维度排除并重新归一),再乘证据置信上限(1.0/0.9/0.75/0.6),最终取整。门禁分三档:>=85 为 PR-Ready,60-84 为 PR-Caution,<60 为 PR-Blocked。硬失败可无视分数强制 PR-Blocked,例如 precommit 在最新编辑后未通过、被禁止领域使用人工例外、例外超限、例外过期、原因类别不合法、例外未经 Codex VALID_EXCEPTION 验证、证据 HEAD SHA 与当前 HEAD 不一致、高风险文件零覆盖等。
适用场景:提交前最终自查、评估 PR 就绪度、评估测试质量与风险。不适用场景:需要代码评审可用 /codex-review-fast,部署后运行时验证用 /feature-verify,周期性项目体检用 /project-audit,只跑测试用 /verify,只查风险用 /risk-assess。
使用与限制:命令形如 /pre-pr-audit [--mode fast|deep];A2 的 /risk-assess 必须前台阻塞完成,A1、A3 可作为后台 Agent 并行。依赖 scripts/review-state.js(或已安装副本 .claude/scripts/review-state.js);若检查器缺失,报告为“无判定来源”,绝不视为通过。具体证据模型与例外策略见 @rules/testing.md,公式与输出模板见 references/scoring-model.md 与 references/output-template.md。
其余细节暂未提供。