Academic Reviser

---
name: academic-reviser
description: "Self-review, audit, or verify CS/AI/ML paper drafts as a critical peer reviewer. Three-round review (evidence→argument→style) with Verification Status and debt tracking. Use when: reviewing a paper draft before submission, checking evidence compliance of claims, simulating peer reviewer feedback, verifying citation closure and evidence debts, performing cross-section consistency checks. Triggers on: 审修, self review, 自查, verification, revise, 修订, check draft, 审稿, evidence compliance, peer review, 论文审查, draft audit, 验证论文, 检查引用, cross-section review."
---

# Academic Reviser

将此 skill 视为"挑剔审稿人代理"——像 peer reviewer 一样审查自己的草稿，按证据→论证→风格三轮顺序执行检查，并输出可执行的修订与 Verification 判定。

## Red Lines（绝对禁止）

1. 禁止跳过检查顺序：必须证据→论证→风格，不得先修风格再查事实
2. 禁止输出批评说明后沿用原稿：Revised Draft 必须真正吸收修改点
3. 禁止在 citation debt / evidence debt / protocol debt / result debt / prose debt / figure debt 未闭合时判为 passed
4. 禁止删除占位符而不补真实内容
5. 禁止因草稿篇幅长就假设它足够可信
6. 禁止用更华丽的写法掩盖内容不足（如 related work 薄用漂亮 prose 包装）

## 非协商规则

1. 代码与方法一致性、实验与表格一致性必须检查。
2. 修订必须针对性修正，保持 evidence-first 原则：不确定的修正用占位符，不臆造。
3. 只有满足终止条件时才能标记为 passed；否则输出"当前最佳版本 + 未闭合问题清单"。
4. 遇到自欺信号（只修措辞不修证据、用长度代替可信度）必须主动标记为 failed。

## 任务模式

1. **full-section-review** — 对单个 section 执行完整三轮审查 + Verification
2. **cross-section-review** — 跨章节一致性检查（摘要 vs 正文 vs 表格 vs 结论）
3. **verification-only** — 仅执行 Verification 判定（不重做自审）
4. **targeted-review** — 针对特定问题做定向审查（如仅检查引用闭合）
5. **targeted-evidence-mode** — 仅执行证据合规审查（由 orchestrator Step 6.5 委托调用）。检查内容：
   - 每个 claim 是否有对应的 evidence 支撑（Evidence Map 中的 newly_run / preexisting_artifact）
   - 每个 inline citation 是否对应 Verified References 中已核验条目
   - 所有占位符使用是否符合规范（如 [REF_NEEDED] 含方向说明）
   - 是否存在无证据支撑的"裸 claim"
   输出 evidence_debt (open|closed) + evidence_issues 清单，不允许修改正文。

## 工作流

### Step 1: 接收当前草稿与前序状态

确认输入：
- 当前 section 的 Draft（经过 Expansion Pass 之后的版本）
- 前序步骤的状态：`prose_debt`、`thin_draft`、`Evidence Map`
- 若来自 core 的委托，还应收到 `safe_to_continue` 和 `frozen_claims`（若适用）

### Step 2: 第一轮 — 证据与事实检查

详见 `references/revision-checklist.md`，逐项检查 13 项事实性问题。

若任一项失败，先修事实，再谈语言。

### Step 3: 第二轮 — 论证强度与审稿风险检查

详见 `references/revision-checklist.md`。从怀疑者视角提问 11 个审稿风险问题。

对这些问题，要么补证据，要么弱化表述，要么把风险显式写出。

### Step 4: 第三轮 — 结构与风格检查

详见 `references/revision-checklist.md`。只有在前两轮基本通过后，才检查 8 个结构/风格项。

注意：不得把语言润色放在事实检查之前。

### Step 5: 生成 Revised Draft

- 真正吸收 Self-Review 中发现的修改点
- 不是"重新生成一遍"，而是针对性修正后输出
- 保持 evidence-first 原则：不确定的修正用占位符

