mcpField
I
infographic-powerpoint-deck

infographic-powerpoint-deck

github.com/autobyteusドキュメント34292 回インストール3 日前に更新
リポジトリ

infographic-powerpoint-deck について

記事、メモ、スライド計画からインフォグラフィック調の PowerPoint デッキを作るスキルです。メッセージ、表示テキスト、ビジュアルを別々に計画し、内容とデザインを整理します。

主な機能

  1. 013段階のスライド計画
  2. 02記事・表形式入力への対応
  3. 03デッキ形式とスタイルパックの選定
  4. 04スライドごとの画像プロンプト作成
  5. 0516:9画像生成の手順
  6. 06画像のみのPPTX組み立て

活用シーン

  1. 01レポートをスライドデッキに変換
  2. 02参考スライドからビジュアルを設計
  3. 03表示テキストを調整したスライド画像の作成
  4. 04生成画像をPPTXにまとめる

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/autobyteus/autobyteus-skills --skill infographic-powerpoint-deck

インストール後、Claude Code で/infographic-powerpoint-deckを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

agents/
openai.yaml
references/
article_intake_workflow.md
chinese_quote_compression.md
chinese_text_rendering_playbook.md
deck_archetype_routing.md
deck_consistency_block.md
high_fidelity_prompt_playbook.md
layout_library.md
layout_routing_policy.md
motif_pack.md
negative_prompt_block.md
prompt_example_library.md
prompt_template.md
reference_slide_intake.md
scene_library.md
scene-catalog.md
scene-entry-template.md
scene-preset-library.md
shot_mood_library.md
slide_table_normalization.md
storyboard_library.md
style-pack-catalog.md
style-pack-system.md
references/style-packs/airy-relaxed/
10-style-profile.md
20-motif.md
30-consistency.md
40-scene-bias.md
manifest.toml
references/style-packs/animated-feature-bright/
10-style-profile.md
20-motif.md

詳細

インフォグラフィック PowerPoint デッキ

デフォルトの入力モデル(まず記事そのものを使用)

このスキルは、デフォルトでユーザーの記事原文から直接作業できるようにします。

ユーザーが記事、説教、レポート、長いメモを全文提供した場合:

  1. ソースの内容を読み、対象読者、伝えるべき要点、情報密度、論旨やストーリーの構成を把握します。
  2. 記事の構成に基づいて slides_message_plan.md を作成します。
  3. slides_message_plan.md を slides_display_plan.md に変換します。
  4. slides_display_plan.md を slides_visual_plan.md に変換します。
  5. スライドごとに画像プロンプトを1つ作成し、デッキを生成します。

ユーザーがすでに slides_message_plan.md またはそれに相当する、コンテンツを中心としたスライド表を提供している場合は、記事の取り込み手順を省略し、それを直接使用できます。

ユーザーが参照用スライドやスクリーンショットを1つ以上提供している場合は、プロンプトを作成する前に references/reference_slide_intake.md を使って、再利用可能なビジュアルの文法を抽出します。

成果物モデル

用途の異なる3つの計画成果物を使用します。

  • slides_message_plan.md

    • コンテンツと発表者の計画のみを記載
    • 各スライドで何を教え、説明し、伝えるかを詳しく記載
    • スライドの背後にある、詳細な発表内容や物語上の要点
    • ソース記事の該当箇所、聖書箇所・根拠、必ず保持する主張
    • 別々に扱うべき要点
  • slides_display_plan.md

    • スライド上に実際に表示する内容
    • タイトル、節の一部、モジュール見出し、箇条書き、ラベル、キャプション、フッターの参照情報
    • テキスト量とスライドの型を決めた後の、スライド上の明示的なテキスト
    • メッセージ計画よりも大幅に短くできる
  • slides_visual_plan.md

    • 後続のビジュアル制作に向けた計画
    • デッキの型
    • スタイルパックの選択
    • レイアウトの振り分け
    • シーンの選択
    • テキスト量などの制作上の制約

