latex-compile-qa

LaTeX コンパイル＋QA

トリガーとルーティング

• トリガー: LaTeX のコンパイル、PDF のビルド、LaTeX エラー、参照の欠落、编译PDF、引用错误。
• 使用する場面: latex/main.tex（通常は latex-scaffold から生成）がすでにあり、コンパイルできることを確認して、失敗原因のレポートを出力する必要がある場合。

LaTeX プロジェクトをコンパイルし（ツールチェーンを利用できる場合）、PDF と簡潔なビルドレポートを作成します。

このステップは決定的です。コンパイルに失敗した場合は、推測せず、実行可能な診断情報を記録してください。

入力

• latex/main.tex
• citations/ref.bib

出力

• latex/main.pdf（コンパイルに成功した場合）
• output/LATEX_BUILD_REPORT.md（推奨）

ワークフロー

1. 利用可能な場合は、latexmk などを使って LaTeX をビルドします。
2. 不足しているパッケージ、参考文献エントリ、未解決の参照を修正します。
3. 残っている問題をビルドレポートに記録します。

品質チェックリスト

• latex/main.pdf が存在するのはコンパイルに成功した場合のみです。ビルドに失敗した場合は、古い PDF を削除し、失敗の原因を output/LATEX_BUILD_REPORT.md に記載してください。
• arxiv-survey-latex の成果物の場合：latex/main.pdf は 8 ページ以上で、未定義の引用・参照がないこと（厳格なゲート）。

スクリプト

クイックスタート

• 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 を参照してください（パイプライン経由で使用する場合、入出力はユニットランナーから取得されます）。

例

• コンパイル＋レポートを作成：
  • uv run python .codex/skills/latex-compile-qa/scripts/run.py --workspace <workspace>

注記

• 利用可能な場合は latexmk -xelatex -bibtex を使用します。
• 成功・失敗にかかわらず、常に output/LATEX_BUILD_REPORT.md を書き込みます。
• 利用可能な場合、レポートにはページ数と警告の概要が含まれます。

トラブルシューティング

よくある問題

問題：latexmk が見つからない

症状：

• ビルドレポートに「latexmk not found in PATH」と表示されます。

原因：

• LaTeX ツールチェーンがインストールされていません。

解決策：

• latexmk を含む TeX ディストリビューションをインストールしてください。
• ツールをインストールできない場合でも、latex-scaffold を使って latex/main.tex を生成し、別の環境でコンパイルしてください。

問題：BibTeX／参照エラーでビルドに失敗する

症状：

• レポートに引用・参照の欠落、または BibTeX エラーが表示されます。

原因：

• citations/ref.bib が存在しない、正しく接続されていない、またはドラフトに無効な引用キーが含まれています。

解決策：

• latex/main.tex が ../citations/ref.bib（または正しい相対パス）を参照していることを確認してください。
• すべての引用キーが citations/ref.bib に存在することを確認してください。

復旧チェックリスト

• output/LATEX_BUILD_REPORT.md の末尾を確認し、最初の実行可能なエラーを探します。
• latex/main.tex が存在し、参考文献のパスが正しいことを確認します。