SuperAPI AI 工具集

init-latex-project

写作与研究

查看项目

更新于 10-15 10:16

技能介绍

用途

init-latex-project 用于从标准模板搭建一个完整的 LaTeX 学术论文项目。它面向需要会议或期刊模板、宏包、会场专用导言区以及写作指导的新论文。

主要能力

该技能提供技能目录结构,包含 SKILL.md、sources.yaml(各会场已验证的权威下载源)、templates/ 目录(含 macros.tex、main.tex、gitignore、AGENTS.md、CLAUDE.md 以及各会场的 main.tex)和 scripts/init.sh。

init.sh 会从会场的权威来源下载官方 .sty/.bst 文件,检测实际文件名,并自动生成 venue_preamble.tex。每个会场模板使用 \input{venue_preamble},而 main.tex 保持稳定、永不改变;切换投稿模式(例如匿名转 camera-ready)时只需编辑 venue_preamble.tex。

支持的会场(按截止月份):icml(1 月,双栏)、acl(2 月,单栏)、iccv(3 月,双年奇数年,双栏)、eccv(3 月,双年偶数年,单栏 LNCS)、neurips(5 月,单栏)、emnlp(5 月,单栏)、iclr(9 月,单栏)、cvpr(11 月,双栏)、naacl(12 月,单栏)、acm(时间不定,单栏)。

使用方式

调用形式为 /init-latex-project <项目名> [目标目录] [--venue <会场>] [--git] [--offline]。第一个词为项目名(必填),第二个词为目标目录(默认当前目录),--venue 指定会议会场,--git 初始化 git 仓库,--offline 跳过样式文件下载并创建占位 venue_preamble.tex。

脚本运行方式:bash <init-latex-project-skill-dir>/scripts/init.sh <项目名> [目标目录] [--venue <会场>] [--git]。需要将 <init-latex-project-skill-dir> 解析为该技能的已安装目录,并使用 init.sh 的绝对路径。

脚本运行后,技能会询问是否立即自定义(更新 sections/title.tex 的标题、填写 main.tex 的作者与单位等),并记录编译工作流(本地、Overleaf-GitHub、CI 或未知)。对于 Overleaf/GitHub 项目,应将 Overleaf 的编译日志与 PDF 预览视为编译事实来源;对于本地编译项目,应在运行时用 command -v 检测可用编译器,但不要提交检测到的路径。若安装了 tex-fmt,则将其记录为默认源格式检查器(tex-fmt --check --nowrap --recursive .)。

生成的论文仓库应包含 AGENTS.md 和 CLAUDE.md 两份语义一致的代理指导文件,以及 .gitignore。技能还会记录论文版本策略:目标特定的论文版本通常应隔离为兄弟目录 paper-worktrees/ 下的论文工作树。

适用场景

适用于为新会议或期刊论文创建项目骨架,包括切换会场模板、准备 arXiv/预印本发布、录用后定稿 camera-ready、以及仅针对 rebuttal 的编辑。对于 arXiv 或任何公开源码发布,应避免在发布的 .tex 源码中保留内部图表描述、实验来源说明、审稿人笔记、TODO、作者注释宏、私有路径和隐藏注释。对于匿名会议投稿,应强制执行会场匿名与格式模式。

限制

  • 若 init.sh 无法访问会场服务器,venue_preamble.tex 会创建为占位文件,需手动访问会场作者说明页(URL 在 sources.yaml 中)、手动下载样式 zip 并解压 .sty/.bst 文件、编辑 venue_preamble.tex 添加正确的 \usepackage 行。
  • macros.tex 中 \def(、\def)、\def[、\def] 已被永久禁用,因为它们重定义了 LaTeX 内置数学模式定界符,会导致级联错误,需改用 \left( ... \right)。
  • macros.tex 中同时加载 \usepackage{algorithm} 与 \usepackage{algorithmic} 已被永久禁用,因为与 algpseudocode 同时加载会导致命令重定义错误。
  • 已知包冲突包括:ACM 的 acmart 重定义 \P(本库的 \P = \mathbb{P} 会覆盖它,属有意为之);ACM 的 acmart 自带 \cite,macros.tex 中的 \let\cite\citep 可能干扰,必要时注释掉;CVPR 双栏布局中 tcolorbox 定理环境可能跨栏,必要时改用普通 amsthm;ICML 使用自己的 hyperref 设置,需在 icml<year> 之后加载 macros.tex;NeurIPS 中 algorithmic 与 algpseudocode 应始终使用 algpseudocode;NeurIPS 中 cleveref 必须在 main.tex 中于 hyperref 之后只加载一次,需从 macros.tex 中移除或注释 cleveref 行。
  • 关于具体价格、收费或平台可用性信息,资料未提供。