slides_message_plan.md は、発表者が伝えようとしている内容の信頼できる情報源です。 slides_display_plan.md は、対象者が実際に目にするテキストの信頼できる情報源です。 slides_visual_plan.md は、デザインとプロンプト制作の信頼できる情報源です。

クイックスタート(デフォルト:画像のみのデッキ、構造化された計画)

  1. 次のいずれかから開始します。
    • 記事の生コンテンツ/メモから開始し、references/article_intake_workflow.md を使用する
    • 事前に作成された slides_message_plan.md から開始する
    • 内容が不十分なスライド表から開始し、最初に正規化する
    • 参照用のスライド画像/スクリーンショットがある場合は、references/reference_slide_intake.md を使用する
  2. 記事の生コンテンツから開始する場合は、まず slides_message_plan.md を作成します。
  3. 承認済みのメッセージプランを基に、references/deck_archetype_routing.md を使用して デッキのアーキタイプ を1つ推定します。
    • ユーザーがスタイルを明示的に指定している場合は、それを優先します。
  4. スタイルパックのフォルダー を1つ選びます。
    • ユーザーがスタイルを指定せず、アーキタイプから別の選択が強く示唆されない場合は、editorial-light をデフォルトにします。
    • スタイルパックはデッキのビジュアル表現(パレット、ライティング、タイポグラフィの雰囲気、シーンの傾向)を決めます。すべてのスライドに1つの固定レイアウトを強制するものではありません。
  5. slides_message_plan.md から slides_display_plan.md を作成します。
    • アーキタイプ、情報密度、想定されるレイアウトの種類を考慮し、各スライドで実際に聴衆に見せる内容を決めます。
    • 発表内容をすべてスライドに詰め込まないでください。
  6. slides_display_plan.md から slides_visual_plan.md を作成します。
    • スタイル、レイアウト、シーン、テキスト量の決定事項はメッセージプランではなく、ここに記載します。
  7. スタイルパックの素材を集めます。
    • 補助として scripts/compose_style_pack_blocks.py --pack-id <id> を実行することも、スタイルパックのファイルを手動で読むこともできます。
    • スクリプトの出力は補助的なコンテキストとして扱い、最終的なプロンプト本文として使わないでください。
    • 具体的なプロンプトは、モデルが平易な指示文で作成してください。
  8. slides_visual_plan.md の各スライドについて、references/prompt_template.md を埋めます。
    • スタイルパックの素材を補助的なコンテキストとして使い、平易な指示文に書き換えます。
    • 特に指定がなければ、プロンプトの指示は英語で記述します。
    • ユーザーが指定した言語で、slides_display_plan.md のスライド上に表示する必須テキストをそのまま記載します。
    • ビジュアルプランに従って、スライドごとのシーンレイヤーの詳細とアイコンを追加します。
    • L1 や L10 などの内部ルーティング ID は計画メタデータ内にのみ保持します。具体的な画像プロンプトでは、割り当てられたレイアウトを平易な構図の説明に置き換えます。
    • 参照画像や編集形式のツール呼び出しを使用する場合、その仕組みはツール呼び出し側に記載します。具体的なプロンプトには Using the provided image as the compositional base... のように仕上がりを目指すアートディレクションを記載し、edit this image のようなツール操作の指示は記載しないでください。
  9. 各スライドを 16:9 の画像 として生成します。
    • このスキルで許可されるスライド作成方法は、画像生成 と 画像編集/参照 のみです。
    • スライドのプロンプトには、比率を固定する文を明示的に含めます(例:Hard canvas constraint: 16:9 widescreen. Do not generate a square image.)。
    • ツール呼び出しでは、対応している場合、比率設定(例:aspect_ratio: "16:9" を指定した generation_config)を明示的に設定します。
    • 一貫性をさらに高める必要がある場合は、承認済みの過去のスライド画像や背景の検討画像を入力/編集参照として使用できます。ただし、画像ツールで最終的なスライド全体を描画してください。
  10. 可読性とテキストの正確性を確認し、不合格のスライドのみ再生成します。
  • スライドが 16:9 でない場合、またはテキストに不備がある場合は、画像を直接再生成します。
  • ユーザーが明示的に求めない限り、生成画像のトリミング、余白追加、リサイズ、後処理は行わないでください。
  • 通常のスキルワークフローでは、Python/PIL/PPT のオーバーレイを使って後からテキストを描画しないでください。
  1. scripts/build_images_only_pptx.py を使用して、画像のみの PPTX を組み立てます。 ユーザーのワークスペースに作成する成果物:
  • slides_message_plan.md(スライドごとの詳細な説明/指導計画。各スライドで伝える内容の唯一の基準)
  • slides_display_plan.md(スライド上に表示するテキストの計画。表示テキストとラベルの唯一の基準)
  • slides_visual_plan.md(ビジュアル制作計画。アーキタイプ/スタイル/レイアウト/シーンの判断に関する唯一の基準)
  • prompts.md(各スライドに使用した正確なプロンプト)
  • slides/slide01.png ...(最終版の16:9画像)
  • deck_images_only.pptx(画像を連結したもの)

