用途:把已批准的 Markdown 草稿(output/DRAFT.md 或 output/TUTORIAL.md)转换为最小可编译的 LaTeX 项目,适用于需要 LaTeX/PDF 交付的场景(如 arxiv-survey-latex 流程)。这是确定性转换步骤,正文质量应已在草稿阶段处理完毕。
主要能力:生成 latex/main.tex 及必要的 LaTeX 支持文件;按大纲生成章节;当 citations/ref.bib 存在时接入参考文献。转换规则包括:##/###/#### 标题转为 \section/\subsection/\subsubsection 并去掉 1.2 之类数字前缀;以 Appendix/附录 开头的标题触发一次 \appendix 并作为附录章节;Markdown 表格前的 Table 1. ... 等加粗题注转为带 \caption 与稳定 \label{tab:...} 的表格浮动体;## Abstract 转为 abstract 环境;[@Key] 或 [@Key1; @Key2] 转为 \citep{Key} / \citep{Key1,Key2};行内 粗体、斜体、代码 转为 \textbf{}、\emph{}、\texttt{}。
布局策略:布局契约位于 assets/layout_profiles.json。默认配置为 A4、1in 页边距、含目录、可拆分大表格;course_paper 配置为 A4、0.9in 页边距、省略目录、尽量保持紧凑表格完整、仅参考文献用 \small,正文保持 11pt,用于满足明确页数范围。默认语言为 article;若草稿含 CJK 字符则切换为 ctexart。
使用方式:uv run python .codex/skills/latex-scaffold/scripts/run.py --help;uv run python .codex/skills/latex-scaffold/scripts/run.py --workspace <workspace>。通过 pipeline 使用时输入输出由 unit runner 提供。
检查项:latex/main.tex 存在;若 citations/ref.bib 存在,main.tex 引用它。
限制与排错:若生成的 main.tex 仍含 Markdown 标记,需重跑并确保草稿干净;若引用缺失,需确认 ref.bib 存在且已接入,再用 latex-compile-qa 编译。