mcpField
P
paper-compilation

paper-compilation

github.com/lingzhi227ドキュメント4401.6k 回インストール35 週間前に更新
リポジトリ

paper-compilation について

paper-compilationは、LaTeX論文をPDFにコンパイルし、結果を確認するスキルです。引用や図ファイルを検証し、警告やスタイル上の問題を報告して、再試行時にエラーの自動修正を試みます。

主な機能

  1. 01LaTeX論文をPDFにコンパイル
  2. 02引用と図ファイルの検証
  3. 03警告とスタイル問題の報告
  4. 04一部エラーの自動修正
  5. 05修正後のコンパイル再試行

活用シーン

  1. 01論文PDFの生成
  2. 02引用と図の参照確認
  3. 03コンパイルエラーの診断と修正

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/lingzhi227/agent-research-skills --skill paper-compilation

インストール後、Claude Code で/paper-compilationを入力して読み込まれたか確認します。

同梱ファイルscripts/compile_paper.pyscripts/fix_latex_errors.py

詳細

論文のコンパイル

エラーの検出と修正を行いながら、LaTeX 論文を PDF にコンパイルします。

入力

  • $ARGUMENTS — メインの .tex ファイルへのパス

スクリプト

論文をコンパイルする
python ~/.claude/skills/paper-compilation/scripts/compile_paper.py paper/main.tex
python ~/.claude/skills/paper-compilation/scripts/compile_paper.py paper/main.tex --check-style
python ~/.claude/skills/paper-compilation/scripts/compile_paper.py paper/main.tex --output paper/output.pdf

レポート内容：コンパイル状況、ページ数、警告、引用・参照の統計、スタイル上の問題。

コンパイル前に引用を検証する
python ~/.claude/skills/citation-management/scripts/validate_citations.py \
  --tex paper/main.tex --bib paper/references.bib --check-figures --figures-dir paper/figures/
LaTeX エラーを自動修正する
python ~/.claude/skills/paper-compilation/scripts/fix_latex_errors.py \
  --tex paper/main.tex --log compile.log --output paper/main_fixed.tex

修正対象：LaTeX 内の HTML タグ、環境の不一致、図の不足。主なフラグ：--dry-run、--auto-detect

自動修正後に再試行してコンパイルする
python ~/.claude/skills/paper-compilation/scripts/compile_paper.py paper/main.tex --auto-fix

コンパイルが成功するまで、fix_latex_errors.py を実行して再コンパイルする処理を最大 3 ラウンド行います。

ワークフロー

ステップ 1：コンパイル前の検証

コンパイル前に問題を検出するため、validate_citations.py を実行します。

  • すべての \cite{key} に対応する .bib エントリがあること
  • すべての \includegraphics{file} のファイルが存在すること
  • ラベルやセクションが重複していないこと
ステップ 2：コンパイル

compile_paper.py を実行します。次の処理が行われます：pdflatex → bibtex → pdflatex → pdflatex

ステップ 3：エラー修正ループ（最大 5 ラウンド）

コンパイルに失敗した場合は、エラー出力を読み、次のように修正します。

  • ! Undefined control sequence → 不足しているパッケージを追加するか、誤字を修正します
  • ! Missing $ inserted → 数式を $...$ で囲みます
  • ! Missing } inserted → 対応していない波括弧を修正します
  • Citation 'key' undefined → .bib に追加するか、\cite を修正します
  • </end{figure}> → \end{figure} に置き換えます（LaTeX 内の HTML 構文）

最小限の修正を適用します。不要なパッケージは削除しないでください。修正のたびに再コンパイルします。

ステップ 4：コンパイル後のレポート

ページ数が投稿先の上限以内か、警告が残っていないか、chktex のスタイル上の問題がないかを確認します。

トラブルシューティング

pdflatex が見つからない
# macOS
brew install --cask mactex-no-gui
# Ubuntu
sudo apt install texlive-full
代替手段：latexmk（複数回の処理を自動で実行）
latexmk -pdf -interaction=nonstopmode main.tex

関連スキル

コメント

Markdown 対応