pdf-skill

PDF スキル

目的

PDF のプログラムによる生成、解析、操作に関する専門知識を提供します。PDFKit、PDF.js、Puppeteer などのツールを使った PDF の新規作成、コンテンツの抽出、文書の結合・分割、フォームの処理を専門とします。

使用する場面

• プログラムで PDF を生成する
• PDF からテキストやデータを抽出する
• PDF 文書を結合または分割する
• プログラムで PDF フォームに入力する
• HTML を PDF に変換する
• 透かしや注釈を追加する
• PDF の構造やメタデータを解析する
• PDF レポート生成ツールを構築する

クイックスタート

このスキルを呼び出す場面：

• コードやデータから PDF を生成する
• PDF ファイルからコンテンツを抽出する
• PDF を結合、分割、または操作する
• PDF フォームに入力する、または作成する
• HTML／ウェブページを PDF に変換する

呼び出さない場面：

• Word 文書の作成 → /docx-skill を使用
• Excel／スプレッドシートの作業 → /xlsx-skill を使用
• PowerPoint の作成 → /pptx-skill を使用
• 一般的なファイル操作 → Bash またはファイルツールを使用

判断の枠組み

PDF Operation?
├── Generate from scratch
│   ├── Simple → PDFKit (Node) / ReportLab (Python)
│   └── Complex layouts → Puppeteer/Playwright + HTML
├── Parse/Extract
│   ├── Text extraction → pdf-parse / PyPDF2
│   └── Table extraction → Camelot / Tabula
├── Manipulate
│   └── pdf-lib (merge, split, edit)
└── Forms
    └── pdf-lib (fill) / PDFtk (advanced)

主なワークフロー

1. PDFKit による PDF 生成

1. PDFKit をインストールする（npm install pdfkit）
2. 新しい PDDocument を作成する
3. コンテンツ（テキスト、画像、グラフィック）を追加する
4. フォントと色でスタイルを設定する
5. 必要に応じてページを追加する
6. ファイルまたはレスポンスにパイプする

2. HTML から PDF への変換

1. Puppeteer／Playwright を設定する
2. HTML コンテンツまたは URL に移動する
3. ページサイズと余白を設定する
4. 印刷オプション（ヘッダー、フッター）を設定する
5. PDF バッファを生成する
6. 結果を保存またはストリーミングする

3. PDF の解析と抽出

1. パーサー（pdf-parse、PyPDF2、pdfplumber）を選択する
2. PDF ファイルを読み込む
3. テキストまたは構造化データを抽出する
4. 複数ページの文書を処理する
5. 抽出したテキストをクリーニングして正規化する
6. 希望する形式で出力する

ベストプラクティス

• 可能な場合はラスター画像よりベクターグラフィックを使用する
• 一貫したレンダリングのためにフォントを埋め込む
• さまざまな PDF リーダーで出力をテストする
• 大きな PDF はストリーミングで処理する
• タスクの複雑さに応じたライブラリを使用する
• アクセシビリティを考慮する（タグ付き PDF）

アンチパターン

アンチパターン	問題	適切な方法
画像のみの PDF	検索やアクセシビリティに対応できない	フォントを使ったテキストを使用する
フォントを埋め込まない	レンダリングの問題	必要なフォントを埋め込む
大きな PDF をメモリに読み込む	クラッシュ	ストリーム処理する
暗号化を無視する	セキュリティ／アクセスの問題	暗号化された PDF を処理する
タスクに不適切なツール	過剰な設計	複雑さに合ったツールを選ぶ