huashu-slides

AI プレゼンテーションのワークフロー

プロフェッショナルなプレゼンテーションを作成します：コンテンツ → デザイン → 作成 → 組み立て → 仕上げ。

ステップ 0：ワークフローの設定を選ぶ

すべてのプレゼンテーション作成タスクの開始時に、ユーザーに2つの選択肢を尋ねます。

0-A. コラボレーションモード

モード	説明	チェックポイント
フルオート	やり取りを最小限にします。トピックのみ確認し、完成した PPTX を納品します。	1 チェックポイント
ガイド付き（推奨）	アウトラインを確認し、デザインを選び、組み立て前にプレビューします。	3 チェックポイント
共同作業	すべてのスライドを確認し、すべてのイラストを承認して、全工程を管理します。	スライドごと

ユーザーが指定しない場合は、デフォルトでガイド付きモードにします。

0-B. 組み立て方法

方法	仕組み	最適な用途
編集可能な HTML（パス A）	HTML スライド + 必要なものだけ AI イラストを追加 → html2pptx → 編集可能な PPTX	後からテキストを編集したい場合、正確なレイアウト、企業向けの資料
AI ビジュアルのみ（パス B）	各スライドを AI 生成の完全な画像として作成 → create_slides.py → 画像ベースの PPTX	最大限の視覚的インパクト、芸術的なプレゼンテーション、手早い下書き

トレードオフ：

	パス A：編集可能な HTML	パス B：AI ビジュアルのみ
テキスト	PPT で編集可能	画像に埋め込まれる（編集不可）
ビジュアル品質	イラストを使うと良好	優秀 — 統一感のあるデザイン
レイアウトの制御	ピクセル単位で正確	AI が解釈
ファイルサイズ	小さめ（約 5～25MB）	大きめ（約 30～80MB）
中国語テキスト	完璧（フォントレンダリング）	通常は良好（AI がまれに誤って描画する場合あり）
速度	高速（HTML 作成）	低速（スライドごとに画像を生成）

ユーザーが指定しない場合は、デフォルトでパス A（編集可能な HTML）にします。

---

ステップ 1：コンテンツの構成

生の素材を、スライドごとのアウトラインにまとめます。

スライドごとに定義する項目：

• タイトル — 完結した主張の文（トピック名だけにしない）
• 要点 — 最大 3～4 項目
• ビジュアルタイプ — イラスト／グラフ／図解／アイコン／引用
• パス A： イラストが必要か？ — はい／いいえ。はいの場合は、1 行で説明します。
• パス B： ビジュアルシーンの説明 — レイアウト、画像、雰囲気を含むスライド全体のビジュアルを 1 段落で説明します。

主張と根拠のルール：

悪いタイトル	良いタイトル
Q3 売上	Q3の売上は23％増加し、新規ユーザーが主な成長要因となりました
方法論	二重盲検実験によって、この結論を検証しました

言語ルール：スライドの内容はすべて中国語にし、必要な英語の用語（人名、ブランド名、技術上の固有名詞）のみを残します。 INSIGHT、TAKEAWAY などのセクションラベルは、デザイン要素として英語を使用できます。

✅ チェックポイント 1（ガイド付き + 共同作業）

アウトラインを表として提示します。

パス A：

| # | Title (assertion) | Key Points | Visual Type | Illustration? |
|---|-------------------|------------|-------------|---------------|
| 1 | Cover: ... | — | Decorative | Yes: ... |
| 2 | ... | 1. ... 2. ... | Chart | No |
| 3 | ... | 1. ... 2. ... | Illustration | Yes: ... |

パス B：

| # | Title (assertion) | Key Points | Visual Scene Description |
|---|-------------------|------------|--------------------------|
| 1 | Cover: ... | — | Dark gradient bg, large title centered, abstract network nodes |
| 2 | ... | 1. ... 2. ... | Split layout: text left, bar chart right, clean white bg |
| 3 | ... | 1. ... 2. ... | Full illustration: person at crossroads with floating clocks |

ユーザーに尋ねます：

• スライド数を承認するか、調整するか
• パス A：イラストを入れるスライドを承認するか、調整するか
• パス B：ビジュアルシーンの説明を承認するか、調整するか
• 追加または削除するコンテンツがあるか

---

ステップ 2：デザインシステム

ユーザーが選べるよう、デザインシステムの選択肢を3つ提示します。 それぞれは単なるカラーパレットではなく、完全なビジュアルランゲージです。

重要：デザインシステムは色だけではありません。 ビジュアルの哲学、タイポグラフィの比率、構成ルール、感情的な意図を定義します。これが「退屈な PPT」と「雑誌のようなクオリティの資料」の違いです。

🗣️ スタイルの相談（任意。ユーザーが希望する場合）

ユーザーが次のように言った場合：

• 「XX のスタイルにしたい」（田中一光、スイス・インターナショナル・スタイル、バウハウス、モンドリアンなど）
• 「どんなスタイルにしたいか、まだ決めていません」
• 「いろいろなスタイルの例を見せてもらえますか」

