Supervisor-Skills 投稿前 LaTeX 格式自查指南:L1–L13 规则、文件组织与修改稿规范
Supervisor-Skills 投稿前 LaTeX 格式自查指南:L1–L13 规则、文件组织与修改稿规范
导读
本文以 Supervisor-Skills 开源仓库中 pre-submission-reviewer(投稿前审查)技能的核心参考文档 latex-rules.md 为主体,系统讲解论文投稿与修改稿阶段必须遵守的 13 条 LaTeX 格式规则(L1–L13),覆盖文件组织、宏定义、引用、标签、图表、公式、引号破折号与修改稿标注八大板块。读完本文,你将拿到一份可逐条机械执行的格式自查清单,并能将它与仓库中的 pre-submission-reviewer 技能、写作细节与 Checklist 以及 lint 脚本 配合使用,在正式提交前把最容易惹恼审稿人的格式问题一次性扫清。
一、这套规则的定位:审查流程中的"格式维度"
在 Supervisor-Skills 的投稿前审查流程中,pre-submission-reviewer 技能对论文进行五个维度的结构化审查:宏观逻辑、写作细节、英语语法、LaTeX 格式、图表质量。其中第四维度(Dimension 4: LaTeX format review)明确引用本规则文档作为"LaTeX 专属问题的规范清单",并列出六项核心检查点(见 SKILL.md):
- 公式编号连续,且每个编号公式都被正文引用;
- 图表必须有 caption,且 caption 描述详细;
- 引用使用正确的命令和非断行波浪号(例如
ResNet~\cite{X},绝不允许ResNet\cite{X}); - 标签使用下划线,不使用空格或连字符;
- 矢量图格式,杜绝位图;
- 页数限制合规。
规则文档将所有这些要求提炼为编号规则 L1–L13,每个规则都可独立检查、独立引用、独立修复。这正是它作为"机械规则"的价值:不需要审美判断,只需要逐一核对。其中,破坏规则的行为还会被映射到技能自带的严重度体系(CRITICAL / MAJOR / MINOR),例如最终稿中出现位图是 CRITICAL(阻止投稿),正文中出现 em-dash 是 MAJOR(一审会被点名)。
二、文件组织:多章节论文的标准目录结构
规则文档建议:多章节论文应将内容拆分到 sections/ 目录下的独立文件中,由 main.tex 通过 \input{sections/...} 引入。典型结构如下(见 latex-rules.md):
sections/
figs/
exps/
algs/
main.tex
commands.tex
bibfile.bib
这一结构与仓库中博导写作手册 3.5_写作细节与Checklist.md 给出的目录模板完全一致,后者在投稿修改(Revision)场景下还会扩展出 responses/ 目录,我们将在第八节展开。
对于极短的论文,把所有内容内联在单个 main.tex 中也可以接受,但规则文档明确指出其代价:多人协作时更难做版本控制。从工程角度看,按章节拆分的价值在于:
- 冲突最小化:多个作者同时编辑不同章节文件,不会在同一个文件上产生合并冲突;
- 审查可聚焦:投稿前审查可以只把关键章节(如 Introduction、Method、Experiments)单独交给审稿技能,而不是每次都扫整个文件;
- 修改稿可追踪:结合
responses/目录,每一轮 reviewer 意见对应的修改都可以精确落在独立文件里。
三、宏定义:把"改一处全文生效"变成常态
规则文档强烈建议为高频重复出现的字符串定义宏:系统名、方法名、容易拼错的单词、高频使用的强调样式。典型示例写在 commands.tex 中:
\newcommand{\sys}{\texttt{Alpha-SQL}\xspace}
\newcommand{\hi}[1]{\vspace{.25em}\noindent \textbf{#1}}
\newcommand{\lgl}[1]{\textcolor{blue}{LGL: #1}}
\newcommand{\revision}[1]{\textcolor{blue}{#1}}
四个宏各有用途:
\sys:系统名,用\texttt等宽字体渲染,\xspace负责在词尾自动处理空格(需要xspace宏包支持);\hi:段落引导语(Leading Text),在段前留0.25em垂直间距、缩进归零、加粗输出;\lgl:导师/协作批注,蓝色显示并带LGL:前缀,便于在稿中区分他人意见;\revision:修改稿中标记修改处的核心宏,蓝色显示(详见第八节)。
使用宏的核心收益是:改名变成一行修改,而不是跨几十个小节查找替换。规则文档的原话是:当系统名在修改中期发生变化时,宏是唯一需要改动的地方。写作手册中有一个生动的实例佐证:投稿初期方法叫 MCTS-SQL,定稿前决定改叫 Alpha-SQL,如果当初定义了 \sys 宏,只需改一次命令即可全文生效,彻底避免"改漏"的风险(见 3.5_写作细节与Checklist.md)。同理,容易拼错的术语、反复出现的强调短语,都应当沉淀为宏。
四、引用规范:L1–L3
L1:单词与引用之间必须用非断行波浪号
引用最容易出现的排版问题,是 \cite 前面换行导致引用编号被甩到下一行行首。规则文档给出的正反例对照表:
| Bad | Good |
|---|---|
ResNet\cite{X} |
ResNet~\cite{X} |
ResNet \cite{X} |
ResNet~\cite{X} |
注意第二种 bad 写法连普通空格都不行,必须替换为 ~。多个引用应当合并进同一条命令:
Artificial Intelligence~\cite{xxxx, yyyy, zzzz}
这样既避免换行割裂,又保证多条引用在编号列表中按序排布。写作手册也把这条列为硬性细节:"Figure~\ref{***} 用 ~ 防止不应该的分行"(见 3.5_写作细节与Checklist.md)。
L2:引用风格必须与目标会议匹配
规则文档明确:ACL 系使用 natbib,括号引用用 \citep、正文叙述引用用 \citet;数据管理方向(SIGMOD、VLDB)使用 IEEE 或 ACM 数字编号风格。投稿前必须按目标 venue 转换。这条规则的实操含义是:不要把 A 会议模板下写好的引用命令直接搬进 B 会议,\citet/\citep 与 \cite 混用、或数字风格与作者-年份风格混排,都是审稿阶段会立刻被发现的格式错误。
L3:bib 条目必须字段完整
规则文档要求每条 bib 记录必须包含会议名、年份、页码、作者、标题,并建议从 DBLP 复制以确保正确性。字段缺失(缺页码、缺会议名)在生成参考文献表时会直接表现为排版空洞,而且作者名、年份的错误还会影响审稿人对"你是否真正读过这篇工作"的判断。对于投稿前审查技能而言,引用元数据的核验属于"可检索条件下"的检查项(novelty verification 与 citation completeness),见 SKILL.md。
五、标签与交叉引用:L4–L5
L4:标签命名用下划线加前缀
规则文档给出明确的标签命名规范:
\label{fig:system_overview}(好,前缀fig:+ 下划线连接);\label{sec:intro}(好,前缀sec:);\label{system overview}(坏,含空格);\label{system-overview}(坏,连字符会破坏某些引用解析)。
写作手册进一步解释:所有文件名、文件夹名、内部引用的 label 都不要出现空格,也不要用减号连接,一律使用下划线连接,并使用前缀增加可读性(见 3.5_写作细节与Checklist.md)。前缀体系建议至少覆盖 fig:、sec:、tab:、eq:、alg:,这样看到标签就能判断它指向哪类对象,也避免不同类对象之间标签撞名。
L5:交叉引用同样使用非断行波浪号
as shown in Figure~\ref{fig:system_overview}
discussed in Section~\ref{sec:intro}
与 L1 同理,\ref 前也要用 ~,防止"Figure"与编号之间断行。这条与 L1 一起构成了全文排版稳定性的基础。
六、图表规范:L6–L9
L6:每张图和表都必须有 caption,且描述发现而非仅仅描述设置
规则文档特别强调:尤其对实验图,caption 要描述 finding(发现了什么),而不是只描述 setup(实验怎么设置的)。这与仓库中 figure-designer 技能对实验图"caption 首句即结论"的要求一脉相承(见 figure-designer)。一个只写"不同方法在数据集上的准确率对比"的 caption 没有任何信息量;应当写成"本文方法在 X 数据集上以 3.2% 的绝对提升优于所有基线"。
L7:默认置顶 [t!],置底 [b!] 兜底,放弃 [h]
规则文档的结论是:默认使用 <a href="https://link.gitcode.com/i/cd0ca9ca8450ee3a44da530ac990d5d8" target="_blank">t!] 将图表放在页首;如果顶部放不下,[b!](页底)可以接受;行内 [h] 很少能正常工作,应当交给 LaTeX 自己决定浮动位置。写作手册也给出了同样的建议:"无特殊情况下,论文中图片表格一般置顶!如果实在不合适可以考虑置底 [b!]"(见 [3.5_写作细节与Checklist.md)。反复尝试 [h] 并手工调整空白的"排版体操",在审稿版本里往往适得其反。
L8:必须使用矢量格式,拒绝位图
规则文档明确:图表使用 PDF、EPS、SVG 等矢量格式;最终稿中绝不允许插入 PNG 或 JPG 截图,放大后会像素化。这也是 SKILL.md 中 CRITICAL 级问题的判定标准之一("raster figure in final draft" 直接阻止投稿)。写作手册对此的解释是:"图片应使用 pdf、svg 等矢量图格式,不然如果用 png、jpg 放大会模糊"(见 3.5_写作细节与Checklist.md)。实操建议:所有曲线图、架构图从绘制工具导出时直接选 PDF/EPS;只有无法矢量化的照片类素材(如显微镜照片)才允许位图,且应保证分辨率足够。
L9:正文必须在其出现之前引用图表
规则文档给出的范式是 "Figure 2 shows..."。任何图表在正文中没有前置引用、突兀出现在页面上,都意味着读者不知道为什么要看它。这也是图表的"自包含"要求:先告诉读者去看什么,再展示图表本身。
七、公式规范:L10–L11
L10:每个编号公式至少被正文引用一次
公式编号存在的唯一理由是"被引用"。规则文档给出两条出路:要么在正文中引用它,要么去掉编号改用 \begin{equation*}(无编号公式环境)。投稿前审查技能的检查项"every numbered equation referenced"正是执行这条规则(见 SKILL.md)。未被引用的编号公式既浪费编号序列,又让审稿人困惑"这个编号给谁看"。
L11:公式编号段内连续,且每个编号公式都要有 \label
规则文档要求公式编号在一个 section 内连续,并为每个编号公式加 \label,这样后续重排公式顺序时无需手工重新编号,\ref{eq:...} 会自动跟随。与之配套的命名规范沿用 L4 的前缀体系:eq:xxx。手工维护公式编号是修改稿阶段最容易出错的地方,加一条 \label 就能把"编号维护"这件事完全交给 LaTeX。
八、引号与破折号:L12–L13
L12:引号必须使用 LaTeX 惯例
规则文档明确:
- 双引号:左引号用两个反引号
``,右引号用两个单引号''; - 单引号:左引号用单个反引号
`,右引号用单个单引号'; - 绝不使用 ASCII 直引号
"。
写作手册的检查清单里也有对应条目:"LaTeX 中双引号问题:使用 `` 和 '' 而不是 ""(见 3.5_写作细节与Checklist.md)。直引号在 LaTeX 中会渲染成丑陋的"打字机引号",是审稿人一眼就能看到的低级格式错误。
L13:三种破折号各司其职,正文禁用 em-dash
LaTeX 中有三种长度不同的横线,用途完全不同:
- 连字符
-:复合形容词,如 high-efficiency、zero-shot; - 短破折号
--(en-dash):数字范围,如 pages 10--15、2024--2026; - 长破折号
---(em-dash):语义停顿。
规则文档特别强调一条项目规则:正文中不要使用 em-dash,改用逗号、冒号或句号。这一规则在仓库中得到了双重强化:
- forbidden-patterns.md 将"em-dash 用作句子连接符"列为禁用模式,并给出两种典型误用及改写方案:连接两个独立子句时改用逗号加从句;插入插入语时改用从属从句。它给出的检测方法是直接 grep Unicode em-dash 字符,正文中每出现一处即为一个 finding,默认 MAJOR;
- lint_skills.py 将 em-dash(U+2014)写进 lint 检查逻辑,
SKILL.md及其references/*.md中一旦出现该字符即报违规,用脚本级手段保证整个技能库自身的文档也遵守这条写作纪律。
对于 LLM 辅助写作尤其需要警惕:AI 生成的英文文本对 em-dash 有强烈的使用倾向,这正是"AI 味"的识别信号之一。投稿前用 grep "—" 全文扫一遍是成本最低、回报最高的机械检查。
九、修改稿规范:让审稿人一眼看懂你改了什么
对于修订投稿(revision submissions),规则文档要求把审稿历史保存在独立文件中,形成如下结构:
responses/
meta.tex
r1.tex
r2.tex
r3.tex
配套的标注约定(对应写作手册 3.5_写作细节与Checklist.md):
1. 修改处标蓝:正文中的修改位置用 \revision{...} 包裹(即第三节中定义的蓝色宏),审稿人翻到论文正文就能直接看到所有改动,无需对照 response 逐条寻找:
\newcommand{\revision}[1]{\textcolor{blue}{#1}}
2. 页边标注:用 \marginpar 在页边标出该处修改对应的审稿意见编号,右栏标注和左栏标注分别对应不同写法:
\marginpar[]{\revision{R1.W1}}{\revision{text}}
\marginpar[\revision{R3.W2}]{}{\revision{text}}
其中 R1.W1 表示"第一轮审稿人的第一条 weakness",R3.W2 表示"第三轮审稿人的第二条 weakness",\revision{text} 是页边显示的响应文本。
3. 响应文件以汇总表开头:规则文档要求每个 r<n>.tex 文件的第一段内容就是汇总表,列出审稿人意见编号、对应修改内容、修改涉及的章节(例如 "R1.W1, clarify the motivation, section 1"),让审稿人一眼看清这一轮做了什么。写作手册给出的 main.tex 模板还展示了如何在论文开头统一挂载这些响应文件:
\section*{Response to Reviewer Comments}
Dear Reviewers,
Thank you for your insightful reviews and constructive suggestions, based on which
we have significantly improved our paper. The major revised parts are highlighted
in \revision{blue} in the paper.
\input{response/r1}
\input{response/r2}
\input{response/r3}
这套约定的本质是把"修改可审计"变成排版事实:蓝色标注让修改位置可见,页边编号让修改可溯源到具体意见,汇总表让响应结构一目了然。仓库中的 rebuttal-guidance 技能(SKILL.md)负责回答"怎么回应审稿人",而本节规范负责"让回应在版面上被看见",两者配合才能形成完整的修改稿闭环。
十、落地:投稿前 15 分钟跑完的格式自查清单
将 L1–L13 与审查技能的分工结合,可以形成一份可逐条勾选的投稿前自查清单:
| 规则 | 检查动作 | 违反后果(严重度参照) |
|---|---|---|
| 文件组织 | 多章节论文是否拆分到 sections/,main.tex 是否用 \input 引入 |
可维护性差(MINOR) |
| 宏定义 | 系统名、易错术语是否定义在 commands.tex |
改名时易改漏(MINOR) |
| L1/L5 | grep 检查 \cite、\ref 前是否都是 ~,是否出现裸空格 |
换行割裂(MINOR/MAJOR) |
| L2 | 引用命令是否与目标 venue 风格匹配(\citep/\citet vs 数字风格) |
格式不符(MAJOR) |
| L3 | bib 条目是否含会议名、年份、页码、作者、标题 | 参考文献不完整(MAJOR) |
| L4 | label 是否全用下划线 + 前缀,无空格、无连字符 | 引用解析失败(MAJOR) |
| L6 | 每个图/表是否有 caption,实验图 caption 是否描述 finding | 无 caption(CRITICAL) |
| L7 | 浮动位置是否 [t!] 优先,是否还在用 [h] |
排版混乱(MINOR) |
| L8 | 最终稿是否有 PNG/JPG 图,是否全部为矢量格式 | 位图入稿(CRITICAL) |
| L9 | 每个图表是否在正文中被前置引用 | 读者不知所指(MAJOR) |
| L10 | 每个编号公式是否被引用;未引用的是否改用 equation* |
编号无意义(MINOR) |
| L11 | 编号是否段内连续,每个编号公式是否带 \label |
重排时手工编号出错(MINOR) |
| L12 | grep '"' 检查是否出现 ASCII 直引号 |
低级格式错误(MINOR) |
| L13 | grep "—"(U+2014)扫描全文 em-dash,正文出现即处理 |
每处默认 MAJOR |
| 修改稿 | 是否建 responses/,\revision 标蓝、\marginpar 标编号、汇总表置首 |
修改不可审计(MAJOR) |
在 pre-submission-reviewer 技能 的严重度体系中,上述规则可以更精确地映射:最终稿位图是 CRITICAL(阻止投稿)、缺失关键基线与页数超限同理;em-dash 出现 5 处以上、公式编号不连续等为 MAJOR(一审必被点名);单处引号、单处标点问题为 MINOR(润色即可)。执行顺序建议是:先用 grep 家族把 L12/L13 这类纯字符扫描全部跑完(秒级完成),再对照 L1–L11 逐条人工核查图表、公式与引用,最后把修改稿的 responses/ 结构与 \revision/\marginpar 标注核对一遍,15 分钟内即可完成。
十一、与仓库其他模块的协同
这套 LaTeX 规则不是孤立存在的,它嵌入在 Supervisor-Skills 的完整投稿链路中:
- 写稿阶段:tech-paper-template、paper-writer 负责把 Idea 变成结构完整的草稿,写作手册 3.5_写作细节与Checklist.md 提供从选题到细节的全程 checklist;
- 润色阶段:paper-polish 在"不改变科学含义"的前提下修复语法、校准语气、去除 AI 味;
- 审查阶段:pre-submission-reviewer 在投稿前 3–5 天对全文做五维审查,其中第四维直接执行本规则文档;
- 图件阶段:figure-designer 与 drawio-reconstruction 保证动机图、总览图、实验图既符合设计范式,又能以矢量格式交付,支撑 L8 规则;
- 修改阶段:rebuttal-guidance 负责审稿意见的回应策略,本文第八节负责让回应在版面上可审计。
最终,这些规则与技能共同服务于一个目标:让作者把有限的精力留给真正的科研判断,而把格式这种"确定性工作"交给可复用的规则与工具。
<输出文章>