| 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（绝对禁止）
- 禁止跳过检查顺序：必须证据→论证→风格，不得先修风格再查事实
- 禁止输出批评说明后沿用原稿：Revised Draft 必须真正吸收修改点
- 禁止在 citation debt / evidence debt / protocol debt / result debt / prose debt / figure debt 未闭合时判为 passed
- 禁止删除占位符而不补真实内容
- 禁止因草稿篇幅长就假设它足够可信
- 禁止用更华丽的写法掩盖内容不足（如 related work 薄用漂亮 prose 包装）
非协商规则
- 代码与方法一致性、实验与表格一致性必须检查。
- 修订必须针对性修正，保持 evidence-first 原则：不确定的修正用占位符，不臆造。
- 只有满足终止条件时才能标记为 passed；否则输出"当前最佳版本 + 未闭合问题清单"。
- 遇到自欺信号（只修措辞不修证据、用长度代替可信度）必须主动标记为 failed。
任务模式
- full-section-review — 对单个 section 执行完整三轮审查 + Verification
- cross-section-review — 跨章节一致性检查（摘要 vs 正文 vs 表格 vs 结论）
- verification-only — 仅执行 Verification 判定（不重做自审）
- targeted-review — 针对特定问题做定向审查（如仅检查引用闭合）
- 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 / closedcitation_debt: open / closedevidence_debt: open / closedfigure_debt: open / closedthin_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 |
