用途：在已有 latex/main.tex（通常来自 latex-scaffold）时，确认项目能否编译并输出失败原因报告，适用于 latex compile、build PDF、LaTeX errors、missing refs、编译PDF、引用错误等触发场景。
主要能力：运行 LaTeX 构建（可用时使用 latexmk -xelatex -bibtex），修复缺失宏包、缺失文献条目与未解析引用；成功时生成 latex/main.pdf，并始终写入 output/LATEX_BUILD_REPORT.md（成功或失败均写），报告在可用时包含页数与警告摘要。该步骤是确定性的：编译失败时记录可操作的诊断信息，而非猜测。
输入与输出：输入为 latex/main.tex 与 citations/ref.bib；输出为 latex/main.pdf（仅在编译成功时存在）与 output/LATEX_BUILD_REPORT.md（推荐）。
使用方式： uv run python .codex/skills/latex-compile-qa/scripts/run.py --help uv run python .codex/skills/latex-compile-qa/scripts/run.py --workspace <workspace> 完整选项见 --help；通过 pipeline 使用时，输入与输出由 unit runner 提供。
质量门禁：latex/main.pdf 仅在编译成功时存在；失败的构建必须删除过期的 PDF，并在 output/LATEX_BUILD_REPORT.md 中说明失败原因。对 arxiv-survey-latex 交付物：latex/main.pdf 需不少于 8 页，且无未定义引用或参考文献（严格门禁）。
限制与排查：若 latexmk 不在 PATH 中，报告会提示 latexmk not found，通常是未安装 LaTeX 工具链，需安装含 latexmk 的 TeX 发行版；若无法安装工具，可仍用 latex-scaffold 生成 latex/main.tex 并在别处编译。若出现文献/引用错误，需确认 latex/main.tex 指向 ../citations/ref.bib（或正确相对路径），且所有引用键存在于 citations/ref.bib。恢复步骤：读取 output/LATEX_BUILD_REPORT.md 末尾的首个可操作错误，并确认 latex/main.tex 存在且文献路径正确。