その場合は、デザインムーブメントのリファレンスを参照します。 references/design-movements.md — デザインムーブメントとスタイルのリファレンス集

このファイルでは、古典的なデザインムーブメント（ネオ・ブルータリズム、スイス・スタイル、バウハウスなど）を、AI ですぐに使えるスタイルプリセットに対応づけています。次の目的に活用してください。

1. ユーザーの美的な表現を、実行可能なプロンプトに変換する
2. 共通の語彙を作る（「この方向性は田中一光寄り」対「こちらは構成主義寄り」）
3. 新しいカスタムスタイルをゼロから設計する際に参照する

---

デザインシステムのプリセット

⚠️ 重要なポイント：イラスト／マンガ系のスタイルは、「プロフェッショナルでミニマル」なスタイルよりも AI 生成の仕上がりがはるかに優れています。 マンガ／イラスト系のスタイルには、明確なビジュアルランゲージ（線、キャラクター、色面）があり、AI の能力を十分に活かせます。一方、ミニマルなスタイル（暗い背景＋光る文字＋広い余白）はビジュアル要素に乏しく、生成結果が「空っぽ」で「平坦」になりがちです。 トピックや雰囲気に合うものを3つ選びます。以下のトピック別おすすめ表を使い、それぞれを完全な説明付きで提示します。

テーマ別の自動おすすめ（この表から優先して選択）：

テーマの種類	第一候補	第二候補	第三候補
ブランド／製品紹介	Snoopy温暖漫画	Neo-Pop新波普	浮世絵／敦煌（東洋ブランド）
教育／トレーニング	Neo-Brutalism	学習漫画	Snoopy温暖漫画
技術共有	xkcd白板	Neo-Brutalism	Ligne Claire
データレポート	Pentagram編集	Fathomデータ	Ligne Claire
若年層	Neo-Pop	ピクセルアート	孔版印刷
クリエイティブ／アート	ダダ・コラージュ	孔版印刷	The Oatmeal
中国風／東洋風	敦煌壁画	浮世絵	Takram思索
正式なビジネス	Pentagram編集	Müller-Brockmannグリッド	Buildミニマル
製品発表／keynote	ソビエト構成主義	Neo-Pop	Pentagram編集
社内共有	Neo-Brutalism	The Oatmeal	xkcd白板
業界分析／コンサルティング	Fathomデータ	Pentagram編集	Müller-Brockmannグリッド
トレーニング資料／教材	Takram思索	温かみのあるストーリーテリング	学習漫画
投資／資金調達のプレゼンテーション	Buildミニマル	Pentagram編集	ソビエト構成主義

18種類のスタイルの詳細なリファレンス： references/proven-styles-gallery.md スタイルのサンプル画像： assets/style-samples/ ディレクトリ

---

第一グループ（強くおすすめ。非常に高い効果が得られます）：

1. 温かみのあるコミックストリップ — Snoopy温暖漫画スタイル

• 哲学：Peanuts漫画の温かみと哲学的な雰囲気です。シンプルなキャラクターが深い言葉を語り、日常の風景に人生の知恵が込められています
• ビジュアルの世界：丸い頭の子ども、子犬、小鳥が織りなす温かな小世界です。背景はシンプルです（草原、空、犬小屋、木）。色調は、黄ばんだ新聞漫画のようです
• 参考：「Peanutsのコミックストリップのように、温かく、哲学的で、魅力的」
• スタイルガイド： references/proven-styles-snoopy.md
• ⚠️ 重要なポイント： プロンプトで視覚的な細部（色の割合、構図上の位置、キャラクターのポーズなど）を過度に指定しないでください。多様性が大きく損なわれます。感情と内容だけを記述し、AIに自由に表現させてください

2. 学習漫画 — 学習漫画スタイル

• 哲学：日本の学習漫画です。キャラクターがリアクションやドラマを交えながら、概念を案内します
• 色：明るく温かみのあるパレットです。白い背景に、選択的に色を使ったパネルを配置し、強調したい部分にはスクリーントーンのグレーを使います
• 比率：イラスト60％／テキスト（吹き出し内）30％／効果10％
• タイポグラフィ：インパクトのある太字の漫画風タイトル、吹き出しや思考バブル内の本文、装飾要素としてのオノマトペです。サイズ比は3:1です
• 構図：躍動感のある漫画のコマ割り（1枚あたり3〜5コマ）です。キャラクターのリアクションで強調点を示し、スピード線で勢いを出し、ドラマチックなアングルを使います
• ビジュアル言語：表情豊かなアニメ風キャラクター（驚き、困惑、ひらめきなどのリアクション）、漫画の効果（汗、きらめき、スピード線）、太さに変化をつけたコマの枠線です
• 参考：「『統計学の漫画ガイド』のページのように、キャラクターが驚きや喜びを見せながら、概念を順を追って説明します」

3. Ligne Claireのコミック — 清線漫画スタイル

