Sep 16, 2026
用 latex-arxiv-SKILL 写一篇门控核验引用、arXiv 就绪的综述论文
一个代理化 harness,驱动 Claude Code 或 Codex 按门控、issue 驱动的流程撰写 ML/AI 综述论文——每条引用在进入 ref.bib 前都会经过联网核验。
一篇机器学习综述论文其实是两份工作钉在一起:读够文献才能有观点,同时还要让 LaTeX 工程里的每一条引用都经得起核对。latex-arxiv-SKILL 这个 harness 把第二份工作的纪律自动化了——它在 GitHub 上约有 400 星,并且同时支持 Claude Code 和 OpenAI Codex。
为什么这个 Skill 重要
这个仓库把自己定位为「用于撰写机器学习与 AI 综述论文的代理化 harness」。你给编码代理一个主题,它就按固定流程推进:先做一次研究快照(10 到 20 篇论文,不写正文),搭建 IEEEtran 工程骨架并给出草拟计划与候选标题,经过一道人工审批门,然后进入逐 issue 的写作循环——每一条 \cite{} 在进入 ref.bib 之前都会先联网对照活跃来源核验。
护栏才是它的核心。在你批准计划、且 issues CSV 文件存在之前,代理不能往 main.tex 写入任何一个段落。每个章节都会变成一个带目标引用和验收标准的 tracked issue,验收标准没达标就不能标记 DONE。交付要求 pdflatex 和 bibtex 构建干净、零条未定义引用告警。
这套 bundle 遵循仓库自己定义的可移植 Agent Skills 标准,因此同一份文件可以在 Codex 和 Claude Code 中运行。确定性部分——脚手架、计划与 issue 生成、arXiv 检索(带本地 SQLite 缓存)、校验、编译——都是 Python 脚本,其 issue 驱动的工作流灵感来自同一作者的 appautomaton/agent-designer。
安装
README 没有记载安装脚本或包管理命令。克隆仓库,然后带着你的代理在其中工作:
git clone https://github.com/appautomaton/latex-arxiv-SKILL.git
cd latex-arxiv-SKILL
仓库根目录带有 AGENTS.md,四个 skill bundle 位于 .codex/skills/(arxiv-paper-writer、latex-rhythm-refiner、collaborating-with-claude、collaborating-with-gemini),旁边还有一个 .claude 符号链接。Requirements 一节列出的环境要求是:可用的 LaTeX 环境(pdflatex 和 bibtex,或 latexmk)、Python 3.8+、开启了 skills 的代理运行时,以及用于引用核验的联网搜索与浏览能力。作者在 macOS 上用 GPT-5.2(Extra High)测试。
实战流程:两条提示词生成一篇综述
README 的快速上手示例用两条提示词生成了 example/v0-single-SKILL/ 中的示例论文。先启动论文:
write a review article for arxiv that is about SOTA generative image models
代理会做一次初步文献检索,草拟章节框架,提出候选标题,并写出一个 plan/<timestamp>-<slug>.md 文件,里面包含澄清问题。打开这个文件并回答这些问题,就能把控范围、标题和覆盖面。
然后放权决策、继续推进:
I will let you choose the best title and the topics and inclusion of material that you see the best fit
即使忽略计划中的澄清问题,harness 也会做出尽力而为的选择,产出一个完整、可编译的 LaTeX 工程——main.tex、ref.bib 和 main.pdf。仓库自带两个生成示例:一篇含 55 条已核验引用的生成式图像模型综述,和一篇含 81 条已核验引用的视频世界模拟器(3D/4D)综述(多 skill 协作运行,使用了 SQLite arXiv 注册表)。
实战流程:审计既有 LaTeX 工程的引用
你不必从零开始。把 harness 指向一个已有的 LaTeX 工程,它会运行一次引用校验流程,在不重新搭建脚手架的前提下审计并修复 ref.bib。没有证据支撑的论断会变成 TODO 而不是编造的参考文献——FAQ 把这一点归入护栏:任何无法对照活跃来源核验的引用都不会被加入。
使用技巧
- 计划写出来之后,认真回答
plan/里的澄清问题——这是写作开始前门控留给你的唯一手动杠杆。 issues/*.csv文件是进度的唯一事实来源;随着范围扩大,代理会拆分或插入 issue,而不是做游离在跟踪之外的工作。latex-rhythm-refiner会在保留每一条引用的前提下,对正文做句子与段落节奏的后处理——在最后一轮编译前运行它。- 开箱即用的甜区是综述与调研类文章;按 FAQ 的说法,原创或实验性论文经过裁剪也能用,方式是把计划和输入塑造成你的目标。
什么时候不该用它
你需要先装好可用的 LaTeX 环境和 Python 才能跑起来——它不是托管服务。如果你的目标是一篇短博客或内部备忘录,这套门控流程只有开销没有收益。而如果你想放任代理自由发挥草稿、事后再人工核查,这些硬性门控会一路跟你作对。
查看排行榜了解更多 skill。