codex-ppt

Codex PPT

概要

このスキルでは、ソース資料から画像ベースの PowerPoint デッキを作成します。各スライドは、16:9 の完全な生成画像です。最終画像は scripts/assemble_ppt.py で .pptx にまとめます。

視覚的に統一されたプレゼンテーションを求めており、スライド全体が画像であることを許容する場合に使用します。すべてのテキストボックス、グラフ、図形を個別に編集可能な状態にする必要がある場合は使用しないでください。

組み込みの画像生成・編集ツールを優先してください。組み込みバックエンドを利用できない場合、必要な機能がない場合、またはユーザーが明示的に API／CLI モードを指定した場合にのみ、scripts/image_gen.py を使用してください。

厳格な制約

• 各フェーズの前に、関連する Reference Map ファイルを読んでください。このファイルはオーケストレーションの契約書です。詳細なルールは docs/ に、ワーカープロンプトは prompts/ にあります。
• 承認ゲートを遵守してください。docs/workflow-gates-and-progress.md で定められた承認を得る前に、最終版の deck_spec.json、speech.md、プロンプトジョブ、スライド画像、または .pptx を作成しないでください。
• ユーザーがサンプルスライドを承認し、デッキ全体の生成を許可した後は、サブエージェントを利用できる場合、残りすべてのスライド画像ジョブをスライドサブエージェントに割り当てる必要があります。
• メインエージェントは、オーケストレーション、プロンプトジョブ、状態記録、QA、スピーカーノート、組み立てを担当します。利用可能なスライドサブエージェントを、黙って逐次制作に置き換えないでください。
• 最終的な origin_image/slide_XX.png はすべて、選択した画像バックエンド（組み込みの画像生成・編集ツール、または scripts/image_gen.py）で生成する必要があります。
• ローカルでの描画、Pillow、SVG、HTML／CSS／canvas のスクリーンショット、python-pptx／PptxGenJS のレイアウト、手作業によるオーバーレイは失敗とみなされ、代替手段にはなりません。
• バックエンドの確認後は、選択した画像バックエンドを変更しないでください。サブエージェントが便宜上バックエンドを切り替えることも認められません。
• サンプルの承認後、承認されたサンプルの生成方法を記録し、すべてのスライドサブエージェントに同じ方法を渡してください。
• スライドの割り当てと結果の状態は、同梱スクリプトで記録する必要があります。チャットメッセージだけでは、スライドの割り当てや完了を記録したことにはなりません。
• 必須のサブエージェント、画像バックエンド、または必須の画像パスを利用できない場合は、スライド ID と根拠を示してブロッカーを報告し、作業を停止してください。品質を下げた代替物を作成しないでください。

進捗の可視化

複雑なデッキでは、ユーザーに見えるチェックリストを用意し、同時に進行中のステップは 1 つだけにしてください。正式な完了の根拠は docs/workflow-gates-and-progress.md に記載されています。

表示するステップの既定値：

1. ソース、アウトライン、スタイル、バックエンドに関する判断を準備する。
2. サンプルスライドを 1 枚生成し、承認を得る。
3. スライドジョブとスライドの状態を準備する。
4. スライドサブエージェントに割り当てる。
5. 生成されたスライドの結果を記録する。
6. QA、修正、ノート、PPT の組み立てを行う。

チャットだけを根拠にステップを完了扱いにしないでください。実際のファイル、またはスクリプトに記録された状態を使用してください。

既定のワークフロー

1. ソースコンテンツを把握します。

   • トピック、対象者、目的、ページ数、スタイル／ブランドの制約、含めるセクションと除外するセクションを特定します。
   • ページ数が指定されていない場合は、実用的な枚数を選びます。一般的なデッキは 8～12 枚です。

2. デッキのアウトラインを計画します。

   • outline.md を作成または更新する前に、docs/workflow-gates-and-progress.md と docs/outline-style-and-sample.md を読んでください。
   • スライドの役割と必要なソース画像の案を作成します。確認を求め、承認されるまでは、スタイル、バックエンド、サンプル、または後続の成果物の作成に進まないでください。

3. 統一されたビジュアルスタイルを確認します。

   • スタイルの候補を提示する前、または references/ のファイルを使用する前に、docs/outline-style-and-sample.md を読んでください。
   • 具体的なスタイル案を 2～3 個提示し、そのうち 1 つを推奨して、確認を待ちます。その後は、ページの役割に応じてレイアウトを変えながら、ビジュアルアイデンティティを統一してください。

4. 画像バックエンドを確認します。

   • スライド画像を生成する前に、docs/backend-selection.md を読んでください。
   • 組み込みの画像ツールを呼び出せるか確認し、確認した内容を伝え、バックエンドの名前とフォールバックの状況を説明して、確認を待ってください。
   • CLI/API のフォールバックが選択された場合は、docs/cli-api-fallback.md を読んでください。docs/image-model-configuration.md は、設定エラーが発生した場合、または API 設定が明示的に要求された場合にのみ読んでください。

5. 承認用のサンプルスライドを1枚生成します。

   • サンプルスライドを生成または承認する前に、docs/outline-style-and-sample.md を読んでください。
   • アウトライン、スタイル、バックエンドの確認後、代表的なサンプルを必ず1枚だけ生成してください。承認されるまで、デッキ全体を生成しないでください。
   • 承認後、deck_spec.json に sample_generation_method を記録し、ジョブとサブエージェントに同じ方法を引き継がせてください。