• 哲学：Hergéの『タンタン』の伝統です。視覚的な抑制によって情報を最大限に明瞭にします
• 色：白／クリーム（#FFFDF7）の背景、黒（#000000）の輪郭線、ベタ塗りの彩度の高い色（3〜5色。グラデーションなし）です
• 比率：すっきりした背景70％／イラスト20％／テキスト10％
• タイポグラフィ：タイトルは手書き風、本文は読みやすいサンセリフ体です。重要な引用には吹き出しを使います。タイトルと本文のサイズ比は2.5:1です
• 構図：コマを使ったレイアウト（1枚あたり2〜4コマ）で、左から右へ順に読み進められる構成です。コマ間の余白を明確にします
• ビジュアル言語：均一な太さの輪郭線、陰影やハッチングのないベタ塗り、グラデーションなし、細部は正確にしつつ視覚的なノイズはゼロです
• 参考：「概念を説明する『タンタン』のページのように、すべてのコマが理解を深め、装飾的な要素はありません」

4. ネオポップ雑誌 — 新波普雑誌スタイル

• 哲学：若者向けメディアやストリートウェアブランドの美学です。大胆で遊び心があります
• 色：クリーム（#FFF8E7）の背景、黒（#000000）のテキスト。ホットピンク（#FF1493）＋シアン（#00CED1）＋イエロー（#FFD700）のカラーブロックを使います
• 比率：背景50％／カラーブロック25％／コンテンツ25％
• タイポグラフィ：見出しがスライド領域の40〜50％を占めます（タイポグラフィ自体をビジュアルとして扱います）。テキストブロックを太い黒枠で囲み、本文とのサイズ比は10:1です
• 構図：「コントロールされた混沌」を表現するモジュール式カラーブロック、積み重ねた非対称レイアウト、太い枠線です
• ビジュアル言語：ピクセルアート風の8ビットアイコン、切り抜き写真、吹き出し、大胆なグラフィック面です
• 参考：「SupremeのルックブックとHYPEBEASTの記事を組み合わせたように、タイポグラフィをグラフィックアートとして扱います」

第二グループ（おすすめ。特定の場面で効果を発揮します）： 5. ホワイトボードスケッチ — xkcdの白板手描き風

• コンセプト：xkcdと教授のホワイトボードを融合。極限までミニマルにすることで、アイデアそのものに集中させます
• 色：白（#FFFFFF）の背景、黒（#000000）のインク、強調用のアクセントカラーを1色（赤 #FF4444 または青 #4488FF）
• 比率：余白85%／スケッチ10%／アクセントのハイライト5%
• タイポグラフィ：すべて手描き・手書き風にし、ベースラインを不揃いに。矢印や注釈を随所に配置します。重要な数字は大きく（60pt以上）表示できます
• 構成：自由なホワイトボードレイアウト。手描きの矢印で概念をつなぎ、図や棒人間を使って、くだけた生き生きとした雰囲気にします
• ビジュアル表現：棒人間、手描きのチャートやグラフ、揺らいだ線、注釈の矢印、丸で囲んだキーワード、数式風のレイアウト
• 参考：「xkcdの『What If?』の解説のように、シンプルな絵で複雑なアイデアをすぐに理解できるスタイル」

6. ソビエト構成主義 — ソビエト構成主義

• コンセプト：革命のプロパガンダポスター。幾何学と限られた色数で力強さを表現します
• 色：革命的な赤（#CC0000）40%＋黒（#1A1A1A）25%＋クリームホワイト（#F5E6D3）30%
• タイポグラフィ：すべてのテキストを15～30度傾け、水平線は使いません。太く、幅の狭い書体を使います
• 構成：左下から右上へ伸びる斜めのくさび形。幾何学図形を小から大へと拡大させ、視覚的なクレッシェンドを生み出します
• ビジュアル表現：グラデーションは使わず、完全なベタ塗りと鋭いエッジで表現します。色は3色に限定し、プロパガンダポスターの力強さを出します
• 参考：「1920年代のロトチェンコのポスターのように、力強さ、緊迫感、幾何学的な精密さを備えたスタイル」

7. 温かみのあるナラティブ — 温かいストーリーテリング風

• コンセプト：TEDトークのビジュアルやAirbnbのピッチデックのような、親しみやすいストーリーテリング
• 色：温かみのあるクリーム（#FDF6EC）の背景、濃いチャコール（#3D3D3D）のテキスト、コーラル（#E17055）のアクセント
• 比率：温かみのある背景60%／コンテンツ25%／イラスト15%
• タイポグラフィ：見出しは太く温かみのある書体にし、本文との比率は3:1にします。箇条書きではなく、短い文を使います
• 構成：スライドの40～50%をイラストが占め、ビジュアルの周囲にテキストを回り込ませます。角丸の図形を使います
• ビジュアル表現：温かみのある配色のフラットなベクターイラスト、人を中心としたイメージ、ストーリーの流れ
• 参考：「MailchimpやNotionのブランドプレゼンテーションのように、親しみやすく人間味のあるスタイル」

**その他のスタイル（第2・第3グループ）**は references/proven-styles-gallery.md を参照してください。The Oatmealインフォグラフィック漫画、敦煌壁画、浮世絵、リソグラフ、アイソメトリック、バウハウス、設計図、レトロ広告、ダダ・コラージュ、ピクセルアートなどが含まれます

