---
name: Audit Report
slug: audit-report
category: Writing
description: Audit Report reviews report documents for completeness, factual accuracy, traceability, and actionable findings. Use it when auditing analysis, review, development, or fix reports, especially external review recaps.
github: "https://github.com/devcodex-labs/devcodex/tree/main/content/skills/audit-report"
language: JavaScript
stars: 202
forks: 26
install: "npx degit https://github.com/devcodex-labs/devcodex/tree/main/content/skills/audit-report ~/.claude/skills/audit-report"
installs_to: ~/.claude/skills/audit-report
source_path: content/skills/audit-report/SKILL.md
collection_size: 25
category_size: 1227
collection_url: "https://dirskills.com/collections/devcodex-labs/devcodex"
added: 2026-09-05T05:30:20.673Z
last_synced: 2026-09-05T05:30:20.673Z
canonical_url: "https://dirskills.com/skills/audit-report"
---

# Audit Report

Audit Report reviews report documents for completeness, factual accuracy, traceability, and actionable findings. Use it when auditing analysis, review, development, or fix reports, especially external review recaps.

**Install:**

```bash
npx degit https://github.com/devcodex-labs/devcodex/tree/main/content/skills/audit-report ~/.claude/skills/audit-report
```

## README

# 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