ai-image-ppt

AI Image PPT

概要

このスキルは、ソース資料から画像ベースの PowerPoint デッキを作成します。各スライドは、デフォルトで 16:9 の、生成された画像で構成されます。対応するアスペクト比は 16:9（デフォルト）、4:3、1:1、3:4、9:16、21:9 です。別の対応アスペクト比が指定された場合は、プロンプト、画像の寸法、PPT の組み立てで一貫して使用してください。最終的な画像は scripts/assemble_ppt.py で .pptx に組み立てられます。

スライド全体を画像で構成する、視覚的に統一された PowerPoint デッキの作成に使用します。納品物は .pptx ファイルです。「画像ベース」とはスライドの構成方法を指し、別の納品形式を意味するものではありません。すべてのテキストボックス、グラフ、図形を個別に編集できる状態にする必要がある場合は使用しないでください。

組み込みの画像生成ツールが利用できる場合は、画像バックエンドとして直接選択し、docs/backend-selection.md、docs/cli-api-fallback.md、docs/image-model-configuration.md は読み込まないでください。利用できない場合は、これら3つのファイルを読み込んでから画像バックエンドを選択してください。バックエンドの選択にユーザーの確認は必要ありません。

厳守事項

• 特に指定がない限り、.pptx を作成して納品します。スライド画像と PPTX のどちらにするか、ユーザーに選択を求めないでください。画像は中間アセットまたは補足用の納品物とし、ユーザーが画像のみを明示的に希望した場合を除きます。
• 各フェーズの前に、該当する Reference Map ファイルを読みます。このファイルはオーケストレーションの契約です。詳細なルールは docs/ に、スライドごとのガイダンスは prompts/ に記載されています。
• このワークフローで使用するスクリプトについては、使用前に必ず該当するドキュメントで使い方を確認します。具体的な疑問への回答が得られない場合は、スクリプトの --help（該当する場合はサブコマンドの --help も）を実行します。ドキュメントとヘルプのどちらも利用できない、失敗する、または同じ疑問が未解決のままの場合に限り、その後でソースを読み、該当箇所のみを確認します。実行時のエラーだけを理由に、この順序を省略してはいけません。
• まず、ビジュアルスタイル、対象ユーザー、シナリオ、トーン、スライド枚数をまとめて確認します。明示的に指定されている値や、明確に推測できる値は、確認を求めずに再利用します。その後、アウトラインとサンプルの確認を求めます。ただし、ユーザー提供のスタイル参考画像との一貫性が確認できた場合は、サンプルの確認も省略します。それ以外の場合、確認を省略できるのは、ユーザーが明示的に希望した場合に限ります。その際は docs/workflow-gates-and-progress.md に従ってください。無回答や一般的な作成依頼から、確認を省略する意思を推測してはいけません。
• 確認とは、未確定の設定について質問するか、表示したアウトラインやサンプルについて尋ね、ユーザーの実際の選択または肯定的な返答を待つことです。利用可能な組み込み質問ツールがあれば優先して使い、なければチャットで質問します。ツールの制限内で未確定の設定をまとめ、簡潔な選択肢と推奨案を提示します。承認または修正の選択肢を示す前に、アウトラインまたはサンプルを提示します。あらかじめ選択された既定値、ツールの処理完了、タイムアウトは承認とみなしません。
• 承認ゲートを遵守します。docs/workflow-gates-and-progress.md に記載された承認を得る前に、最終版の deck_spec.json、speech.md、プロンプトジョブ、スライド画像、.pptx を作成してはいけません。
• サンプル承認後は、選択されたバックエンドを使い、メインエージェント内で一度に最大6件の画像呼び出しを並行して残りのスライドを生成します。スライド生成をサブエージェントに委任してはいけません。
• プロンプトジョブ、生成、画像の保存、QA、ノート、組み立ては、メインエージェントが担当します。
• 最終版の origin_image/slide_XX.png はすべて、選択された画像バックエンド（組み込みの画像生成／編集ツール、または scripts/image_gen.py）で生成しなければなりません。
• ローカルでの描画、Pillow、SVG、HTML／CSS／canvas のスクリーンショット、python-pptx／PptxGenJS によるレイアウト、手動でのオーバーレイは、フォールバックではなく失敗とみなします。
• 画像バックエンドの選択後は、選択したバックエンドを固定します。便宜上、別のバックエンドに切り替えてはいけません。
• サンプル承認後は、サンプルの生成方法を記録し、そのバックエンドとビジュアル設定を維持します。生成モード／編集モードは、画像入力と修復の必要性に応じて変更できます。
• スライドの生成が成功したとみなされるのは、期待される origin_image/slide_XX.png ファイルが存在する場合に限ります。タスク状態を示す別ファイルを作成してはいけません。
• 選択した画像バックエンドまたは必要な画像パスを利用できない場合は、スライド ID と根拠を示してブロッカーを報告し、停止します。品質の低い代替物を作成してはいけません。