オプションの構造化スライド表の入力

複数ステップのワークフローの品質を高めるには、未加工の記事または構造化済みのメッセージスライド表から開始できます。

  • 未加工の記事コンテンツは、このスキルに対する正式な入力として使用できます。references/article_intake_workflow.md を使用してください。
  • 上流の成果物がすでに slides_message_plan.md の場合は、メッセージの唯一の基準としてそのまま保持してください。
  • 上流の成果物ですでにデッキの長さ、セクションの範囲、または別々のスライドに残すべき要点が決まっている場合は、ユーザーが明示的に圧縮または拡張を依頼しない限り、それを基準となるメッセージ計画として扱ってください。
  • 上流のコンテンツ表が簡素、または指定が不十分な場合は、表示計画を作成する前に references/slide_table_normalization.md を使用して slides_message_plan.md に整理してください。

プロンプトスタック(最小構成と完全構成)

  • 最小構成(ほとんどのデッキで推奨):
    • references/article_intake_workflow.md(未加工の記事コンテンツから開始する場合)
    • references/deck_archetype_routing.md(まずデッキ全体の形式を推定)
    • references/style-pack-catalog.md(パック ID を選択)
    • references/style-pack-system.md(読み込み順と構成のルール)
    • references/layout_routing_policy.md(デフォルトではレイアウトを自動で割り当て)
    • references/prompt_example_library.md(パネルの逸脱を避けるため、例とアンチパターンを使用)
    • references/high_fidelity_prompt_playbook.md(ユーザーがより精密なプロンプトを求める場合)
    • references/reference_slide_intake.md(参照スライドをもとにデッキを作成したい場合)
    • references/style-packs/<pack-id>/(パック固有のブロック)
    • references/typography_spacing_lock.md
    • references/text_fidelity_block.md
    • references/negative_prompt_block.md
  • 完全構成(ナラティブとビジュアルを最大限に制御する場合):
    • 最小構成 +
    • references/storyboard_library.md
    • references/shot_mood_library.md
    • references/scene-catalog.md
    • references/scene_library.md
    • references/layout_library.md
    • references/chinese_quote_compression.md(長い中国語の引用を分割する場合)

スタイルパックシステム(モジュール式で拡張可能)

フォルダーに分けたスタイルパックを使用して、各スタイルを独立させます。

  • 各スタイルパックは references/style-packs/<pack-id>/ に配置します。
  • 各パックには、その見た目を定義する固有の manifest.toml とブロックファイルがあります。
  • パックは base-core を継承して、共通の制約を再利用できます。
  • プロンプトは、base-core のガイダンス+選択したパックのガイダンス+スライド固有のコンテンツから作成します。
  • これによりファイル間の不整合を避け、新しいスタイルを確実に作成できます。

注:聖書を題材にした例を使用していますが、このワークフローはどのようなトピックにも対応します。references/scene_library.md のシーンや小道具を、対象分野(製品、研究、トレーニングなど)に合わせて変更してください。

