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/verification-status.md
View on GitHub# Verification Status 判定指南
## 输出格式
### Section Critique
```md
## Section Critique
- Issues fixed:
- Claims weakened or clarified:
- Evidence still missing:
- Risks to carry into next section:
- Missing figure/table/formula placements:
- Missing or inconsistent inline citations:
```
### Verification Status
```md
## Verification Status
- Verdict: passed / failed / blocked
- section_contract_debt: open / closed
- prose_debt: open / closed
- citation_debt: open / closed
- evidence_debt: open / closed
- figure_debt: open / closed
- protocol_debt: open / closed
- result_debt: open / closed
- rationale_debt: open / closed
- thin_draft: yes / no
- Checks performed:
- Remaining issues:
- Can move to next section: yes / no
```
若判定为 `blocked`,必须额外包含:
```md
- safe_to_continue: yes / no
- frozen_claims:
- Claim: ...
Reason frozen: ...
Alternative text: ...
Unfreeze condition: ...
```
---
## 判定规则
### passed
条件:核心章节满足以下所有条件:
- 关键主张有对应证据
- 主要风险已被显式讨论
- 未核验内容被清楚标记
- 结果、表格、摘要相互一致
- 核心章节不再只是骨架式短稿(thin_draft = no)
- 无未闭合的硬 debt:citation_debt、evidence_debt、protocol_debt、result_debt、section_contract_debt、rationale_debt、prose_debt
- figure_debt 为软发布债务:open 时不单独阻止当前 section passed,但必须记录到最终图表生成、Step 9 或外部阻塞清单
### failed
条件:问题可以通过继续修订解决(非外部阻塞):
- 信息充分但文体仍不适合作为论文正文 → failed(如仍存在明显 prose debt)
- 证据足以继续修订但当前写法仍偏"公式罗列型" → failed
- thin_draft = yes 且可继续扩写 → failed
### blocked
条件:需要外部证据或额外实验才能补齐:
- 缺口来自外部证据缺失,而不是本轮可通过继续改写解决的问题
- 必须依赖额外证据才能把说明文改写为合格正文 → blocked
- thin_draft = yes 且需要外部证据才能消除内容密度缺口 → blocked
- 核心 / 非显然模块缺少足够证据支撑模块级动机 → blocked
---
## safe_to_continue 判断
若判定为 `blocked`,判断是否允许继续其他 section。
**允许继续(safe_to_continue: yes)**的条件(必须同时满足):
1. 缺口来自外部证据缺失,不是本轮可通过继续改写解决的问题
2. 受影响内容可以冻结为占位或保守表述,不会在后续章节中被扩写成确定性结论
3. 继续写其他 section 不会放大幻觉风险,也不会迫使后文依赖未闭合 claim
**不允许继续(safe_to_continue: no)**的条件:
- 后续章节会依赖未闭合 claim
- 继续写会显著增加幻觉风险
---
## frozen_claims 记录
每个条目至少记录:
- 冻结原因
- 正文中的替代写法
- 解冻条件
---
## debt 类型速查
| debt 类型 | 含义 | 影响 |
|-----------|------|------|
| citation_debt | 需要文献支撑的段落缺少 inline citation 或 [REF_NEEDED] | passed 失效 |
| evidence_debt | 存在无证据支撑的 claim 或 [RESULT_UNVERIFIED] | passed 失效 |
| figure_debt | 存在未替换的 [FIGURE_NEEDED] 或 [TABLE_NEEDED] | 软约束,可 safe_to_continue |
| protocol_debt | 实验协议细节不可确认或混入领域默认值 | passed 失效 |
| result_debt | 缺实验结果、表格或指标 | passed 失效 |
| section_contract_debt | 缺少对应 section 的 required moves、reader-state 转换或 evidence hooks | passed 失效 |
| rationale_debt | 核心模块缺设计动机/预期收益/边界说明 | passed 失效 |
| prose_debt | 正文仍存在元评论、代码讲解、审稿人对话口吻或 checklist 痕迹 | passed 失效 |
citation_debt、evidence_debt、protocol_debt、result_debt、section_contract_debt、rationale_debt、prose_debt 任一存在 → passed 判定失效 → 至少为 failed 或 blocked。figure_debt 为软约束,可标记但允许 safe_to_continue = yes。
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 |