audit-report · git:20260730.6ee304a · 2026-07-30 · sha256 38d5589b0648d0ae
audit-report git:20260730.6ee304aA
Immutable. This exact content is served forever at /api/v1/blob/38d5589b0648d0ae.
--- 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