意思決定モデル(スタイル、レイアウト、シーンを分けて考える)

  • メッセージプラン = コンテンツレベルのコミュニケーションモデル。各スライドでプレゼンターが伝えたいことと、それを十分に伝えるために必要なスライド数を定めます。
  • 表示プラン = 観客向けのテキストモデル。短いテキスト、ラベル、聖句の一節、箇条書き、キャプション、モジュール見出しなど、スライドに実際に表示する内容を定めます。
  • デッキのアーキタイプ = デッキレベルの閲覧モデル。承認済みのメッセージプランに最適なビジュアルプレゼンテーションの種類を定めます。
  • スタイルパック = デッキレベルのビジュアル言語。配色、ライティング、質感、タイポグラフィの方向性、シーンの傾向を定めます。
  • レイアウト = スライドレベルの構成文法。分割パネル、フレームワーク、比較、警告、解説型のティーチングボード、全面表示のオーバーレイなどがあります。通常、ビジュアルプランニング時に自動で割り当てます。厳格なテンプレートのように見えなくても、非常によく整理された仕上がりにできます。
  • シーン ID/ビジュアルシーン = ビジュアルプランニング時に選択するスライドレベルの描写です。
  • テキスト量の上限 = 選択したレイアウトにどの程度のテキストを載せる必要があるかを示す制作上の制約です。

デッキのアーキタイプを使って、残りの判断を導きます。

  • メッセージプラン -> スライドの役割、原資料の根拠、内容の掘り下げ度
  • メッセージプラン + アーキタイプ + テキスト量の上限 -> 表示プラン
  • 表示プラン -> スライド上のテキストとラベルの密度
  • デッキのアーキタイプ -> スタイルパック
  • デッキのアーキタイプ -> ビジュアルプランのレイアウト傾向
  • スライドの役割 + テキスト量の上限 -> レイアウトの割り当て
  • スライドの役割 + 原資料の意味 -> シーンの選択
  • 参考スライド(任意) -> プロンプトの文言、レイアウトの傾向、スタイルパックの調整の可能性

スライド数は、デッキスキルのデフォルト値ではありません。内容を十分に伝えるために実際に必要なスライド数を決めます。

次の判断ルールを使います。

  1. 個別に扱う必要がある、独立した要点を特定します
  2. 明瞭さ、説得力、使いやすさを損なわずに、各要点をどの程度圧縮できるかを決めます
  3. その内容の網羅に必要な度合いに基づいてスライド数を設定します

上流工程のスライドプラン、エージェントへの指示、実行時の要件、またはユーザーの依頼によってデッキに制約が加わることはありますが、それらは計画の中核となるロジックではありません。 明示的な簡潔さの要望によって有害な圧縮が必要になる場合は、まずコンテンツの論理を保ち、次のいずれかを選択します。

  • 内容をより豊かに保ったデッキにする
  • または、slides_message_plan.mdでトレードオフを明示したうえで、意識的に圧縮版を作成する

スキルで短いデッキを作成できるからという理由だけで、内容の豊富な記事を短いデッキにまとめないでください。

インフォグラフィックだからといって、テキスト密度が一律に決まるわけではありません。 余白の多いキーノートスライドが適しているデッキもあります。 一方で、自己完結型の解説インフォグラフィックやティーチングポスターのように、目に見えるテキスト、ラベル、数式、図のキャプション、説明セクションを多く含むデッキもあります。 どのデッキも同じ低テキストの美的表現に寄せるのではなく、内容に最も適した密度とレイアウトの種類を選びます。

