academic-reviser
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 r
What it does
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 包装)
- 禁止在
section_contract_debt未闭合时判为 passed;结构性论证缺口不能用 prose_debt closed 替代。
非协商规则
- 代码与方法一致性、实验与表格一致性必须检查。
- 修订必须针对性修正,保持 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 / closedsection_contract_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 只审查论文草稿文本,绝对不得修改项目源代码、配置文件或数据文件,也不得独立撰写论文正文。
独立使用
当本 Skill 被独立加载(不通过 academic-paper-writer 编排器)时:
典型请求
- "帮我审查一下这篇 Introduction 有没有证据缺口"
- "检查这篇文章的引用是否闭合"
- "做一次跨章节一致性检查"
- "帮我看一下草稿的方法与结果是否一致"
入口分流
| 用户输入特征 | 匹配模式 | 优先级 | 行为 |
|---|---|---|---|
| 提供单节草稿文本 | full-section-review | 2(文本触发) | 完整三轮审查 + Verification 判定 |
| 提供多节草稿 + "一起看" | cross-section-review | 1(用户显式指定) | 跨章节一致性检查 |
| 只要求判定(已有自查结果) | verification-only | 1(用户显式指定) | 基于已有信息直接输出 Verdict |
| 指定检查内容("只看引用") | targeted-review | 1(用户显式指定) | 仅执行指定维度的检查 |
| 要求检查证据合规("哪些 claim 没证据") | targeted-evidence-mode | 1(用户显式指定) | 仅输出 evidence_debt 清单,不修改正文 |
执行约束
- 开始前必须确认:审查范围(哪个/哪些 section)、审查模式、是否已有证据清单
- 无
evidence_map时从草稿推断:扫描 claim + inline citation,无法推断的标记"待核验" - 输出:Section Critique + Verification Status(verdict + overall score + 各项 debt)+ Revised Draft
- 禁止修改草稿以外的项目文件
- 必须遵守审查顺序:证据 → 论证 → 风格
组合使用指引
| 场景 | 推荐方式 |
|---|---|
| 只需审查已有草稿 | 本 Skill(独立) |
| 起草过程中逐节审查 | academic-paper-writer 编排器(Step 6.5/6.8 自动调度) |
| 发现缺口后需补实验/引用 | academic-experiments/academic-citation → 回到本 Skill 重审 |
何时读取 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、section_contract_debt、prose debt、rationale debt、evidence debt、figure debt
否则,输出"当前最佳版本 + 未闭合问题清单"。
Anti-Patterns
| 模式 | 问题 | 正确做法 |
|---|---|---|
| 顺序颠倒 | 先改语言再查事实 | 必须证据→论证→风格三轮依次执行 |
| 姑息判决 | 草稿篇幅长就假设足够可信 | 检查核心内容是否充分,不因页数放行 |
| 伪修订 | 输出批注但不改原稿 | Revised Draft 必须真正吸收全部修改点 |
| 放水收尾 | 剩余 issues 多仍判 passed | 只有终止条件基本满足时才能判为 passed |
Capabilities
Install
Quality
deterministic score 0.45 from registry signals: · indexed on github topic:agent-skills · 7 github stars · SKILL.md body (5,365 chars)