進捗の可視化

手順が複雑なデッキでは、ユーザーに見えるチェックリストを維持し、常にアクティブなステップを1つにします。完了の正式な根拠については、docs/workflow-gates-and-progress.md を参照してください。

既定のステップ：

1. スタイル、対象ユーザー、シナリオ、トーン、スライド枚数を確認する。
2. ソース、アウトライン、バックエンドの選択を準備する。
3. サンプルスライドを1枚生成し、承認を得る。
4. スライドのプロンプトを準備する。
5. メインエージェント内で画像をまとめて生成する（並行呼び出しは最大6件）。
6. 生成したスライド画像を保存する。
7. QA、修復、ノート、PPT の組み立てを行う。

確認ステップでは docs/workflow-gates-and-progress.md に記載された承認の根拠を使用し、制作ステップでは実際の出力ファイルを使用します。

既定のワークフロー

1. スタイル、対象者、シナリオ、トーン、スライド枚数を確認します。

   • docs/workflow-gates-and-progress.md と docs/outline-style-and-sample.md を読みます。
   • ユーザーの依頼から明確に推測できる明示的な選択や設定を再利用します。推測した設定を簡潔に伝え、不足している値や曖昧な値についてのみまとめて質問します。可能であれば、利用可能な組み込み質問ツールを使い、推奨する組み合わせを提示してください。対象者の例：学生、教師、同僚。シナリオの例：授業用スライド、絵本、業務報告、ビジネスレポート。トーンの例：中立的、親しみやすい、プロフェッショナル、教育的、技術的、学術的。
   • ソースの準備やアウトライン作成に進む前に、この確認段階を完了してください。この判断に必要であれば、提供されたスタイルの参考資料を確認してください。プロジェクトを作成したら、設定を outline.md に記録します。

2. ソース資料、プロジェクトディレクトリ、アセットを準備します。

   • フォルダーを初期化する前に docs/project-assembly-and-reporting.md を読み、ソース画像を使用する前に docs/user-supplied-assets.md を読みます。
   • 確認済みの対象者、シナリオ、トーンに基づき、トピック、目標、言語、必要な内容または除外する内容を特定します。確認済みのスライド枚数は維持してください。
   • アウトラインの作成やサンプルの生成を始める前に、出力ディレクトリを選択し、プロジェクトのフォルダーを初期化します。保存先が指定されていない場合は、現在の作業ディレクトリまたはソースディレクトリを使用してください。
   • 必要なアセットを抽出して確認し、パスと用途を記録します。フォルダーの初期化は、その後の制作を許可するものではありません。

3. アウトラインを作成して確認します。

   • docs/workflow-gates-and-progress.md と docs/outline-style-and-sample.md を読みます。
   • 確認済みの設定、タイトル、要点、各ページの役割、必要な画像との対応関係を記載した outline.md を作成します。これを提示してアウトラインの承認を求め、可能であれば利用可能な組み込み質問ツールを使います。ユーザーが確認を明示的に省略している場合を除き、承認の返答を待ってから生成に進んでください。

4. 画像バックエンドを選択します。

   • 組み込みの画像生成ツールが利用可能な場合は、それを直接選択します。この場合、docs/backend-selection.md、docs/cli-api-fallback.md、docs/image-model-configuration.md は読まないでください。
   • それ以外の場合は、これら3つのファイルを読んでから画像バックエンドを選択します。

5. サンプルを1点生成して承認を得ます。

   • docs/outline-style-and-sample.md を読み、アウトラインとスタイルの承認後、バックエンドを選択してから、代表的なスライドを1枚生成します。
   • 確認済みのアウトライン、スタイル、必要な参考資料をもとにサンプル用プロンプトを直接作成します。サンプルの準備に prepare_slide_prompts.py を実行しないでください。
   • 最終的な origin_image/slide_XX.png という名前で保存します。サンプルは通常のリンクではなく、Markdownの画像構文 ![Sample slide](image_path_or_url) を使ってインライン表示し、承認を求めます。可能であれば、利用可能な組み込み質問ツールを使ってください。ユーザーがサンプルの確認を明示的に省略している場合、または確認の結果、サンプルがユーザー提供のスタイル参考画像と一致している場合を除き、承認の返答を待ってから本制作に進みます。docs/outline-style-and-sample.md の確認項目を適用してください。

6. デッキ仕様とジョブを準備します。

   • docs/slide-generation.md を読みます。
   • 承認済みサンプルの生成方法と approved_style_reference を含めて deck_spec.json を作成します。承認済みサンプル画像は最終パスに保持してください。
   • すべてのスライドジョブに引き継がれるよう、対象者、シナリオ、トーンを deck_context に設定します。確認済みのスタイルを style に、トーンをスピーカーノートに設定してください。
   • 承認されたサンプルの実際の生成方法とスタイル参考画像を記録した後で、prepare_slide_prompts.py を1回実行します。ジョブの再構築は仕様が変更された場合に限ります。承認済みサンプルを再利用してください。最終画像はすでに存在しています。