ユーザーが明示的に別の指定をしない限り、デフォルトではデッキ全体で1つのスタイルパックを使い、レイアウトはスライドごとにスキルに選択させます。

  • 短い感情訴求のスライドや導入スライドには、L4、L5、L6が割り当てられることがよくあります。
  • シネマティック、エディトリアル、温かみのある、開放的な、アニメーション、若者向けのデッキでは、短い/中程度の文脈説明スライドや応用スライドに、シーン内に落ち着いたテキスト用スペースを確保できる場合、L1より先にL4またはL6を試します。
  • ティーチング、フレームワーク、比較、解説型ポスターのスライドでは、構成や情報量に応じて、L1、L2、L3、L7、L8、L9、L10、L11がよく割り当てられます。
  • 同じスタイルパックでも、1つのデッキ内で分割パネルと全面表示のレイアウトを併用できます。
  • 記事を起点とするインテークのガイダンスが必要な場合は、references/article_intake_workflow.mdを参照してください。
  • アーキタイプの割り当てに関するガイダンスが必要な場合は、references/deck_archetype_routing.mdを参照してください。
  • レイアウトの割り当てに関するガイダンスが必要な場合は、references/layout_routing_policy.mdを参照してください。

スライドプロンプトのレシピ(コピー/貼り付け用テンプレート)

references/prompt_template.md を読み、スライドごとに記入してください。極めて具体的に記述してください。

  • 任意のスライド装飾から始めるのではなく、推定した記事構成、メッセージプラン、表示プラン、デッキのアーキタイプを起点にしてください。
  • slides_display_plan.md にある、スライド上に表示する必要のあるテキストをすべて、具体的なプロンプト内の1つの正確なテキストブロックにまとめてください。
  • スライドが情報量の多い教育用インフォグラフィックの場合は、モデルが正しく考案してくれることを期待せず、表示されるすべてのセクション見出し、ラベル、吹き出し、数式ラベル、図のキャプション、モジュール見出しを、その正確なテキストブロックに含めてください。
  • ビジュアルについては、シーンのレイヤー(遠景/中景/前景)に加え、具体的なオブジェクトを3~8個記述してください。
  • 高い忠実度を得るには、スタイルパック名やレイアウトファミリーを指定するだけで終わらせないでください。形状、配色/素材の表現、タイポグラフィの印象、仕切り/モジュールの構成、光の当たり方を、平易な文章で指定してください。
  • テキストの読みやすさを保つため、何を控えめ/低コントラストにするかを明記してください。
  • スライド上のテキストが中国語、ドイツ語、または二言語であっても、特に指定がなければプロンプトの指示は英語にしてください。
  • 通常の英語の場合、具体的なプロンプトに冗長な言語メタデータを加えないでください。スライドに英語以外または複数言語の表示テキストが含まれる場合や、言語設定が曖昧になり得る場合に限り、プロンプト/出力言語を明示してください。
  • プレゼンテーションの2つの系統を意図的に使い分けてください。情報量の多い教育コンテンツには分割パネル/ボード形式のインフォグラフィックを、単独で完結する教育用スライドには教育用ポスター形式を、タイトルカード、引用スライド、シーン主導の感情的な場面には全面塗りのシネマティックなオーバーレイ形式を使用してください。
  • 分割パネルの表現は、一般的なプレゼンテーション用語ではなく、明確なレイアウト指示として扱ってください。ユーザーが画像の上に直接テキストを置くことを希望する場合は、プロンプトを書く前に L1 以外のレイアウトを選んでください。
  • L1~L11 は内部の振り分け用識別子であり、モデルに渡すプロンプトに含めないでください。画像モデルには L9を使用 ではなく、中央の仕切りがある、左右対称の2領域から成る教育用ボードを使用する のような構成指示を渡してください。
  • スタイルパックのファイルも同様に、内部参照用の資料であり、プロンプトにそのまま含める断片ではありません。最終的なプロンプトは、シリアライズされたメタデータではなく、直接的なアートディレクションと表示指示として読めるようにしてください。
  • 入力画像や編集に関する仕組みも同様に、ツール側の仕組みであり、プロンプトに含める指示ではありません。最終的なスライドの仕上がりを記述し、編集ツールを使用している事実には触れないでください。
  • メタデータを取り除いた後も最終的なプロンプトが汎用的な印象なら、短くするのではなく、内容を充実させてください。高い忠実度を実現するプロンプトには通常、コンテンツとスタイルラベル1つだけでなく、具体的なビジュアルの指定が必要です。
  • 全面塗りのレイアウトでは、構図によって読みやすさを確保しつつ、画像自体にテキストを直接配置することを基本としてください。ユーザーが明示的にその処理を希望しない限り、角丸の矩形、すりガラス風カード、キャプションボックスを表示するよう指示しないでください。
  • 既定では、ユーザーにスライドごとのレイアウトを尋ねないでください。スライドの役割、テキスト量、表示密度、デッキ全体のスタイルに基づいて、内部でレイアウトを振り分けてください。Layout hint を明示的に使うのは、ユーザーまたは slides_visual_plan.md に指定がある場合に限ります。
  • 記事の内容から適切なスタイルパックが明らかな場合、既定ではユーザーにスタイルパック ID を尋ねないでください。まずアーキタイプを推定し、その後スタイルを選んでください。 記事を先に取り込む際のガイダンスが必要な場合は、references/article_intake_workflow.md をお読みください。 デッキのアーキタイプを選択する際のガイダンスが必要な場合は、references/deck_archetype_routing.md をお読みください。 より映画的なシーン素材や小道具のアイデアが必要な場合は、references/scene_library.md をお読みください。 選択やフィルタリングに使える安定したシーン ID とタグが必要な場合は、references/scene-catalog.md をお読みください。 そのまま使えるビジュアルシーンのブロックが必要な場合は、references/scene-preset-library.md をお読みください。 信頼性の高いインフォグラフィック構成や、全面塗りつぶしのタイトルカードレイアウトが必要な場合は、references/layout_library.md をお読みください。 各レイアウトを使うタイミングの自動振り分けルールが必要な場合は、references/layout_routing_policy.md をお読みください。 プロンプトを書く前に、具体的な良い例と悪い例を確認したい場合は、references/prompt_example_library.md をお読みください。 スタイル、レイアウト、シーンの選択を具体的なプロンプトに落とし込むための、より精度の高いチェックリストが必要な場合は、references/high_fidelity_prompt_playbook.md をお読みください。 ユーザーがスクリーンショットやスライドの例を提示し、そのスキルに学習させたい場合は、references/reference_slide_intake.md をお読みください。 ショット表現、時間帯、天候、照明のプリセットが必要な場合は、references/shot_mood_library.md をお読みください。 スタイルのモジュール化が必要な場合は、references/style-pack-system.md をお読みになり、scripts/compose_style_pack_blocks.py を使用してください。 誤字を減らし、読みやすさを高めるには、すべてのスライドプロンプトに次の項目を貼り付けてください:references/typography_spacing_lock.md、references/text_fidelity_block.md、references/negative_prompt_block.md。 ストーリーボードのような視聴リズムにしたい場合は、references/storyboard_library.md をお読みください。 スライドで言語固有のレンダリング制約がある場合や、非ラテン文字の長い引用ブロックを使う場合は、具体的なプロンプトを書く前に関連する参考資料をお読みください(例:references/chinese_quote_compression.md)。

