joshua-zyy/academic-paper-writer / skills/academic-reviser
academic-reviser
VerifiedSelf-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, 审稿, evidence compliance, peer review, 论文审查, draft audit, 验证论文, 检查引用, cross-section review, 审修, draft verification.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.4 KB |
| agents/reviser_agent.md | markdown | 5.0 KB |
| manifest.yaml | config | 1.9 KB |
| references/common-pitfalls.md | markdown | 1.4 KB |
| references/examples/reviser-output-examples.md | markdown | 3.0 KB |
| references/reviewer-package.md | markdown | 2.3 KB |
| references/revision-checklist.md | markdown | 5.1 KB |
| references/templates/section-critique.md | markdown | 1.1 KB |
| references/verification-checklists.md | markdown | 4.1 KB |
| references/verification-status.md | markdown | 4.0 KB |
| scripts/placeholder_audit.py | script | 3.6 KB |
| static/core/anti-patterns.md | markdown | 721 B |
| static/core/output-contract.md | markdown | 964 B |
| static/core/red-lines.md | markdown | 745 B |
| static/core/stance.md | markdown | 1.8 KB |
references/revision-checklist.md
View on GitHub# 修订检查清单
## 使用说明
按三轮顺序执行,不可跳过。若当前只写单个 section unit,先做节级审查;若已形成多节草稿,再做跨章节审查。
---
## 第一轮:证据与事实检查
逐项检查:
1. [ ] 每个关键背景事实是否有 VERIFIED 引用
2. [ ] 每个定量结果是否能追溯到本地证据(newly_run 或 preexisting_artifact)
3. [ ] 方法描述是否与代码或用户提供机制一致
4. [ ] 表格、正文、摘要中的数字是否一致
5. [ ] 是否把内部验证说成外部泛化
6. [ ] 是否遗漏关键 baseline 或反例
7. [ ] 若当前为 Method:是否写清整体架构、模块边界、输入输出和关键公式
8. [ ] 若当前为 Method:是否给出图表放置位置或显式图占位
9. [ ] 需要文献支撑的段落是否真的有 inline citation 或 [REF_NEEDED: ...]
10. [ ] 参考文献列表中的条目是否都在正文中被实际引用
11. [ ] 若当前为 Introduction 或 Related Work:是否先做过同领域 exemplar 调研,而非直接套用通用模板
12. [ ] 若当前为 Experimental Setup 或 Data:是否把领域常见默认协议误写成当前项目已确认事实
13. [ ] 若当前为 Discussion 或解释性段落:是否清楚区分"观察结果"和"领域解释"
14. [ ] 是否存在 Section Contract,并且当前 section 的 required moves、reader-state 转换与 evidence hooks 已落实或显式标为 debt
若任一项失败,先修事实,再谈语言。
---
## 第二轮:论证强度与审稿风险检查
从怀疑者视角提问:
- [ ] Reviewer 最可能攻击哪一条证据链?
- [ ] 哪些地方的表述比证据更强?
- [ ] 哪些局限性被藏起来了?
- [ ] 哪些实验设计会被认为偏乐观?
- [ ] 哪些 related work 被遗漏后会显得"选择性比较"?
- [ ] 方法节是否只是在复述直觉,而没有给出足够具体的结构、公式和实现细节?
- [ ] 引言是否过早进入"我们提出了什么",而没有建立领域背景、任务难点和现有缺口?
- [ ] 相关工作是否只是按论文名排队,而没有形成 work clusters、综合比较和与本文的定位关系?
- [ ] 实验设置里的具体协议是否真的有 artifact 支撑,还是按领域习惯补出来的?
- [ ] 讨论里的领域解释是否有已核验文献支撑,还是只是把观察结果包装成更强解释?
- [ ] 是否把"内部审查备注"错误地写进论文正文,而不是留在 sidecar critique?
- [ ] 当前 section 是否完成 `skills/academic-paper-writer/references/section-writing-contracts.md` 中对应类型的论证功能,而不是只达到表面流畅?
对这些问题,要么补证据,要么弱化表述,要么把风险显式写出。
---
## 第三轮:结构与风格检查
只有在前两轮基本通过后,才重点检查:
- [ ] 段落衔接是否清晰
- [ ] 章节顺序是否合理
- [ ] 术语是否前后一致
- [ ] 图表引用是否完整
- [ ] 是否符合目标 venue 的结构和语气
- [ ] 正文引用样式是否统一
- [ ] 正文中是否残留 AI 典型机械痕迹:连续多句以相同句式开头、段落首句均为空泛铺垫、高频连接词"此外/然而/因此"扎堆出现
- [ ] 句子之间是否只靠连接词维持表面连贯,而缺少因果、转折或递进的深层逻辑衔接
- [ ] 若 `section_contract_debt = open`,是否阻止将 Verification 判为 passed
注意:不要把语言润色放在事实检查之前。
---
## CS/AI/ML 报告规范检查
详见 `skills/academic-paper-writer/references/reporting-checklist.md`。对 Experimental Setup / Main Results / Ablation 等实验相关 section,按以下类别检查:
- 计算资源(GPU、训练时长、内存)
- 可复现性(随机种子、代码链接、环境配置)
- 实验设计(交叉验证、超参数搜索、早停策略)
- 基线比较(实现来源、公平比较、超参数调优)
- 统计显著性(方差/置信区间、统计检验方法)
- 伦理声明(数据许可、隐私保护、偏见分析)
---
## Method 专项检查
若当前 section 是 Method,额外检查:
- [ ] 是否标出整体架构图位置
- [ ] 是否按模块分节
- [ ] 是否先识别核心 / 非显然设计选择,而不是把所有模块写成同一力度
- [ ] 是否交代模块作用、输入输出、关键操作、公式
- [ ] 对核心 / 非显然模块,是否存在独立的设计动机句,而不是只有公式描述
- [ ] 对核心 / 非显然模块,是否解释了为什么采用该设计,而不是只解释它"怎么运算"
- [ ] 对核心 / 非显然模块,预期收益是否与具体机制绑定,而不是空泛表扬
- [ ] 若设计动机来自有限推断,是否使用了保守、降级的语气
- [ ] 是否完成 Method Prose Rewrite Pass
- [ ] 是否仍保留元评论口吻、作者解释口吻、代码讲解口吻
- [ ] 模块段首是否直接落在"该模块解决什么问题"
- [ ] 是否遗漏训练 / 推理中的关键实现细节
- [ ] 是否把审查备注错误写进 Paper Body
- [ ] 是否仍存在未闭合的 [RATIONALE_NEEDED: ...] 或 rationale_debt
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |