Skip to content

paper-audit

面向 LaTeX、Typst 和 PDF 的深度审稿优先论文审查技能。它是 reviewer 和投稿门禁流程,不是源码编辑器。

适用场景

  • 投稿前快速就绪性筛查。
  • 最后一周机械检查:em dash、AI-tone、摘要结果缺口、citation/label/equation hygiene、段落形态弱信号。
  • 模拟审稿人的 major / moderate / minor 深度批评。
  • 按投稿 blocker 校准的 PASS/FAIL 门禁判断。
  • 对照旧报告验证修订是否解决问题。
  • 生成可追踪的 review workspace、claim map、quote check 和 revision trajectory。

不适用场景

  • 一上来就直接修改 .tex.typ 源码。
  • 把编译修复当主任务。
  • 没有审查目标的逐句润色。
  • 单独代写文献综述。
  • 投稿信生成或 claim 对齐;请用 cover-letter

模式路由

模式适用场景主命令
quick-audit快速脚本化就绪性筛查uv run python academic-writing-skills/paper-audit/scripts/audit.py paper.tex --mode quick-audit
deep-review需要审稿式问题清单、workspace 和修订路线图uv run python academic-writing-skills/paper-audit/scripts/audit.py paper.tex --mode deep-review --focus full
gate只关心硬性投稿 blockeruv run python academic-writing-skills/paper-audit/scripts/audit.py paper.tex --mode gate --venue ieee
polish润色前需要 precheck-only handoffuv run python academic-writing-skills/paper-audit/scripts/audit.py paper.tex --mode polish
re-audit有旧报告,需要做回归比较uv run python academic-writing-skills/paper-audit/scripts/audit.py paper.tex --mode re-audit --previous-report report_v1.md

兼容别名:self-check -> quick-auditreview -> deep-review

deep-review 会派发 5 个 committee agent 和 6 个以上 lane agent,随后交给 synthesis_agent.md 综合。gatere-audit 和 consolidation 后的修订建议分别使用 对应的模式专属 agent。agents/ 下的 specialized reviewer playbook 仅作参考,不会自动派发; 完整边界见代理名册

最小输入

  • paper.texpaper.typpaper.pdf
  • 可选 --venue--lang en|zh--report-style deep-review|peer-review
  • deep-review 可选 --focus full|editor|theory|literature|methodology|logic
  • re-audit 需要 --previous-report
  • 继续或渲染已有 workspace 时提供 --review-dir

脚本入口

脚本用途
audit.pyquick-audit、deep-review、gate、polish、re-audit 的公开入口
prepare_review_workspace.py准备 deep-review workspace
build_claim_map.py抽取 headline claims、closure targets 和 claim candidates
check_citations.py / check_references.py引用与参考文献 hygiene 检查
verify_quotes.py校验报告 quote 是否来自源文本
render_deep_review_report.py渲染 Markdown 深审报告
render_html_report.py渲染双语 HTML 报告
render_revision_trajectory.py生成 revision trajectory
diff_review_issues.py支持 re-audit 对比

输出产物

deep-review 的 workspace 根目录面向读者:

  • review_report.mdreview_report.html
  • revision_suggestions.mdrevision_suggestions.html

支撑产物位于 artifacts/

  • artifacts/summary/paper_summary.mdoverall_assessment.txtpeer_review_report.md
  • artifacts/data/final_issues.jsonall_comments.jsonclaim_map.jsonsection_index.jsonrevision_suggestions.jsonrevision_trajectory.md
  • artifacts/meta/metadata.jsoncheckpoint.jsonphase0_context.mdfull_text.md
  • artifacts/sections/artifacts/comments/artifacts/committee/artifacts/references/

报告语言由 --lang en|zh 控制。标题、标签和表头会切换语言;issue quote、source tag 和结构化字段值保持原文。

公开资源

参考资料

模板

示例

Agent 契约

常见请求

text
对 paper.tex 做一次 quick-audit,告诉我什么会阻止投稿。
text
像期刊审稿人一样 deep-review 这篇论文,并产出 review workspace 和 HTML 报告。
text
对这篇 IEEE 论文做 gate 检查,把硬阻塞和伪代码建议项分开。
text
只审查文献定位,判断 research gap 是真实问题还是选择性引用制造出来的。
text
基于 report_v1.md 对这篇修订稿做 re-audit,总结已解决和未解决问题。

重要说明

  • PRESUBMISSION 是接入现有模式的机械层,不是新的公开模式。
  • full/editor deep-review 可把高信号投稿前发现提升到 pre_submission_readiness;其他 focus 默认保留在 Phase 0 上下文。
  • claim_map.json 区分可见锚点和支撑强度;citation key 本身不等于真实支撑。
  • Data availability 默认 advisory;只有 venue 明确要求且 central source data 缺失时才阻塞投稿。
  • PDF 输入只做文本类检查,跳过 LaTeX/Typst 源码 hygiene。

基于 MIT 许可发布