品質基準(および反復改善の方法)

各スライドについて:

  • メッセージとの適合を最優先:デッキには、単に個々の見栄えのよいスライドを並べるのではなく、記事の構成と意図、そしてより詳細なメッセージプランを反映させます。
  • 表示内容の節度を次に重視:スライドには、発表内容全体ではなく、聴衆が目にする必要のある内容だけを表示します。
  • 読みやすさを最優先:文字を複雑な画像に重ねないでください。選択したレイアウトに応じて、専用のテキストパネルを使うか、意図的に見やすくした、テキストを重ねても読みやすい領域を使います。
  • 自動レイアウトを最優先:ユーザーが明示的に指定しない限り、構図の種類を固定するのではなく、スライドの役割、テキスト量、スタイルに基づいてスキルにレイアウトを選ばせます。
  • テキストを捏造しない:余計な単語、ロゴ、透かしを追加しないでください。
  • 指定された言語・文字体系のテキストを忠実に再現:文字、アクセント記号、単語、句読点に誤りがある場合は、次の方法でそのスライドを再生成します:
    • 引用ブロックを短くする。
    • All required on-slide text must be exact. Do not rewrite. Do not add or remove punctuation or spaces.
    • 背景をシンプルにする。
  • エンゲージメント:背景のシーンやテクスチャ、アイコンのまとまりを加えますが、コントラストは抑えます。
  • 内容に応じて、説明的な情報量を増やしてもかまいません:自己完結型の学習用スライドでは、階層、余白、図の構成が明確であれば、基調講演用スライドより多くの語句を表示してもかまいません。