---

第4カテゴリ：Professional / Editorial デザインシステム（Path A 専用）

⚠️ 以下のスタイルでは、Path A（HTML→PPTX）の使用を強くおすすめします。正確な組版、データの可視化、グリッドシステムに依存しているため、AI画像生成では必要な精度を実現できません。歯科業界の分析事例では、Path A＋Pentagram編集スタイルの優れた効果が実証されています。

8. Pentagram Editorial — 編集雑誌風（情報建築派）

• コンセプト：Pentagram／Michael Bierut — 書体は言語であり、グリッドは思想です。徹底して抑制されたデザインにより、データとコンテンツ自身に語らせます
• 色：クリームホワイト（#FFFDF7）の背景、ほぼ黒（#1A1A1A）のテキスト、アクセントカラーは1色（例：橙赤 #D4480B またはブランドカラー）
• 比率：余白60%／コンテンツ30%／アクセント10%
• タイポグラフィ：太い黒の見出し（28pt以上）＋軽やかな本文（10～13pt）。英語のセクションラベルをデザイン要素として使用（INSIGHT / PART 03）
• 構成：スイス・グリッドシステム、2pxの黒い枠線のカード、正確な水平の区切り線、データの可視化をレイアウトに組み込みます
• ビジュアル表現：ミニマルなアイコン、棒グラフ／円グラフ／トレンドライン、コールアウトボックス、タグ
• 参考：「McKinseyのインサイトレポートとMonocle誌を組み合わせたような、データが豊富でありながら編集的に洗練されたスタイル」
• 実行パス：Path A only（HTML→PPTX）
• 実践での検証済み事例：歯科業界分析の15ページデック（_temp/口腔行业分析/slides/）

9. Fathom Data Narrative — データナラティブ風（科学ジャーナル派）

• コンセプト：Fathom Information Design — すべてのピクセルに情報を持たせます。科学的な厳密さとデザインの優雅さを両立します
• 色：白（#FFFFFF）の背景、濃いグレー（#333）のテキスト、ネイビーブルー（#1A365D）をメインカラーに、ハイライトカラーを1色
• 比率：チャート／データ50%／テキスト30%／余白20%
• タイポグラフィ：GT America／Graphik風のサンセリフ体。大きな数字（60pt以上）を視覚的なアンカーとして使い、脚注や出典を正確に記載します
• 構成：情報密度を高めつつ、窮屈にならないようにします。注釈システムをレイアウトに組み込み、スモールマルチプルのチャート群や正確なタイムラインを配置します
• ビジュアル表現：散布図、ヒートマップ、タイムライン、注釈付きチャート、小数点以下まで正確なデータラベル
• 参考：「Nature論文のデータ補足資料とBloombergのデータ特集を組み合わせたようなスタイル」
• 実行パス：Path A only（HTML→PPTX） 10. Müller-Brockmann Grid — スイス・グリッドスタイル（純粋主義派）
• 哲学：Josef Müller-Brockmann — 客観性こそ美です。数学的に精密なグリッドシステムによって、どんなに混沌とした情報も秩序立てます
• 色：白（#FFFFFF）の背景、黒（#000）のテキスト、アクセントカラーは最大1色
• 比率：構造化されたグリッド70%／テキスト20%／アクセント10%
• タイポグラフィ：Akzidenz-Grotesk/Helvetica、厳密な8ptベースライングリッド、完全な左揃え、ウェイトのコントラスト（300対700）
• 構成：数学的な8列グリッド、すべての要素をグリッド線に揃え、装飾要素は一切使わず、機能主義を最優先
• ビジュアル言語：純粋な幾何学図形、黒い罫線の表、正確に揃えたリスト、アイコンもイラストもなし
• 参考：「オリジナルのスイス・スタイルのポスターのように、時代を超越し、合理的で、装飾はゼロ」
• 実行パス：Path A only（HTML→PPTX）

11. Build Luxury Minimal — ラグジュアリー・ミニマルスタイル（現代ブランド派）

• 哲学：Build Studio — 洗練されたシンプルさを実現するのは、複雑さよりも難しいことです。たっぷりとした余白と微妙なウェイトの変化で高級感を伝えます
• 色：純白（#FFFFFF）の背景、濃いグレー（#2D2D2D）のテキスト、単一のアクセント（ブランドカラー）を最小限に使用
• 比率：余白75%／テキスト15%／アクセント10%
• タイポグラフィ：ウェイトの変化はごく微妙（200～600）、見出しは非常に大きく（48pt以上）軽やかに、本文は小さく精緻に（12pt）、文字間隔はゆったりと
• 構成：黄金比に基づくレイアウト、要素は最小限にし、各ページで伝える内容はひとつだけにして、余白と開放感を優先
• ビジュアル言語：高級感のある製品画像（あれば）、ミニマルな線画アイコン、大きな単色の面、角丸カード
• 参考：「Appleの基調講演とCelineのルックブックを合わせたような、控えめながらも自信に満ちた表現」
• 実行パス：Path A（HTML→PPTX）

