# Academic Paper

> 学术论文写作的完整方案。当需要写论文、生成论文配图、检查投稿格式或进行投稿前审查时触发。触发词："写论文""paper writing""投稿前检查""画个架构图""论文配图""格式检查""desk reject"。

- Skill: `justcyl/academic-paper` (Agent Skill, multi-file: 10 files)
- Install (CLI): `npx skillmds@latest add justcyl/academic-paper`
- Raw SKILL.md: https://api.skillmd.com/api/skills/justcyl/academic-paper/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: justcyl (https://skillmd.com/u/justcyl)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/justcyl/academic-paper

---


# Academic Paper

AI 学术论文全周期写作 skill。从获取模板到投稿终审。

## 搭配 Skills

| Skill | 用途 | 何时调用 |
|-------|------|---------|
| **overleaf** | 创建项目 / git clone-push / 编译 / 下载 PDF / review 评论 | 项目初始化及全程同步 |
| **image-gen** | 多模型图片生成引擎（gemini / gpt-image-2 / grok，text-to-image / image-to-image / 多分辨率 / gallery） | 配图子模块的底层引擎 |
| **pi-subagent** | 视觉 QA 子代理（figure-qa agent，academic / slides / general scene） | 配图审查、格式视觉审查 |
| **ph-paper-helper** | 论文检索 / 导入 / BibTeX 导出与补全（`ph add --bib` / `ph enrich`） | 文献引用处理 |

---

## 准备阶段

### 1. 确认目标会议与模板

在写任何内容之前，必须确认：

1. **目标会议 + 年份**（如 NeurIPS 2025、ACL 2025）
2. **论文类型**（long / short / workshop / position）
3. **页数限制**（见下方速查表）
4. **DDL**

然后去**该会议官网**下载当年官方 LaTeX 模板。不同年份模板不同，不可复用旧版。

> ⚠️ 不要猜模板链接。每年 CFP 页面会更新模板下载地址。直接搜索 `<Conference> <Year> call for papers` 获取最新版。

### 页数速查

| 会议 | 投稿正文 | Camera-ready | 参考文献 | 备注 |
|------|---------|-------------|---------|------|
| NeurIPS | 10 页 | 10 页 | 不计 | 含图表，不含参考文献/附录 |
| ICML | 8 页 | 9 页 | 不计 | 不含参考文献/Impact/附录 |
| ICLR | 6-10 页 | 同投稿 | 不计 | 6 页下限（2025 新增）|
| ACL/ARR Long | 8 页 | 9 页 | 不计 | Limitations **必须有** |
| ACL/ARR Short | 4 页 | 5 页 | 不计 | 同上 |
| AAAI | 7 页 + 2 附加 | 同投稿 | **计入** | 唯一参考文献计入页数 |

会议格式详表见 [references/conference-rules.md](references/conference-rules.md)。

### 2. 创建 Overleaf 项目

确认论文项目名后，通过 overleaf skill 创建项目、克隆到本地：

```
1. overleaf: 创建项目 "<论文名>"
2. 克隆到本地工作目录
3. 将下载的官方模板文件放入项目
4. push 到 Overleaf 确认编译通过
```

### 3. 检查参考文献

检查项目中是否已有 `.bib` 文件：

- **已有 `.bib`** → 使用 ph-paper-helper 的 `ph enrich --bib <file>.bib` 补全不完整的元数据
- **没有 `.bib`** → 创建空 `references.bib`，在全部写作完成后提醒用户补充参考文献。写作过程中遇到需要引用的地方先用 `\cite{TODO-xxx}` 占位

---

## 写作阶段

本 skill 不限定写作顺序、字数分配或段落结构。论文内容由用户主导，agent 辅助执行。

LaTeX 相关资源分三类，不同阶段使用：

| 类别 | 文件 | 何时使用 |
|------|------|----------|
| **写前注入** | [references/latex-writing-prefs.md](references/latex-writing-prefs.md) | 开始写作前读取，轻量偏好提醒 |
| **写完后 lint** | `scripts/latex_lint.py`、`scripts/check_hard_rules.sh` | 源码/PDF 硬规则自动检查 |
| **写完后 review** | [references/latex-review-checklist.md](references/latex-review-checklist.md) | 人工复查，向用户汇报 |

```bash
# Linter
python3 ~/.agents/skills/academic-paper/scripts/latex_lint.py <file> [--bib] [--fix-preview] [--severity WARN]

# PDF 硬规则
bash ~/.agents/skills/academic-paper/scripts/check_hard_rules.sh paper.pdf <conf> <submission|camera-ready>
```

---

## 避免 Vibe Paper 特征

详见 [references/anti-vibe-checklist.md](references/anti-vibe-checklist.md)。

---

## 配图生成

详见 [references/figure-gen.md](references/figure-gen.md)。

底层引擎：image-gen（默认 gemini-3.1-flash-image-preview，高质量可选 gpt-image-2）；视觉审查：pi-subagent figure-qa（scene: `academic`）；最多 3 轮 inspect-revise，确认后升 4K 终稿。全程自动完成并插入 LaTeX，同时输出 gallery.html 供用户事后对比/换图。

> 数据驱动图表（bar chart / line plot / heatmap）用 matplotlib/seaborn 直接绘制，不走本模块。

<!-- figure-gen content moved to references/figure-gen.md -->

## 格式检查

详见 [references/format-check.md](references/format-check.md)。

硬规则自动检查脚本（纸张尺寸 / 字体嵌入 / 匿名性 / 必需章节 / 编译日志等）：

```bash
bash ~/.agents/skills/academic-paper/scripts/check_hard_rules.sh \
  paper.pdf <conference> <submission|camera-ready> [--paper-type long|short] [--log main.log]
```

脚本失败（exit 1）= 存在 desk-reject 风险的硬规则违反；警告（exit 0）= 需人工复核。
视觉审查（逐页 pi-subagent figure-qa）默认关闭，用户明确要求时启用。

<!-- format-check content moved to references/format-check.md -->

## 投稿前自查清单

- [ ] 所有 `\cite{TODO-xxx}` 占位已替换为真实引用
- [ ] Abstract 与 Introduction 末尾的贡献点一致
- [ ] 每个 Figure / Table 在正文中被 `\ref` 引用
- [ ] 每个编号公式在正文中被 `\eqref` 引用
- [ ] 缩写首次出现时展开
- [ ] 数字精度统一（如都保留两位小数）
- [ ] 参考文献无重复条目、格式统一
- [ ] `.bib` 中所有条目元数据完整（用 `ph enrich --bib` 检查）
- [ ] 没有 `[?]` 未解析引用
- [ ] 没有 `Overfull \hbox` 超过 1pt 的警告
- [ ] Camera-ready：作者信息完整、去掉行号、补充 Acknowledgements
- [ ] 投稿版：无作者信息、有行号
- [ ] ACL/ARR：Limitations 章节存在、Responsible NLP Checklist 已填
- [ ] PDF < 50MB
- [ ] 匿名 code repo（如 anonymous.4open.science）已准备（如需要）

---

## 重要提醒

- **不同年份规则可能变化** — 始终去官网确认当年 CFP
- **ACL/ARR 的 Limitations 章节缺失 = desk reject**
- **AAAI 参考文献计入页数**（唯一例外）
- **ICLR 2025 新增 6 页下限**
- 页数计算方式各会不同，务必按目标会议规则判断