よくある問題への対処:

  • デッキの見た目は洗練されているのに、構成が適切でない:references/article_intake_workflow.md とメッセージ/表示の境界を見直し、プロンプトを書き直す前にスライドの役割や表示内容の整理を修正します。
  • ツール呼び出しが失敗する/エラーが断続的に発生する:少し待ってから再試行します。プロンプトは安定させ、エラーが繰り返される場合に限りシーンをシンプルにします。
  • 文字が小さすぎる:箇条書きの数を減らし、2枚のスライドに分けます。大きな文字と、ゆとりのある行間を指定します。
  • インフォグラフィックを使った学習用途なのに、スライドが空きすぎている:L9、L10、またはL11に切り替え、内容が少ないふりをせず、必要なラベル、キャプション、数式、比較見出しを明示的に含めます。
  • ごちゃついている:コントラストを抑えた背景にし、シーンは主に右側に配置して、左側のパネルはすっきりさせます。
  • デッキが暗すぎる:editorial-lightまたはairy-relaxedに切り替え、ビネットを無効にし、昼光のシーン ID を指定して、明るさを上げる設定を追加します。
  • 全面に画像を敷いたレイアウトなのに、文字の表示領域が枠に囲まれたように感じる:表示されるカード、角丸の長方形、すりガラス風のパネル、枠付きバナーをなくし、局所的なコントラスト補助だけを控えめに加えて、画像に直接テキストを配置するよう指定します。
  • シネマティック/エディトリアル/暖色系のスライドでパネルの位置がずれる:references/prompt_example_library.mdと照らし合わせ、L1からL4またはL6に切り替え、再試行前にtext panelという表現を取り除きます。
  • 自動選択されたレイアウトが適切でない:references/layout_routing_policy.mdに従ってスライドのレイアウトを選び直します。最初の推測で選ばれたという理由だけで、適切でないレイアウトを使い続けないでください。
  • 言語・文字体系の再現精度が落ちる:まずテキストを短くし、背景をシンプルにして、該当する言語固有の描画リファレンスを使い、その後でスタイルやレイアウトを調整します。
  • アスペクト比が合わない:プロンプトで16:9の制約をより厳密に指定して、そのスライドを再生成します。トリミングなどの後処理は行わないでください。
    • 再試行時は、プロンプトのテキストとツール呼び出しの設定の両方で、同じ16:9を指定してください。

実行モード(焦らず、「試し画像」は避ける)

  • 画像生成には時間がかかることがあります。実際のスライドを直接生成することを優先してください。
  • ユーザーから診断用の画像を明示的に求められない限り、テスト用/試行用の画像(例:無地の背景)は生成しないでください。
  • 画像の呼び出しが断続的に失敗した場合は、少し待ってから同じスライドのプロンプトで再試行します。一度に複数の要素を変更しないでください。
  • デフォルトの納品方法は生成物をそのまま使用することです。生成した画像はそのまま使い、画像から直接 PPT を組み立てます。
  • 後続の生成を安定させるために背景の探索用画像を作成する場合は、画像ツールへの参照入力としてのみ扱います。後からテキストを重ねたり、画像ツール以外の方法で合成したりするためのキャンバスとして使わないでください。

ツールの制約(重要)

画像ツールによっては、特定のディレクトリ(多くの場合、~/Downloads またはワークスペースのパス)への出力画像の書き込みしか許可されないことがあります。書き込みがブロックされた場合:

  1. 許可されたディレクトリ(例:~/Downloads/<deck_id>/)に画像を生成します。
  2. 画像をプロジェクト/ワークスペースの出力フォルダーにコピーします。

