empiricalwiki: Skill for Claude Code

/paper-compile

编译 LaTeX 论文为 PDF，自动修复常见错误，验证提交要求。 输入 paper/ 目录（由 /paper-draft 生成），执行 latexmk 编译， 解析错误并尝试自动修复（缺失包、引用未定义、figure 路径）， 验证页数限制、匿名合规、字体嵌入、[UNCONFIRMED] 标记清除。 生成提交清单。

Inputs

• paper_dir（可选，默认 paper/）：LaTeX 项目目录，包含 main.tex
• --fix（可选）：启用自动修复模式（自动安装缺失包、修正路径）
• --checklist（可选）：生成详细提交清单（不编译，只检查）

Outputs

• paper/main.pdf — 编译后的 PDF
• COMPILE_REPORT（输出到终端）— 编译状态、检查结果、提交清单
• 若 --fix：修改的 .tex 文件（自动修复）

Wiki Interaction

Reads

• wiki/outputs/paper-plan-*.md — 获取 venue 信息（页数限制、匿名要求）
• .claude/skills/shared-references/citation-verification.md — [UNCONFIRMED] 标记检查规则

Writes

• paper/main.pdf — 编译输出
• wiki/log.md — 追加编译日志

Graph edges created

• 无

Workflow

前置：确认 paper/main.tex 存在。确认 latexmk 已安装（which latexmk）。

Step 1: 编译（Compile）

1. 首次编译：

   cd paper/ && latexmk -pdf -interaction=nonstopmode main.tex 2>&1
   

2. 解析编译输出：

   • 收集所有 errors（! ...）
   • 收集所有 warnings（Warning: / Overfull / Underfull）
   • 分类：
     • Missing package：! LaTeX Error: File 'xxx.sty' not found
     • Undefined reference：LaTeX Warning: Reference 'xxx' on page N undefined
     • Undefined citation：LaTeX Warning: Citation 'xxx' on page N undefined
     • Missing figure：! LaTeX Error: File 'figures/xxx' not found
     • Syntax error：其他 ! 开头的错误
     • Overfull/Underfull：排版警告（非阻塞）

3. 若编译成功（main.pdf 生成）：进入 Step 3

4. 若编译失败：进入 Step 2

Step 2: 自动修复（Auto-Fix）

若 --fix 启用，尝试自动修复每种错误类型：

2a. Missing package：

# 检查是否为 TeX Live 可安装包
tlmgr info {package-name} 2>/dev/null
# 若可安装且用户确认：
tlmgr install {package-name}

若无法安装：注释掉 \usepackage{xxx} 行并标注 % TODO: install package {xxx}

2b. Undefined reference/citation：

• Undefined reference：检查对应 \label{} 是否存在，若不存在则添加占位 label
• Undefined citation：检查 references.bib 是否包含该 key
  • 若不包含：尝试从 wiki papers 匹配并添加 [UNCONFIRMED] 条目
  • 若包含但 bibtex 未运行：重新运行 latexmk（通常 latexmk 自动处理）

2c. Missing figure：

• 检查 paper/figures/ 中是否存在不同扩展名的文件（.pdf vs .png vs .eps）
• 若找到：修正 \includegraphics 路径
• 若找不到：替换为占位符 \missingfigure{xxx}（需要 todonotes 包）