pptx-skill

PPTX スキル

目的

プログラムによる PowerPoint プレゼンテーションの作成、編集、自動化に関する専門知識を提供します。python-pptx（Python）と PptxGenJS（JavaScript）を使用した動的なスライドデッキの生成と、プレゼンテーションのワークフローの自動化を専門とします。

使用する場面

• プログラムでプレゼンテーションを生成する
• データソースからスライドを作成する
• 既存の PowerPoint ファイルを変更する
• 自動レポート生成ツールを構築する
• スライドにグラフや表を追加する
• テンプレートやブランディングを適用する
• プレゼンテーションからコンテンツを抽出する
• 複数のプレゼンテーションを一括処理する

クイックスタート

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

• コードから PowerPoint ファイルを作成するとき
• スライド生成を自動化するとき
• 既存の PPTX ファイルを変更するとき
• プレゼンテーションのテンプレートを構築するとき
• スライドからデータを抽出するとき

次の場合は呼び出さないでください：

• PDF の生成 → /pdf-skill を使用してください
• Word 文書 → /docx-skill を使用してください
• Excel ファイル → /xlsx-skill を使用してください
• 手動でのプレゼンテーションデザイン → 適切なデザインツールを使用してください

判断フレームワーク

PPTX Operation?
├── Generate from Scratch
│   ├── Python → python-pptx
│   └── JavaScript → PptxGenJS
├── Modify Existing
│   └── python-pptx (read + modify)
├── Template-Based
│   └── Load template, fill placeholders
└── Extract Content
    └── python-pptx for reading

主なワークフロー

1. プレゼンテーションの生成（python-pptx）

1. python-pptx をインストールする
2. Presentation オブジェクトを作成する
3. レイアウトからスライドを追加する
4. コンテンツ（テキスト、画像、表）を追加する
5. 書式を適用する
6. プレゼンテーションを保存する

2. グラフの作成

1. グラフ用のデータを準備する
2. グラフデータオブジェクトを作成する
3. スライドにグラフを追加する
4. グラフの種類とオプションを設定する
5. グラフの要素にスタイルを適用する
6. 適切な位置とサイズに調整する

3. テンプレートを使った生成

1. プレースホルダーを含むマスターテンプレートを作成する
2. コードでテンプレートを読み込む
3. プレースホルダーの図形を特定する
4. プレースホルダーのコンテンツを置き換える
5. 必要に応じて動的なスライドを追加する
6. 新しいファイルとして保存する

ベストプラクティス

• テンプレートのスライドレイアウトを使用する
• テキストをプレースホルダーの範囲内に収める
• データに適したグラフの種類を使用する
• スタイルに一貫性を保つ
• PowerPoint で出力をテストする
• フォントが見つからない場合も適切に処理する

アンチパターン

アンチパターン	問題	正しい方法
レイアウトを無視する	書式に一貫性がなくなる	スライドレイアウトを使用する
位置をハードコードする	レイアウトが崩れる	プレースホルダーを使用する
1 枚のスライドにテキストを詰め込みすぎる	読みにくくなる	コンテンツを絞り、箇条書きを使用する
テンプレートがない	スタイルを毎回作り直すことになる	再利用可能なテンプレートを作成する
エラー処理がない	ファイルが破損する	検証してエラーを処理する