powerpoint-presentations

PowerPoint プレゼンテーション

段階的なワークフローを使用します：分類 → 確認 → 計画 → 実行 → 検証 → レンダリング → 反復。 ソースの検証や QA を省略しないでください。

1. リクエストを分類する

次のいずれか 1 つのパスを選択します。

パス	使用する状況	主なツール
ソースを編集	アップロード済みまたは既存のデッキを変更する場合	inspect_presentation、begin_presentation_edit、編集ツール
テンプレートから作成	アップロード済みのブランド付きデッキでコンテンツを作成する場合	begin_presentation_edit、duplicate_slide、update_slide_content
新規作成	ソース／テンプレートを保持する必要がない場合	create_presentation
分析	編集せずにコンテンツ、デザイン、構成を確認する場合	inspect_presentation、プレビューツール

編集またはテンプレートのリクエストに create_presentation を使用しないでください。このツールは新しいパッケージを作成するため、ソースのマスター、レイアウト、リレーションシップ、ノート、埋め込みアセットを保持できません。

2. ソースを検証して確認する

編集およびテンプレートのパスでは、次の手順を実行します。

1. list_my_powerpoint_presentations を呼び出します。
2. ソースのファイル名が正確に存在することを確認します。
3. persist_spec=true を指定して inspect_presentation を呼び出します。
4. デッキ全体の視覚的な確認のため、preview_presentation_montage を呼び出します。
5. 詳細な要素 ID が必要なスライドに限り、analyze_presentation を呼び出します。

ソースを読み込めない場合は、作業を中止してファイルが見つからないことを報告します。説明からデッキを再作成したり、黙って新規デッキのワークフローに切り替えたり、ソースファイルが検証されていない環境にタスクを委任したりしないでください。

永続化されたデッキ仕様を、ターンをまたいでデザインシステムの記録として扱います。確認後、begin_presentation_edit を 1 回呼び出し、その edit_id を保持します。構造を変更した後は、その edit_id を指定して inspect_presentation を再実行します。フォント、色、レイアウト、スライド構成について、会話の記憶に頼らないでください。

3. 編集前に計画する

次の項目を定義します。

• 対象読者と、判断または目標とする成果
• ナラティブの流れと、各スライドのメッセージ 1 つ
• 各スライドの機能的な種類
• コンテンツ密度の上限
• 保持または複製するソースのスライド／レイアウト
• 新しいビジュアルやデータが必要なスライド

実質的なコンテンツを作成する場合は、コードの生成やパッケージの変更を始める前に、簡潔なスライド計画を作成します。計画スキーマとパス別の手順については、workflow-guide.md を参照してください。

4. デザインシステムを確立する

ソース／テンプレートを扱う場合は、deck_spec からトークンを抽出します。対象はスライドサイズ、テーマカラー、テーマフォント、明示的に指定されたフォント、レイアウト名、繰り返し使われているビジュアルモチーフです。ユーザーから明示的な再デザインの依頼がない限り、これらのトークンを保持します。

新しいデッキでは、スライドを作成する前に簡潔なデザインシステムを 1 つ定義します。design-guide.md を参照してください。新規デッキの実装詳細には、pptxgenjs.md のみを使用します。

5. 慎重に実行する

既存のデッキを編集する

1. begin_presentation_edit を 1 回呼び出し、その edit_id を保持します。
2. 対象のスライドを分析します。
3. 完全な操作バッチを 1 つ作成します。
4. 同じ edit_id を指定して update_slide_content を呼び出します。
5. replace_text では find と replace を使用します。

不明なアクション、空の検索文字列、重複するスライドバッチ、該当するテキストがない場合はエラーです。別のワークフローに置き換えず、操作を修正してください。編集する前に editing-guide.md を参照してください。

テンプレートから作成する

機能的なスライドの種類ごとに、代表的なソーススライドを複製することを優先してください。これにより、プレースホルダーの配置、視覚的な装飾、リレーションシップを最もよく保持できます。

1. テンプレートを確認し、代表的なスライドを特定します。
2. 最も近い代表的なスライドを複製します。
3. 1 つのバッチでテキスト／画像を置き換えます。
4. スライドの順序を変更します。
5. 作業中のデッキが完成した後に限り、使用していないサンプルスライドを削除します。

適切なレイアウトがあり、レイアウトに基づく空白のスライドが本当に必要な場合に限り、add_slide を使用します。保持すべきスライドの種類とレイアウトを特定する前に、すべてのサンプルを削除しないでください。

新しいデッキを作成する

PptxGenJS で create_presentation を使用します。必要に応じて、各スライドのスニペット内で共通定数とヘルパー関数を定義してください。PptxGenJS はオプションオブジェクトを変更するため、呼び出し間でオプションオブジェクトを再利用しないでください。

6. 検証とレンダリング

変更を加えるたびに、次の手順を実行します。

1. presentation_name=edit_id を指定して validate_presentation を呼び出します。
2. それ以上作業を進める前に、構造上のエラーを修正します。
3. 境界、重なり、オーバーフローのリスク、プレースホルダー、フォントに関する警告を確認します。
4. デッキ全体を確認するため、preview_presentation_montage を呼び出します。
5. 詳細を確認するため、影響を受けたスライドに限って preview_presentation_slides を呼び出します。
6. 問題を修正し、検証と対象を絞ったレンダリングを繰り返します。
7. 希望する出力名で finalize_presentation_edit を一度だけ呼び出します。アプリで生成されたプレゼンテーションの場合、ユーザーが別の成果物を求めていない限り、元のファイル名を維持してください。最終処理では既存の結果が更新され、以前のバイト列が保持されます。アップロードされたソースファイルは変更されないため、別の出力名が必要です。

LibreOffice によるレンダリングは、Microsoft PowerPoint の近似にすぎません。フォントがない場合や複雑な Office 機能を使用している場合は、可能であれば PowerPoint で最終確認してください。合格基準については qa-guide.md を参照してください。

次の条件を満たすまで、成功したと宣言しないでください。

• パッケージに構造上のエラーがないこと。
• 未解決のプレースホルダー警告や範囲外警告が残っていないこと。
• 変更したすべてのスライドが、最終編集後にレンダリングされていること。
• 最終モンタージュで、一貫性のある内容、デザイン、ストーリー展開が確認できること。

必ず守るルール

• アップロードされたソースは保持し、begin_presentation_edit が返す非表示のドラフトのみを編集してください。
• 作業全体で同じ edit_id を再利用してください。v2、v3 などの中間プレゼンテーションファイルは作成しないでください。
• 公開は finalize_presentation_edit で一度だけ行ってください。
• 関連する編集はまとめて行ってください。条件付きのドラフト書き込みは、古い状態と並行して更新しようとすると拒否されます。
• 編集ツールでは 0 始まりのスライドインデックスを、プレビュー用ツールでは 1 始まりの番号を使用してください。
• プレゼンテーション名には、英字、数字、ハイフンを使用してください。
• リクエストでソースへの忠実性が求められる場合、生成した近似版を使用しないでください。
• ツールの実行に成功したことを、視覚的な正しさの証明と見なさないでください。