7. 残りの各スライドを生成して保存します。

   • prompts/slide-generation.md を読み、最終画像が不足しているジョブを、メインエージェント内で最大6件の画像呼び出しを並行して実行します。委任しないでください。
   • 各ジョブについて、選択したバックエンドを呼び出し、候補を確認し、必要に応じて修正して、選んだ生成画像を期待される origin_image/slide_XX.png パスに保存またはコピーします。次のバッチを開始する前に、現在のバッチのすべての結果を仕上げて保存してください。
   • バックエンドとビジュアルアイデンティティを固定してください。必要な画像入力と修正内容に応じて、生成または編集を選択してください。サンプルモードは出所を示すものであり、すべての呼び出しで必須のモードではありません。
   • 失敗した場合は、ページと理由を報告し、最終画像は作成しないでください。原因が解決した後、状態をリセットせずに不足しているページを再試行してください。

8. 品質を確認して修正します。

   • QA または組み立ての前に、docs/project-assembly-and-reporting.md を読んでください。
   • 組み立ての前に、各スライドを確認します。テキスト、アウトラインとの一致、切り詰め、スタイル、不要なページ番号、重なり、必要なアセットを確認してください。
   • 重大な不具合がある場合は、より具体的なプロンプトで再生成します。利用可能な場合は、バックエンドの編集機能を使って局所的な問題を修正します。
   • CLI/API のフォールバック編集コマンドについては、docs/cli-api-fallback.md を読んでください。編集後の出力を検証してから、最終スライドを置き換えてください。

9. 発表者ノートを作成し、PPT を組み立てます。

   • speech.md を作成する前、または組み立てを実行する前に、docs/project-assembly-and-reporting.md を読んでください。
   • outline.md が最終確認済みのデッキのアウトラインを反映していることを確認してください。speech.md の見出しは Slide N に対応させてください。
   • 組み立ての前に、deck_spec.json に記載されたすべての期待画像パスを確認してください。画像が1枚でも不足している場合は停止してください。ファイル数だけを根拠に進めないでください。
   • 画像の QA、修正、ノートの作成を組み立ての前に完了し、docs/project-assembly-and-reporting.md の組み立てと再構築のルールに従ってください。

10. 結果を報告します。

    • docs/project-assembly-and-reporting.md の最終レポートチェックリストを使用してください。
    • パス、スライド数、生成済み／不足スライド数、制限事項やブロッカーを記載してください。

メインエージェントでの生成

保存済みのスライドジョブは、選択したバックエンドと承認済みのビジュアル設定を使用し、メインエージェント内で最大6件の画像呼び出しを並行するバッチに分けて直接実行します。各呼び出しは1枚のスライドを処理します。バッチ内のすべての呼び出しが完了するまで待ち、各結果を確認して保存してください。次のバッチを開始するのは、そのバッチで期待される画像がすべて存在する場合に限ります。修正と再試行も同じ上限に含まれます。実行環境またはバックエンドが並列処理に対応していない場合は、バッチを小さくするか、逐次実行してください。サブエージェントを作成しないでください。

受け入れ基準

• 出力が有効な .pptx であること。
• 期待される各最終スライド画像が origin_image/slide_XX.png に存在すること。
• 再利用する承認済みサンプルを含め、すべての最終スライド画像が選択した画像バックエンドから生成されていること。
• outline.md が承認済みのデッキのアウトラインを反映していること。
• 発表者ノートが必要な場合、speech.md が存在し、組み立て時にそれらのノートが PPT に書き込まれていること。
• 必要なソース画像が視覚的に反映されていること、またはブロッカーが報告されていること。
• 作業がブロックされた場合、最終回答でフェーズ、スライド ID、証拠のパス、未完了の理由を示してください。デッキが完成したとは報告しないでください。

リファレンスマップ

• docs/workflow-gates-and-progress.md：承認ゲート、進捗、完了の証拠。
• docs/backend-selection.md：組み込みの画像生成ツールが利用できない場合に読みます。
• docs/outline-style-and-sample.md：アウトライン、スタイル、サンプルのルール、プロンプトの例。
• docs/user-supplied-assets.md：必須のソースアセットの厳格な取り扱い。
• docs/slide-generation.md：プロンプト、バッチ生成、画像の保存、再試行。
• docs/cli-api-fallback.md：組み込みの画像生成ツールが利用できない場合に読みます。ランタイム、コマンド、制限、トラブルシューティング。
• docs/image-model-configuration.md：組み込みの画像生成ツールが利用できない場合に読みます。API キー、ベース URL、モデル、.env。
• docs/project-assembly-and-reporting.md：プロジェクトディレクトリ、メモ、組み立て、最終レポート、プロンプトの原則。
• prompts/slide-generation.md：メインエージェント向けのスライドごとのチェックリスト。
• references/*.md：組み込みのビジュアルスタイルのリファレンス。