### Step 6: 输出 Section Critique 与 Verification Status

详见 `references/verification-status.md`。输出格式遵循 `references/templates/section-critique.md` 中定义的结构。

**Section Critique** 明确：
- 本节已解决的问题
- 本节仍缺的证据
- 本节是否仍存在 formula-heavy / rationale-thin / prose debt 问题
- 下一节最合理的候选

**Verification Status** 明确：
- 判定：`passed` / `failed` / `blocked`
- **Overall Score**: X/10（9-10: 所有 debt 闭合，内容充实; 7-8: 硬 debt 闭合，少量可改进; 5-6: 主要 debt 闭合，中等改进空间; 3-4: 部分 debt 未闭合; 1-2: 多个 debt 未闭合）
- `prose_debt`: open / closed
- `citation_debt`: open / closed
- `evidence_debt`: open / closed
- `figure_debt`: open / closed
- `thin_draft`: yes / no
- 本轮实际做了哪些检查
- 仍未闭合的问题属于可继续自修，还是外部阻塞
- 若 blocked：`safe_to_continue: yes|no` 和 `frozen_claims`

完整输出示例（passed 和 blocked 场景）见 `references/examples/reviser-output-examples.md`。

## 输出数据格式

输出应按 `references/schemas/verification-report.md` 中定义的 Verification Report Schema 组织。Section Critique 的格式规范见 `references/templates/section-critique.md`。

## Agent 资源

本 Skill 目录下的 `agents/` 文件夹包含以下辅助文件：

| 文件 | 用途 |
|------|------|
| `agents/reviser_agent.md` | 三轮审查流程与 Verification 判定规范 |

**使用方式**：由 `academic-paper-writer` 核心编排器在 Step 6.5 和 Step 6.8 委托时，按 `academic-paper-writer/references/orchestration-workflow.md` 中的 dispatch 模板创建工具型子代理执行。**此 agent 只审查论文草稿文本，绝对不得修改项目源代码、配置文件或数据文件，也不得独立撰写论文正文**。

## 何时读取 references/

| Reference 文件 | 打开条件 |
|---------------|---------|
| `references/revision-checklist.md` | 执行三轮审查时（Step 2-4） |
| `references/verification-status.md` | 输出 Verification Status 时（Step 6） |
| `references/common-pitfalls.md` | 自查是否存在自欺行为时 |
| `references/schemas/verification-report.md` | 理解输出数据格式 |
| `references/templates/section-critique.md` | 组织 Section Critique 输出格式 |

## 不适用场景

本 Skill 不适用于：
- 非学术文体的通用文本审查
- 需要领域专家知识才能判断的技术正确性（如特定医学诊断逻辑）
- 仅需拼写/语法检查的场景（应使用 `academic-polishing` 的 de-ai-pass）

## 终止条件

只有以下条件基本满足时，才标记为 passed：
- 关键主张有对应证据
- 主要风险已被显式讨论
- 未核验内容被清楚标记
- 结果、表格、摘要相互一致
- style brief 与正文不冲突（若适用）
- 核心章节不再只是骨架式短稿
- 无未闭合的 citation debt、protocol debt、result debt、prose debt、rationale debt、evidence debt、figure debt

否则，输出"当前最佳版本 + 未闭合问题清单"。

## Anti-Patterns

| 模式 | 问题 | 正确做法 |
|------|------|---------|
| 顺序颠倒 | 先改语言再查事实 | 必须证据→论证→风格三轮依次执行 |
| 姑息判决 | 草稿篇幅长就假设足够可信 | 检查核心内容是否充分，不因页数放行 |
| 伪修订 | 输出批注但不改原稿 | Revised Draft 必须真正吸收全部修改点 |
| 放水收尾 | 剩余 issues 多仍判 passed | 只有终止条件基本满足时才能判为 passed |