12. Takram Speculative — 日本的思索スタイル（東洋哲学派）

• 哲学：Takram — 技術は思考のためのメディアです。柔らかなテクノロジー感とコンセプトのプロトタイプ図で、深い思考を伝えます
• 色：ウォームグレー（#F5F3EF）の背景、濃いグレー（#3D3D3D）のテキスト、セージグリーン（#8B9D77）のアクセント
• 比率：暖色系の背景55%／図解25%／テキスト20%
• タイポグラフィ：丸みのあるサンセリフ体、見出しは太字にせず大きなサイズ（36pt以上）にし、本文は温かみのある表現（14pt）にして、行間をゆったりと取る（1.8）
• 構成：柔らかな影（blur 20px以上）、角丸（16px以上）、コンセプト図／フローチャートを中心的なビジュアルにし、カード形式でレイアウト
• ビジュアル言語：コンセプトのプロトタイプ図、柔らかなグラデーション、アートのようなフローチャート、手描き風アイコン、自然な色調
• 参考：「技術が攻撃的ではなく、思慮深く感じられるTakramのプロジェクトページのように」
• 実行パス：Path A（HTML→PPTX、画像はAI生成で補助可能）

さらに詳しいスタイルの詳細：design-philosophy スキルの references/design-styles.md を参照してください。20種類のデザイン哲学について、完全なプロンプトDNAが含まれています

🎨 カスタムキャラクタースタイル（ユーザー定義）

ユーザーが特定の漫画／アニメの美学を参考にしたい場合があります。ユーザーが「ドラえもん風に」や「スタジオジブリのように」と言った場合は、著作権のあるキャラクターを描く依頼ではなく、スタイルの参照として扱います。そのスタイルのビジュアルDNAを抽出して、カスタムデザインシステムを構築します。

キャラクターの参照をデザインシステムに変換する方法：

ユーザーの指定	抽出するビジュアル特性
「ドラえもん風」	丸い形、明るい青と白と赤の原色、シンプルな背景、かわいらしいプロポーション、魔法のひみつ道具が現れる演出
「スタジオジブリ」	水彩の質感、自然な緑と空の青、シンプルなキャラクターと細かく描き込まれた背景、温かさと驚き
「カルビンとホッブス」	ダイナミックなインクの筆致、表情豊かな動きの線、空想と現実の哲学的な対比、緑豊かな屋外の風景
「ワンピースの漫画」	大胆でダイナミックな線、誇張されたプロポーション、ドラマチックなアクションポーズ、高いエネルギー感、太い輪郭線
「クレヨンしんちゃん」	クレヨン風の粗い線、明るいフラットカラー、コミカルなプロポーション、日常の場面を不条理に描く表現
「アドベンチャー・タイム」	幾何学的でシンプルな形、パステル調のキャンディカラー、細い輪郭線、奇抜でシュールな背景

カスタムスタイルのテンプレート：

[User Style]: "[reference name]"
→ Shape language: [round/angular/geometric/organic]
→ Line quality: [thin uniform / thick varied / sketchy / brushwork]
→ Color palette: [specific colors extracted from that aesthetic]
→ Character style: [proportions, expressiveness level]
→ Background treatment: [detailed/minimal/abstract]
→ Emotional tone: [warm/energetic/philosophical/surreal]

タイポグラフィのルール（すべてのプリセット）

• フォントファミリーは最大2種類（見出し用1種類＋本文用1種類）
• 見出し：太字で個性を出し、36pt以上（トレンド：グラフィック面としてさらに大きく）
• 本文：すっきりとして読みやすく、18pt以上
• 中国語：システムのデフォルト（PingFang SC / Microsoft YaHei）
• 重要な原則：タイポグラフィは単なる情報の入れ物ではなく、デザイン要素です

✅ チェックポイント2（ガイド付き＋共同作業）

提案した3つのデザインシステムから1つを選ぶか、自分の好みを説明するようユーザーに尋ねます。 哲学、ビジュアル言語、参考例を含む全説明を提示します。

---

ステップ3：スライドを作成する

---

ステップ 3-A：HTML ＋ 選択的なイラスト（パス A）

重要なスライド用に AI イラストを生成し、その後 HTML のスライドファイルを作成します。

どのスライドにイラストが必要ですか？ 次の順で優先してください。

1. 表紙スライド — 常に必要です。ビジュアルのトーンを決めます。
2. 重要な洞察を伝えるスライド — 「なるほど」と思わせるスライドに最も効果があります。
3. 締めくくりのスライド — 任意ですが、効果的です。
4. データ量の多いスライド — AI アートではなく、チャートや図を使います。

イラストの生成 — nano-banana-pro スキルを使用します。

⚠️ nano-banana-pro は独立した外部スキルであり、このリポジトリには含まれていません。~/.claude/skills/ の下にない場合は、このリポジトリに同梱されている同等のスクリプトをそのまま使用してください（Gemini 3 Pro Image API を呼び出し、デフォルトで 16:9 を使用するため、スライドにぴったりです）。 uv run <本仓库路径>/huashu-wechat-image/scripts/generate_image.py --prompt "..." --filename "..." --resolution 2K

