python-pptx-generator

Python PPTX ジェネレーター

概要

ユーザーが python-pptx を使って PowerPoint プレゼンテーションを作成する、すぐに実行できる Python スクリプトを求めているときにこのスキルを使用します。 トピックの概要を、実際のスライド内容、適切な構成、動作する保存ステップを備えた完全なスライドデッキスクリプトに変換することに重点を置いています。

このスキルを使用する場面

• ユーザーが .pptx ファイルを自動生成する Python スクリプトを求めているとき
• ユーザーがスライド内容を起草し、それを直接 python-pptx にエンコードする必要があるとき
• ユーザーがデモ、授業、社内説明会向けの手軽なプレゼンテーションジェネレーターを求めているとき

仕組み

ステップ 1: デッキの概要を収集する

リクエストにまだ含まれていない場合は、トピック、対象 audience、トーン、目標スライド数を確認します。 制約が欠けている場合は、保守的なデフォルトを選び、生成されるスクリプトのコメントに明記します。

ステップ 2: ナラティブの流れを計画する

コードを書く前にデッキのアウトラインを作成します:

1. タイトルスライド
2. アジェンダまたはコンテキスト
3. 中心となる教育またはビジネスのポイント
4. まとめまたは次のステップ

要求された audience に対して現実的なスライド数に保ち、埋め合わせのスライドは避けます。

ステップ 3: Python スクリプトを生成する

以下を行う完全なスクリプトを作成します:

• python-pptx から Presentation をインポートする
• デッキを作成する
• 適切な組み込みレイアウトを選択する
• 実際のタイトルと箇条書きを書く
• 明確なファイル名でファイルを保存する
• 保存後に成功メッセージを出力する

ステップ 4: 出力を実行可能に保つ

最終的な回答は、python-pptx をインストールすれば実行できる Python コードブロックにします。 疑似コード、プレースホルダー、欠落したインポートは避けます。

例

例 1: 教育用デッキ

User: Create a 5-slide presentation on the basics of machine learning for a high school class.
Output: A complete Python script that creates a title slide, overview, core concepts, examples, and recap.

例 2: ビジネス説明会

User: Generate a 7-slide deck for sales leadership on Q2 pipeline risks and mitigation options.
Output: A python-pptx script with executive-friendly slide titles, concise bullets, and a final recommendations slide.

ベストプラクティス

• ✅ ユーザーがカスタム配置を求めない限り、標準の python-pptx レイアウトを使用する
• ✅ プレースホルダーではなく、audience に適した箇条書きを書く
• ✅ スクリプト内で出力ファイルを明示的に保存する。例えば output.pptx
• ✅ スライドタイトルは短く、箇条書きの階層は読みやすく保つ
• ❌ ユーザーが残りを組み立てる必要がある部分的なスニペットを返さない
• ❌ python-pptx の機能を確認せずに、サポートされていないスタイリング API を勝手に作らない

セキュリティと安全性に関する注意

• python-pptx は、自分が管理する環境（例えばローカルの仮想環境）にのみインストールしてください
• ユーザーが共有マシンでスクリプトを実行する場合は、安全な出力パスを選び、確認なしに既存のプレゼンテーションを上書きしないでください
• リクエストに独自または機密のプレゼンテーション内容が含まれる場合は、公開サンプルやサンプルファイル名に含めないでください

よくある落とし穴

• 問題: 生成されたスクリプトが実際の内容ではなくプレースホルダーテキストを使用している
  解決策: まずナラティブを起草し、その後各スライドを具体的なタイトルと箇条書きに変換する

• 問題: デッキが要求された audience に対してスライド数が多すぎる
  解決策: ユーザーが明示的により長いデッキを求めない限り、アウトラインを最も重要な 4〜8 枚のスライドに圧縮する

• 問題: スクリプトが保存または完了メッセージの出力を忘れている
  解決策: 常に prs.save(...) と短い成功メッセージの出力で終える

関連スキル

• @pptx-official - 既存の PowerPoint ファイルの検査または編集に関するタスクのときに使用します
• @docx-official - 要求された出力がスライドデッキではなくドキュメントであるべきときに使用します

制限事項

• このスキルは、タスクが上記の範囲に明確に一致する場合にのみ使用してください。
• 出力を、環境固有の検証、テスト、または専門家によるレビューの代替として扱わないでください。
• 必要な入力、権限、安全境界、または成功基準が欠けている場合は、停止して確認を求めてください。