6. プロジェクトディレクトリを作成します。

   • フォルダーの初期化やファイルの組み立てを始める前に、docs/project-assembly-and-reporting.md を読んでください。
   • 保存先が指定されていない場合は、現在の作業ディレクトリまたはソースファイルのディレクトリを使用してください。

7. ユーザー提供のアセットを準備します。

   • 論文の図、グラフ、スクリーンショット、ロゴなど、必要なアセットを使用する前に、docs/user-supplied-assets.md を読んでください。
   • 必須アセットを厳密な入力として扱い、生成前にスライドとアセットの対応関係を確認してください。

8. すべてのスライド画像を生成します。

   • デッキ全体の画像生成を始める前に、docs/slide-generation-and-subagents.md を読んでください。
   • scripts/prepare_slide_prompts.py または保存済みの prompts/slide_XX.json ファイルを使用して、スライドごとのジョブを作成してください。
   • 最終画像はすべて、選択したバックエンドで生成し、同梱の状態スクリプトで記録する必要があります。

9. スライドのサブエージェントを割り当てます。

   • スライド作業者を割り当てたり交代させたりする前に、docs/slide-generation-and-subagents.md と prompts/slide-worker.md を読んでください。
   • 可能な限り、残りのスライドジョブごとにサブエージェントを1つ使用してください。必要なサブエージェントを起動できない場合は、ユーザーがワークフローを変更しない限り、停止してブロッカーを報告してください。

10. 品質チェックと修正を行います。

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

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

    • speech.md を作成する、または組み立てを実行する前に、docs/project-assembly-and-reporting.md を読んでください。
    • outline.md に最終確認済みのデッキのアウトラインが反映されていることを確認してください。speech.md の見出しは Slide N に対応させてください。
    • 組み立ての前に、slide_jobs.json で生成済みのスライドが recorded、承認済みのサンプルが accepted と表示されていることを確認してください。いずれかのスライドが pending、dispatched、または blocked の場合は、停止してください。

12. 結果を報告します。

    • docs/project-assembly-and-reporting.md の最終レポートチェックリストを使用してください。
    • パス、スライド数、使用したバックエンド、結果の記録状況、制限事項またはブロッカーを含めてください。

13. 再利用可能なスタイルを保存します。

    • 現在のデッキのスタイル、または提供された画像/PDF/PPT/PPTX のスタイルを保存するよう依頼された場合は、docs/style-library.md を読んでください。
    • 最終デッキでカスタムスタイルまたは調整したスタイルを使用した場合は、docs/project-assembly-and-reporting.md に従い、最終レポートでその保存を積極的に提案してください。ユーザーのカスタムスタイルは、スキルのインストール先の外部にある ${CODEX_PPT_HOME:-~/.codex-ppt-skill}/references/ に保存されます。

サブエージェントへの割り当て

サンプルの承認後、ランタイムでサブエージェントを起動できる場合は、必ずサブエージェントに作業を割り当ててください。メインエージェントはジョブを準備して状態を記録し、各ワーカーは prompts/slide_XX.json のジョブを1件だけ担当し、選択した画像パス、バックエンド、QAメモのみを返します。

割り当て、コマンド、結果の記録、ブロッカー、バックエンドの出所情報については、docs/slide-generation-and-subagents.md を使用してください。引き継ぎテンプレートには prompts/slide-worker.md を使用してください。

サブエージェントは outline.md、deck_spec.json、他のスライドジョブ、origin_image/、speech.md、最終版の .pptx を編集してはいけません。親エージェントが出力を記録し、組み立てを行います。

受け入れ基準

• 出力が有効な .pptx であること。
• 期待される各最終スライド画像が origin_image/slide_XX.png に存在すること。
• すべての最終スライド画像が、確認済みのバックエンドで生成され、record_slide_result.py を通じて記録されていること。ただし、承認済みサンプルが実行状態によって承認済みとマークされている場合を除きます。
• outline.md に承認済みのデッキ概要が反映されていること。
• 発表者ノートが必要な場合は speech.md が存在し、組み立て時にそれらのノートがPPTに書き込まれること。
• slide_jobs.json と slide_run_state.json に最終状態が反映されていること。
• 必要なソース画像が目に見える形で含まれていること、またはブロッカーが報告されていること。
• ブロックされている場合、最終応答でフェーズ、スライド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-and-subagents.md：ジョブ、割り当て、結果の記録、ブロッカー、出所情報。
• docs/cli-api-fallback.md：フォールバックランタイム、生成・編集コマンド、画像の制限、トラブルシューティング。
• docs/image-model-configuration.md：APIキー、ベースURL、モデル、.env。設定が必要な場合にのみ読み込んでください。
• docs/project-assembly-and-reporting.md：プロジェクトディレクトリ、ノート、組み立て、最終レポート、プロンプトの原則。
• prompts/slide-worker.md：スライドサブエージェントの引き継ぎテンプレート。
• references/*.md：組み込みのビジュアルスタイルの参照資料。ユーザー定義のカスタムスタイルは ${CODEX_PPT_HOME:-~/.codex-ppt-skill}/references/ に保存され、同名の組み込みスタイルより優先されます。

ドキュメントと更新情報

ソース、ドキュメント、インストール、設定、使用例については、ningzimu/codex-ppt-skill を参照してください。