export $(grep GEMINI_API_KEY ~/.claude/.env) && \
uv run ~/.claude/skills/nano-banana-pro/scripts/generate_image.py \
  --prompt "[description]" \
  --filename "[timestamp]-slide-[N]-[name].png" \
  --resolution 2K

ベーススタイルのプロンプト — スタイルの接尾辞を 1 つ定義し、すべてのイラストに追加します。

[Base Style]: flat vector illustration, [palette background color] background,
[accent color] highlight elements, clean minimalist aesthetic,
professional presentation style, no text in image

スライドごとのプロンプト =［具体的な内容］＋［ベーススタイル］

重要なルール：

• 必ず「画像内にテキストなし」と指定してください。テキストは編集可能な要素として後から追加します。
• キーワードの羅列ではなく、内容を説明する文章を使ってください。
• カラーは HEX 値で明示してください。
• 一貫性を保つため、「フラットベクター」や「フラットイラスト」を指定してください。

HTML スライドへの埋め込み：

<div class="left"></div>
<div class="right"><img src="illustration.png" style="width: 280pt; height: 280pt;"></div>


<body style="background-image: url('illustration.png'); background-size: cover;">

✅ チェックポイント 3-A（ガイド形式：重要なイラスト 2～3 点をプレビュー、共同作業形式：すべてプレビュー）

生成されたイラストを表示します。「承認／再生成／スタイルに一貫性を持たせますか？」と尋ねてください。

---

ステップ 3-B：AI によるスライド全体の生成（パス B）

すべてのスライドを、レイアウト、テキスト、ビジュアルを含む完成済みの AI 画像として生成します。

⚠️ 最大の失敗要因：レイアウトの詳細やビジュアルの制限をプロンプトに詰め込みすぎることです。 制約が増えるほど、創造性と多様性は低下します。AI の生成に最も効果的なのは、具体的な配置、色の比率、キャラクターの制限ではなく、雰囲気、参考資料、内容を伝えることです。

AI 画像プロンプトの黄金律

短いプロンプト ＞ 長いプロンプト。 雰囲気と内容を説明する 3 文のプロンプトは、あらゆるビジュアルの詳細を指定する 30 行のプロンプトよりも良い結果を生みます。具体的には：

しないこと（多様性を損なう）	すること（創造性を引き出す）
色の比率を指定する（60%／25%／15%）	雰囲気を説明する（「日曜版のコミックのような温かみ」）
レイアウトの位置を指定する（「タイトルは中央、画像は右」）	特定の美的スタイルを参考にする（「ピーナッツのコミックストリップ」）
キャラクターを制限する（「スヌーピーではなく、オリジナルキャラクター」）	AI に自然な形でスタイルを解釈させる
含めるビジュアル要素をすべて列挙する	見る人にどんな気持ちになってほしいかを説明する
スライドごとのプロンプトにベーススタイルを毎回繰り返す	ベーススタイルは一度だけ定義し、スライドごとのプロンプトは短くする

ベーススタイルのプロンプト — 短く保つ

ベーススタイルを一度だけ定義し、すべてのスライドに追加します。5 行以内に収めてください。 ベーススタイルで雰囲気を設定し、スライドごとのプロンプトで内容を加えます。

[Base Style]:
VISUAL REFERENCE: [Specific art/design aesthetic in one sentence]
CANVAS: 16:9 aspect ratio, 2048x1152 pixels, high quality rendering.
COLOR SYSTEM: [Describe the mood/feel of colors, not exact ratios]

例（良い例 — 簡潔）：

VISUAL REFERENCE: Charles Schulz Peanuts comic strip — warm, philosophical, charming.
Characters include round-headed kids, a lovable beagle dog, and a small yellow bird.
CANVAS: 16:9 aspect ratio, 2048x1152 pixels, high quality rendering.
COLOR SYSTEM: Warm cream/newspaper tone background, soft muted pastels, warm ink lines.

アンチパターン（悪い例 — 指定過多）： ベーススタイルに、文字のサイズ、色の比率、構図の割合、余白の指定、ビジュアルの重みの分布を含めないでください。こうした制約は、多様性を損なう一方で品質を向上させません。

スライドごとのプロンプトの構成

スライドごとのプロンプトは短く、内容を絞ってください。ベーススタイルの詳細を繰り返したり、ビジュアルのレイアウトを細かく指定したりしないでください。

Create a [style] slide about [topic].

[Base Style]

DESIGN INTENT: [1 sentence — what the viewer should FEEL]

TEXT TO RENDER:
- Title: "[exact text]"
- Body: "[exact text]"

[Optional: 1-2 sentences describing mood or scene. Let AI decide composition.]

例 — 良い例と悪い例

悪い例（従来型の PPT — 退屈）：