同梱スクリプト

scripts/compose_style_pack_blocks.py
  • 継承したスタイルパックのブロックを、貼り付けてすぐ使える1つのバンドルにまとめます。
  • スタイルの不一致を防ぐため、プロンプトを作成する前に使用します。

実行:

python3 scripts/compose_style_pack_blocks.py --pack-id editorial-light
scripts/create_style_pack.py
  • マニフェストとブロックのテンプレートを含む新しいスタイルパックのフォルダーを作成します。
  • 既存のパックでは不十分で、すばやく拡張する必要がある場合に使用します。

実行:

python3 scripts/create_style_pack.py --pack-id warm-minimal --display-name "Warm Minimal" --keywords "warm,balanced" --scene-tags "warm,clean"
scripts/build_images_only_pptx.py
  • 全画面表示の slide*.png をファイル名順に連結して、画像のみの PPTX を作成します。
  • ユーザーが PPT の内容を「画像の連結のみ」にすることを希望し、PPT のテキストボックスを必要としない場合に使用します。

依存関係(未インストールの場合はインストール):

python3 -m pip install python-pptx

実行:

python3 scripts/build_images_only_pptx.py --images-dir /path/to/slides --out /path/to/deck.pptx

参考資料

  • 高い詳細度のプロンプトのひな型を使って「背景が豊かなインフォグラフィック」スタイルを安定して生成する必要がある場合は、references/prompt_template.md を読んでください。
  • ユーザーが記事全体を提示し、スキルにデッキの戦略を推測させる場合は、references/article_intake_workflow.md を読んでください。
  • 記事に最適なプレゼンテーション形式全体を決める際は、references/deck_archetype_routing.md を読んでください。
  • 構成ルールとスタイルパックの追加方法については、references/style-pack-system.md を読んでください。
  • 意図に応じたスタイルの振り分けとパックの選択については、references/style-pack-catalog.md を読んでください。
  • 自己完結型のスタイル定義については、references/style-packs/ を読んでください。
  • 上流の内容が不足しているスライド表を、表示とビジュアル計画の前に slides_message_plan.md に正規化するには、references/slide_table_normalization.md を読んでください。
  • 再利用可能なシーン ID とタグについては、references/scene-catalog.md を読んでください。
  • そのまま貼り付けて使えるシーンのビジュアルブロックについては、references/scene-preset-library.md を読んでください。
  • カタログに新しいシーン ID を追加する場合は、references/scene-entry-template.md を読んでください。
  • スライドを煩雑にせず、シーンを基にした要素やシネマティックな要素(場所と小道具)をすばやく追加するには、references/scene_library.md を読んでください。
  • テキスト量に合ったレイアウトを選び、スライドの読みやすさを保つには、references/layout_library.md を読んでください。
  • ユーザーがレイアウトを明示的に指定していない場合に、レイアウトを自動で振り分けるには、references/layout_routing_policy.md を読んでください。
  • シネマティックなショット、照明、時間帯のプリセットについては、references/shot_mood_library.md を読んでください。
  • デッキの一貫性を高めるために、任意でモチーフを繰り返し使う際のガイダンスが必要な場合は、references/motif_pack.md を読んでください。
  • 照明の方向、リズム、質感の表現をスライド間で統一するための任意のルールについては、references/deck_consistency_block.md を読んでください。
  • 小さすぎる文字を防ぎ、余白を統一するには、references/typography_spacing_lock.md を読んでください。
  • テキストの誤りを減らし、どの言語でも余計な語句を一切追加しないようにするには、references/text_fidelity_block.md を読んでください。
  • 透かしや指定外のテキスト、UI といった、生成時によくある問題を避けるには、references/negative_prompt_block.md を読んでください。
  • デッキ全体に物語の流れを持たせるには、references/storyboard_library.md を読んでください。
  • スライドに載せるテキストが中国語で、言い換えずに分割する必要があるほど長い場合に限り、references/chinese_quote_compression.md を読んでください。

コメント