justcyl 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 相关资源分三类，不同阶段使用：
| 类别 | 文件 | 何时使用 |
|---|---|---|
| 写前注入 | references/latex-writing-prefs.md | 开始写作前读取，轻量偏好提醒 |
| 写完后 lint | scripts/latex_lint.py、scripts/check_hard_rules.sh |
源码/PDF 硬规则自动检查 |
| 写完后 review | references/latex-review-checklist.md | 人工复查，向用户汇报 |
# 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/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）默认关闭，用户明确要求时启用。
投稿前自查清单
- 所有
\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 页下限
- 页数计算方式各会不同，务必按目标会议规则判断