Design a professional presentation slide.
Professional presentation slide, 16:9 aspect ratio, 2048x1152 pixels.
Dark navy background, light gray text, gold accent.
Slide type: content. Layout: Title at top-left, two columns below.
Title: "看涨期权收益结构"
Body: "行权价: 100元, 权利金: 10元"
Visual: a line chart showing call option payoff

→ 結果：どのテンプレートからでも作れそうな、ありきたりの PPT

良い例（雑誌レベル — 見事）：

Create a slide that feels like a Bloomberg terminal data visualization
brought to life as editorial art.

VISUAL REFERENCE: Bloomberg Businessweek data feature meets cinematic lighting.
CANVAS: 16:9, 2048x1152, sharp rendering.
COLOR SYSTEM: Deep black (#0A0A0A) background 75%, white text 15%,
gold (#BF9A4A) accent 10%. The gold represents profit — it should GLOW.
TYPOGRAPHY: The number "110" rendered at 100pt as the dominant visual anchor
(the break-even point IS the story). Supporting text at 14pt, muted gray.

DESIGN INTENT: The viewer should instantly FEEL the asymmetry of options —
limited downside, unlimited upside. The visual must make this visceral,
not just informational.

TEXT TO RENDER:
- Hero metric: "110" (giant, gold, the break-even price)
- Title: "盈亏平衡点" (medium, white, above the number)
- Left data: "行权价 100" "权利金 10" (small, gray, understated)
- Insight: "亏损有底 盈利无限" (accent color, bottom)

VISUAL NARRATIVE: A single golden curve emerges from the left side of the slide,
flat and muted in gray at -10 (the maximum loss), then suddenly bending upward
at the strike price, transitioning from gray to brilliant gold as it rises
into the profit zone. The curve should feel like a ray of light breaking
through darkness. The profitable area above zero glows with warm gold
atmospheric lighting, like sunrise. The chart has NO grid lines, NO axes labels
cluttering the visual — just the pure, dramatic curve and the giant "110"
floating at the inflection point.

→ 結果：ストーリーを伝える、エディトリアルなデータビジュアライゼーション

Path B プロンプトの主なルール

プロンプト品質チェックリスト（生成のたびに確認してください）：

1. ビジュアルの参考例 — プロンプトで特定のアートスタイルや出版物を指定していますか？（「プロフェッショナル」や「モダン」だけでは不十分です）
2. レイアウトではなくムード — プロンプトでは、要素をどこに配置するかではなく、見る人にどのように感じてほしいかを説明していますか？
3. テキスト内容 — 描画するすべてのテキストが、明確かつ正確に列挙されていますか？
4. 十分に短い — プロンプトは簡潔ですか？ 詳細な仕様を含む長いプロンプトは、多様性を低下させます。AI が自分で判断できることは削除してください。
5. 細かく指示しすぎない — 16 進数カラーの比率、タイポグラフィのサイズ、構図の割合、キャラクターのポーズの指示は含めないでください。

技術的なルール：

• 解像度を必ず指定する：鮮明なテキストを表示するには、2048x1152（2K、16:9）を指定します。
• すべてのテキストを一字一句そのまま含める — AI が正確な文言を描画できるようにします。
• 中国語を優先：スライド上のテキストはすべて中国語にし、必要な英語の専門用語のみ残します。
• 中国語テキストのヒント：最適な描画結果を得るため、タイトルは短く（8 文字以内）してください。
• キーワードの羅列ではなく、説明的な段落を使います。
• 並列で生成する：速度を上げるため、3～5 枚のスライドを同時に生成します。
• 一貫性：ベーススタイルはすべてのスライドに適用します。これは提案ではなく、必須のルールです。

生成コマンド（同じツールを使いますが、スライド全体のプロンプトを指定します）：

export $(grep GEMINI_API_KEY ~/.claude/.env) && \
uv run ~/.claude/skills/nano-banana-pro/scripts/generate_image.py \
  --prompt "[full slide prompt]" \
  --filename "slide-[NN]-[name].png" \
  --resolution 2K

nano-banana-pro がない場合は、同様に本リポジトリの huashu-wechat-image/scripts/generate_image.py に置き換えられます（Step 3-A の説明を参照してください）。

生成後の品質チェック：

1. テキストの正確さ — 中国語と英語のテキストがすべて正しく描画されているか確認します。
2. レイアウト — 要素が説明どおりに配置されているか確認します。
3. スタイルの一貫性 — スライド全体で色とデザインの言語が統一されているか確認します。
4. スライドにテキストの誤りがある場合 → プロンプトを調整して再生成します（テキストを簡略化するか、短くします）。

✅ チェックポイント 3-B（ガイド付き：すべてのスライドをまとめてプレビューします。協働：各スライドを承認します）

生成したスライド画像をすべてユーザーに表示します。次の点を確認してください：

• テキストは読みやすく、正確ですか？
• スライド全体でビジュアルスタイルに一貫性がありますか？
• 再生成するスライドはありますか？

---

Step 4: PPTX の組み立て

4-A: html2pptx ワークフロー（Path A）

スライドごとに HTML ファイルを作成し、html2pptx.js で変換します。

const pptxgen = require('pptxgenjs');
const html2pptx = require(process.env.HOME + '/.agents/skills/pptx/scripts/html2pptx.js');

const pptx = new pptxgen();
pptx.layout = 'LAYOUT_16x9';
await html2pptx('slide1.html', pptx);
await html2pptx('slide2.html', pptx);
await pptx.writeFile({ fileName: 'output.pptx' });

HTML のルール（pptx スキルより）：

• 本文の寸法：width: 720pt; height: 405pt（16:9）
• すべてのテキストは <p>、<h1>-<h6>、<ul>、<ol> タグ内に記述します。
• 背景と境界線は <div> 要素にのみ指定します。
• CSS グラデーションは使用しません — Sharp で事前に PNG としてレンダリングします。
• ウェブセーフフォントのみを使用します（Arial、Helvetica、Georgia など）。
• 画像：<img src="illustration.png" style="width: Xpt; height: Ypt;">

既知の問題： ファイルパスに中国語の文字が含まれていると、画像の読み込みに失敗することがあります。必要に応じて、ASCII 文字のパスへのシンボリックリンクを使用してください：

ln -sf "/path/with/中文/" /tmp/ascii-path

4-B: 画像の組み立て（Path B）

create_slides.py を使って、生成したスライド画像を PPTX にまとめます。

uv run ~/.claude/skills/image-to-slides/scripts/create_slides.py \
  slide-01-cover.png slide-02-intro.png slide-03-definition.png ... \
  --layout fullscreen \
  --bg-color 000000 \
  -o output.pptx

Path B の推奨レイアウト：fullscreen — 画像にレイアウト、テキスト、ビジュアルがすべて含まれているため、スライド全体に表示します。

レイアウト	用途
fullscreen	AI が生成したページ全体のスライド（Path B のデフォルト）
title_above	画像＋編集可能なタイトル（ハイブリッド方式）
title_left	分割：テキスト＋ビジュアル
center	余白を設けて中央に配置した画像
grid	1 枚のスライドに複数の画像

---

Step 5: プレビューと仕上げ

プレビュー

Path A： Playwright で主要な HTML スライドを 3～4 枚スクリーンショットにします：

npx playwright screenshot "file:///path/to/slide.html" preview.png \
  --viewport-size=960,540 --wait-for-timeout=1000

Path B： 生成したスライド画像をそのまま表示します（画像自体がスライドです）。Read ツールを使って、主要な PNG を 3～4 枚表示します。

✅ チェックポイント 4（すべてのモード）

プレビューをユーザーに表示します。 PPTX ファイルの準備ができたことを伝え、次の点を確認してください：

• 調整するスライドはありますか？
• Keynote／PowerPoint で開く準備はできていますか？

最終仕上げ（Keynote／PowerPoint で）

• トランジションとアニメーション
• 発表者ノート
• ブランドロゴの配置
• Path A：テキストの最終調整（編集可能）
• Path B：テキストは編集できません — テキストの誤りが見つかった場合は、スライド画像を再生成してください

デザインのクイックリファレンス

5/5/5ルール： 1行あたり5語以下、1スライドあたり5項目以下、テキスト量の多いスライドは連続5枚以下

認知負荷： 1スライドにつき1つのアイデア。1スライドあたり約1分。スライドは話を補完するものであり、内容を重複させないでください。

視覚的階層： F字型／Z字型の視線の流れ。タイトルと本文のサイズ比は約3：1。すべてのスライドに視覚要素を含めてください。

詳細なリファレンス：

• references/proven-styles-gallery.md — 検証済みのビジュアルスタイル17種類と、段階別のおすすめ
• references/proven-styles-snoopy.md — Snoopy／Peanutsスタイルのスライドごとの詳細なテンプレート
• references/prompt-templates.md — コンテンツ生成と画像生成のプロンプト
• references/design-principles.md — デザインの包括的なフレームワーク、カラーパレット、タイポグラフィ

関連スキル

スキル	役割
pptx	高度なPPTXの作成／編集（html2pptx、テンプレート）
nano-banana-pro	AIイラストの生成（Gemini 3 Pro Image）。外部スキルは本リポジトリには同梱されていません。未インストールの場合は、本リポジトリの huashu-wechat-image/scripts/generate_image.py を代わりに使用してください
multi-model	コンテンツの下書き作成に使う外部AI
design-philosophy	20種類のデザイン哲学を詳しく解説（スタイルDNA＋シーン別テンプレート＋評価基準）。プロフェッショナル／エディトリアルスタイルの詳細なプロンプトと評価ガイドを掲載

出力

• PowerPoint、Keynote、Google Slidesに対応した .pptx ファイル
• クロスプラットフォームでの互換性を確保するWebセーフフォント
• 再利用可能な、独立したPNG形式のAIイラスト

---

花叔制作 | AI Native Coder · 独立系開発者 公式アカウント「花叔」| フォロワー30万人以上 | AIツールと効率向上 代表作：小猫补光灯（AppStore有料ランキング1位）·《一本书玩转DeepSeek》