PDF スキル は何をしますか?
使用するタイミング
- レイアウトやビジュアルが重要なPDFコンテンツを読んだりレビューしたりする場合。
- 信頼性の高いフォーマットでプログラム的にPDFを作成する場合。
- 納品前に最終レンダリングを検証する場合。
ワークフロー
- 視覚的なレビューを優先:PDFページをPNGにレンダリングし、検査します。
pdftoppmが利用可能な場合はそれを使用します。- 利用できない場合は、Poppler をインストールするか、ユーザーにローカルで出力を確認してもらいます。
- 新しいドキュメントを作成する際は、
reportlabを使用してPDFを生成します。 - テキスト抽出や簡単なチェックには
pdfplumber(またはpypdf)を使用しますが、レイアウトの忠実性をそれに頼ってはいけません。 - 意味のある更新のたびに、ページを再レンダリングし、配置、間隔、可読性を確認します。
一時ファイルと出力の規則
- 中間ファイルは
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検査で視覚的または書式の欠陥がゼロであることを確認するまで納品しないでください。
- ヘッダー/フッター、ページ番号、セクションの移行が洗練されていることを確認します。
- 中間ファイルは整理するか、最終承認後に削除します。