| name | audit-report |
| description | 报告审查维度 RA-1~RA-6 — 分析报告/审查报告质量专属审查层 |
Audit Report Skill
适用范围
审查目标为报告文档(分析报告、审查报告、开发报告、修复报告)时,叠加本 Skill(在 G1~G5 之后)。
维度总览(RA-1~RA-6)
| 分组 | 维度 | 优先级 |
|---|
| A — 内容质量 | RA-1 内容完整性 · RA-2 事实准确性 | 🔴 |
| B — 格式与追溯 | RA-3 格式规范性 · RA-4 结论可追溯 | 🟡/🔴 |
| C — 行动与关联 | RA-5 行动项可执行 · RA-6 关联一致性 | 🟡/🔴 |
核心检查维度
RA-1 内容完整性 🔴
- 报告头部必填字段完整(项目/日期/类型/状态)
- 正文必需章节齐全(参照对应模板)
- 无空白章节或仅含"TBD"/"待填写"
- audit 类报告包含审查轮次摘要(🔴 必填)
- 问题清单包含完整列(级别/维度/位置/描述/已验证/发现轮次/状态)
- 汇总型问题清单默认采用“两层结构”:先列根因级问题,再展开逐文件完整落点;边界/非缺陷结论单列,不混入缺陷编号
RA-2 事实准确性 🔴
- 结论有证据支撑(引用文件/终端输出/工具结果)
- 问题描述有具体位置(文件名+行号或章节标题)
- 无无法验证的断言
- 若报告把外部审查报告、AI review finding 或 audit issue 作为输入,需检查
ReviewFindingIntakeGate:报告是否仅作为线索、每条 finding 是否有本地证据和分类、是否误把设计/文档/测试缺口写成 must-fix runtime bug
RA-4 结论可追溯 🔴
- 每条结论可追溯到具体证据
- 问题状态准确(已修复的标注已验证轮次)
- 若存在“根因级归并”,必须能从根因项反查到逐文件落点,避免在汇总阶段吞掉文件级异常
ExternalReviewClaimVerificationGate(PF-164 · 外部审阅复核)
当报告是对外部审阅 / 他 Agent 审阅 / AI review finding 包的复核或转写时(不仅是普通 audit),必须额外满足主张级颗粒度,禁止“总评正确但比输入更难定位”:
| 必填 | 说明 |
|---|
inputClaims | 外部输入主张列表(可编号) |
ClaimVerificationMatrix | 主张 → 项目证据 → verificationStatus → disposition(采纳/部分采纳/拒绝) |
projectEvidence | repo path / 命令 / 运行结果,不得只复述外部原文 |
unverifiedBoundaries | 未验证/UNVERIFIED 边界与推断边界 |
detailReportLink | 用户可打开的详细报告链接(最终回复不得只有口头总评) |
EscapeAbsorptionQueue | 外部 finding → 本地证据 → disposition → 目标产物 / owner / status |
EvidenceFreshness | 对采纳、拒绝、已验证、可确认等 strong claim 记录 StaleEvidenceLintDecisionV1.status/mode;外部原文和历史报告只能是 hint |
- 机器分类:
scripts/lib/external-review-claim-verification.js(claim-ready / claim-thin / not-external-review)
- 证据新鲜度分类:
scripts/lib/evidence-freshness-receipt.js(ClaimEvidenceIndexV1 / EvidenceFreshnessReceiptV1 / StaleEvidenceLintDecisionV1),生产入口 npm run test:evidence-freshness
- 负向:只写总评/建议、无矩阵、无 UNVERIFIED、无详细报告链接 →
claim-thin,审查不通过
- 负向:把外部审查 finding 直接并入需求或技术方案,没有
EscapeAbsorptionQueue、本地证据、disposition 和 freshness decision → 审查不通过
- 非外部审阅场景:
N/A + skipReason=not-external-review-recap
N/A 规则
- 纯信息性报告无行动项:RA-5 标 N/A
- 无关联外部文件:RA-6 标 N/A
- 非外部审阅复核:
ExternalReviewClaimVerificationGate 标 N/A