submit-paper 是一个针对 LaTeX 学术论文投稿前检查的技能，属于 a-green-hand-jack/ml-research-skills 仓库。其用途是在向会议提交论文之前，对 LaTeX 论文项目运行系统性的就绪检查，涵盖投稿模式、必备章节、草稿残留、参考文献、匿名性、源码格式以及可选的编译环节。
主要能力
该技能支持初始投稿（匿名）、Camera-ready、arXiv 预印本等不同投稿类型的检查。脚本检查的项目包括：项目检测（main.tex 是否存在、从 venue_preamble.tex 读取目标会议）、草稿残留（\todo、\fixme、\red{}、作者注释宏、TODO/FIXME 文本）、匿名性（致谢、资助披露、个人 URL/邮箱）、参考文献（.bib 文件非空、\bibliography{} 调用存在）、必备章节（依会议而定）、摘要长度（约 30–350 词，超出范围会警告）、图表（所有 \label{fig:} 和 \label{tab:} 都被 \ref 引用）、源码格式（安装了 tex-fmt 时运行 tex-fmt --check --nowrap --recursive .）、编译（可选，针对本地编译工作流）。
使用方式
使用流程如下：
第 1 步 — 定位 LaTeX 项目：通过 git rev-parse --show-toplevel 查找项目根目录，用 find . -maxdepth 3 -name "main.tex" 查找主文件，确定 $PAPER_DIR。如果项目结构中有 paper-worktrees/ 且请求目标是特定会议、arXiv 发布或 camera-ready 版本，则检查匹配的 worktree。
第 2 步 — 询问投稿上下文：在单条消息中询问投稿类型（初始投稿匿名 / Camera-ready / arXiv 预印本）、截止时间、编译后端（本地编译、Overleaf-GitHub、CI 或未知）、版本工作区（主 paper/ 仓库还是特定 paper-worktrees/ 版本）、源码可见性（agent 私有、作者可见、匿名投稿、公开预印本、camera-ready 公开、出版商产物）。如果可从 venue_preamble.tex 推断会议，则跳过询问。
第 3 步 — 运行检查脚本：bash <submit-paper-skill-dir>/scripts/check.sh "$PAPER_DIR" [--compile]。仅在编译后端为本地或用户明确要求本地编译时才传 --compile。
第 4 步 — 处理源码格式：如果安装了 tex-fmt，检查脚本仅以检查模式运行 tex-fmt --check --nowrap --recursive .。格式不匹配作为警告处理，除非用户或项目策略将其设为阻塞门槛。不在投稿检查期间静默格式化源码。
第 5 步 — 处理 Overleaf/GitHub 编译：当编译后端为 Overleaf-GitHub 或用户要求为 Overleaf 发布变更时使用此工作流。确认本地 paper 仓库有 GitHub 远程，通过正常 Git 流程提交并推送，让用户在 Overleaf 中编译同步的分支。将 Overleaf 视为 PDF 真相的来源，用于干净的编译状态、页数、溢出盒子和布局警告、参考文献渲染和最终 PDF 检查。
第 6 步 — 修复 venue_preamble.tex 中的投稿模式：核对 \usepackage 选项与用户在第 2 步中说明的模式是否匹配，展示需要修改的内容并询问是否修复。
第 7 步 — 检查源码可见性与清理：不同可见性层级（agent 私有、作者可见、匿名投稿、公开预印本、camera-ready 公开）有不同的源码卫生要求。对于作者可见、匿名、arXiv、camera-ready 或出版商可见的源码，不在源码树中留下内部审计产物，包括 .agent/、AGENTS.md、CLAUDE.md、图表描述、来源说明、审稿回复笔记、TODO、原始 CSV、内部结果文档、绘图脚本、笔记本、私有路径和作者注释宏。
第 8 步 — 报告发现与行动计划：以结构化格式呈现结果，包括本地静态检查结果、tex-fmt 状态、编译后端与状态、版本工作区状态、源码可见性层级与卫生状态、布局调试状态（如相关）。报告分为已通过、警告（提交前审查）、必须修复（阻塞提交）三部分，并提供每项失败或警告的具体文件和行号以及确切修复方法。
第 9 步 — 提供针对性修复：针对常见失败（草稿残留、源码格式、缺失必备章节、投稿模式错误、源码卫生问题、布局浮动和短行问题、空的 bib 文件）提供即时修复，但未经确认不自动修复。
适用场景
该技能适用于 LaTeX 论文投稿前的准备阶段，包括初始投稿、camera-ready 准备、arXiv 发布等。它提供了各会议的必备章节与页数限制参考（如 ICML 9 页 + impact.tex、ACL 8 页 + limitations.tex、NeurIPS 9 页 + impact.tex + checklist.tex 等），以及投稿模式快速参考（NeurIPS、ICML、ICLR、CVPR、ICCV、ACL/EMNLP/NAACL、ECCV）。还包含 camera-ready 检查清单（venue_preamble.tex 设为 final/accepted 模式、填写作者姓名与单位、添加致谢、移除所有作者注释宏等）和 arXiv 提交说明（提交 .tex 源码、扁平化 \input、切换到 preprint 模式、包含所有 .sty/.bst/.cls 文件等）。
限制
该技能不记录本地 TeX 可用性为共享项目状态；是否为本地用户机器的运行时事实。默认使用静态检查，仅在项目编译后端为本地或用户明确要求本地编译且运行时检测到可用编译器时才运行本地 LaTeX 编译。对于 Overleaf-GitHub 或 CI 后端，使用推送的源码加远程日志/PDF 产物作为编译证据。不因本地 latexmk、pdflatex、xelatex、lualatex 或 tectonic 不可用而仅凭此阻塞投稿就绪，除非项目编译后端明确为本地。布局调试、浮动放置、溢出/不足盒子、短行、分页或基于截图的格式反馈任务，应先阅读 references/layout-debugging.md，优先使用页面/对象特定的局部修改而非一次性全局参数调整。