| name | academic-paper |
| description | 学术论文写作的完整方案。当需要写论文、生成论文配图、检查投稿格式或进行投稿前审查时触发。触发词："写论文""paper writing""投稿前检查""画个架构图""论文配图""格式检查""desk reject"。 |
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. 确认目标会议与模板
在写任何内容之前，必须确认：
- 目标会议 + 年份（如 NeurIPS 2025、ACL 2025）
- 论文类型（long / short / workshop / position）
- 页数限制（见下方速查表）
- 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。
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 相关资源分三类，不同阶段使用：
python3 ~/.agents/skills/academic-paper/scripts/latex_lint.py <file> [--bib] [--fix-preview] [--severity WARN]
bash ~/.agents/skills/academic-paper/scripts/check_hard_rules.sh paper.pdf <conf> <submission|camera-ready>
避免 Vibe Paper 特征
详见 references/anti-vibe-checklist.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 直接绘制，不走本模块。
格式检查
详见 references/format-check.md。
硬规则自动检查脚本（纸张尺寸 / 字体嵌入 / 匿名性 / 必需章节 / 编译日志等）：
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）默认关闭，用户明确要求时启用。
投稿前自查清单
重要提醒
- 不同年份规则可能变化 — 始终去官网确认当年 CFP
- ACL/ARR 的 Limitations 章节缺失 = desk reject
- AAAI 参考文献计入页数（唯一例外）
- ICLR 2025 新增 6 页下限
- 页数计算方式各会不同，务必按目标会议规则判断
