pdf-processing-openai

PDF スキル

使用する場面

• レイアウトやビジュアルが重要な PDF の内容を読んだり、確認したりする場合。
• 信頼性の高い書式で、プログラムから PDF を作成する場合。
• 納品前に最終的なレンダリング結果を検証する場合。

ワークフロー

1. まずビジュアルで確認します。PDF ページを PNG にレンダリングして、内容を確認します。
   • 利用可能であれば、pdftoppm を使用します。
   • 利用できない場合は、Poppler をインストールするか、出力をローカルで確認するようユーザーに依頼します。
2. 新しいドキュメントを作成するときは、reportlab を使用して PDF を生成します。
3. テキストの抽出や簡易的な確認には pdfplumber（または pypdf）を使用します。レイアウトの忠実性を確認する目的では使用しないでください。
4. 意味のある更新を行うたびにページを再レンダリングし、配置、間隔、読みやすさを確認します。

一時ファイルと出力に関する規則

• 中間ファイルには tmp/pdfs/ を使用し、作業終了後に削除します。
• このリポジトリで作業する場合、最終成果物は output/pdf/ に保存します。
• ファイル名は安定した、内容のわかりやすいものにします。

依存関係（不足している場合はインストール）

依存関係の管理には uv を優先して使用します。

Python パッケージ：

uv pip install reportlab pdfplumber pypdf

uv が利用できない場合：

python3 -m pip install reportlab pdfplumber pypdf

システムツール（レンダリング用）：

# macOS (Homebrew)
brew install poppler

# Ubuntu/Debian
sudo apt-get install -y poppler-utils

この環境でインストールできない場合は、不足している依存関係と、ローカル環境でのインストール方法をユーザーに伝えます。

環境

必須の環境変数はありません。

レンダリングコマンド

pdftoppm -png $INPUT_PDF $OUTPUT_PREFIX

品質基準

• タイポグラフィ、間隔、余白、セクションの階層に一貫性を持たせ、洗練されたビジュアルデザインを維持します。
• テキストの欠け、要素の重なり、表の崩れ、黒い四角、判読できないグリフなどのレンダリング上の問題を避けます。
• グラフ、表、画像は鮮明で、配置が整い、ラベルが明確である必要があります。
• ASCII ハイフンのみを使用します。U+2011（ノーブレークハイフン）やその他の Unicode ダッシュは使用しないでください。
• 引用と参照は人が読める形式にします。ツールトークンやプレースホルダー文字列を残さないでください。

最終確認

• 最新の PNG を確認し、ビジュアルまたは書式上の不備がゼロであることを確認するまで、納品しないでください。
• ヘッダー、フッター、ページ番号、セクション間の切り替わりが洗練された状態であることを確認します。
• 中間ファイルは整理するか、最終承認後に削除します。