gpt-image-2
ConardLi/garden-skills
GPT Image 2 を使用して、3つのモード(OpenAI互換APIによる直接生成、ホスト側のネイティブ画像ツール向けのプロンプトエンジニアリング、純粋なプロンプトアドバイザリー)で画像を生成・編集します。ポスター、UIモックアップ、製品ビジュアル、地図、スライドなど、80種類以上の構造化されたテンプレートが含まれています。
...すべて拡張しますGPT Image 2
これはGPT Image 2向けのフォーカス型スキルであり、3つの実行環境のいずれでも使用できますが、動作には顕著な違いがあります。まず最初に、現在の実行モードを確認する必要があります。
このスキルが対応する画像タスクは以下の2種類のみです:
- 画像生成:
POST /images/generations - 画像の編集:
POST /images/edits
本ドキュメントでは、実行モード、スキルの構造、環境変数、保存/命名規則、テンプレートインデックス、モード認識ワークフローについて記載しています。詳細なテンプレートはすべて references/に配置されており 、階層的に整理されています:
- 第1レベル:カテゴリ別ディレクトリ
- 第2レベル:単一テンプレートのMarkdownファイル
実行モード(必読。何をするにも、まずこれを確認してください)
本スキルには軽量な検出スクリプトが付属しています。まず一度実行し、その結果に基づいて作業方法を決定してください:
node skills/gpt-image-2/scripts/check-mode.js
# 構造化された結果を上位のプログラムで使用したい場合:
node skills/gpt-image-2/scripts/check-mode.js --json
出力には mode = A / A? / B-or-C および recommendationが表示されます。3つのモードの定義は以下の通りです:
モード A · Garden ローカル画像生成
トリガー条件:環境変数 ENABLE_GARDEN_IMAGEGEN が真(1 / true / yes / on)であり 、かつ OPENAI_API_KEYが存在すること。
動作:「テンプレートの選択 → プロンプトの作成 → スクリプトの実行 → 画像の生成・保存」までのエンドツーエンドのプロセスが完全に実行されます。
scripts/generate.jsを使用してテキストから画像を生成し、scripts/edit.jsを使用して既存の画像を編集します。- プロンプトはデフォルトで
garden-gpt-image-2/prompt/に、画像はgarden-gpt-image-2/image/に保存されます。 - これが最強のモードです:あなたは画像ツールの「所有者」となります。
モード B · Host-Native:ホストに画像生成を委託
トリガー条件:Gardenが有効になっていない(ENABLE_GARDEN_IMAGEGENが 設定されていない/false)、ただし現在のホストAgentに画像生成ツールまたは画像MCPが標準搭載されている場合。
典型的な識別サイン(自己診断すべき点):
- ツールセットに
image_generation/imagegen/dalle/nano_banana/mcp__*image*/make_imageなどの類似した名前が含まれている - ユーザーがChatGPT / Codex / Gemini / Cursorなど、ネイティブ画像生成をサポートするクライアントで本スキルを呼び出している
- ユーザーが「自分のツールを使って画像を生成して」と明示的に指示した場合
動作:本スキルは プロンプト作成のガイドラインへと機能低下します――
- 引き続き「テンプレート選択 → フィールド入力 → 最終プロンプトの生成」というフローに従います。
-
node scripts/generate.jsを呼び出さないでください(APIキーがないため、必ず失敗します)。 - ホストが標準で備えている画像生成ツールを直接呼び出し、レンダリング済みのプロンプトを入力として渡す。
- ユーザーが希望する場合、プロンプトファイルを
garden-gpt-image-2/prompt/に保存しても構いませんが、画像の保存先はホストが決定し、強制はされません。
モード C · アドバイザー(プロンプト専門のアドバイザー)
トリガー条件:Gardenが有効化されておらず、かつホストのAgentにも画像生成ツールが一切ない場合。
動作:本スキルは「高品質なプロンプト作成アドバイザー」として機能します――
- 「テンプレートの選択 → フィールドへの入力 → 最終プロンプトの生成」というプロセスに従い、情報が不足している場合はユーザーに確認します。
- 最終的なプロンプトを ユーザーに直接表示し 、さらに
garden-gpt-image-2/prompt/に保存します。- .md - 簡単な「使用方法」のアドバイスを添える(例:ChatGPT / Midjourney / DALL·E / Sora / Nano Banana / 独自のバックエンド / サードパーティの GPT Image 2 ゲートウェイに投入する)。
- 画像生成に成功したかのように装わないでください。ユーザーに「そのまま再利用可能な高品質なプロンプトが生成されました。お使いの画像ツールで実行してください」と明確に伝えてください。
モード決定表
| 条件 | モード | スクリプトを呼び出す? | プロンプトをローカルに保存? | ディスクへの画像書き込み? |
|---|---|---|---|---|
ENABLE_GARDEN_IMAGEGEN=1 + キーあり |
A | ✅ generate.js / edit.js |
✅ 自動 | ✅ 自動 |
ENABLE_GARDEN_IMAGEGEN=1 だが KEY なし |
A? | ❌(まずKEYが必要) | — | — |
| 有効化されていない + ホストに画像ツールがある | B | ❌(ホストのツールを使用) | オプション | ホストが決定 |
| 無効 + ホストに画像ツールがない | C | ❌ | ✅ 必須 | ❌(不可) |
モードが不明な場合
- 自分がBかCか判断がつかない場合は、ユーザーに「ご自身の環境にある画像ツールで画像を生成しますか、それとも私がプロンプトを作成すればよいですか?」と直接尋ねてください。
- モードAでのスクリプト実行に失敗した場合(401 / ネットワーク / クォータ)→ エラーを通知し、「モードB / Cに切り替えますか?」と確認する
ユーザーがツールを入力
このスキルがユーザーに質問を行う必要がある場合、以下のルールに従ってください:
- 現在の実行環境で提供されているユーザー入力ツールを優先して使用します。
- 対応するツールがない場合は、簡潔なプレーンテキストの番号付き質問で尋ねる。
- 統合可能な質問は、可能な限り一度にすべて尋ねる。
スキルの構造
scripts/check-mode.js:まずこれを実行し、実行モード(A / B / C)を検出しますscripts/generate.js:テキストから画像を生成(Mode Aでのみ使用)scripts/edit.js:元の画像やマスクに基づいて画像を編集(Mode A でのみ使用)scripts/shared.js:共有リクエスト、保存、環境変数の読み取りロジックreferences/:階層構造化されたプロンプトテンプレート(モードA/B/Cのすべてで使用)
環境変数
以下の順序で設定を読み込みます:
- CLI 引数
process.env/.env /.gateway.env ~/.gateway.env
主要な変数:
ENABLE_GARDEN_IMAGEGEN— モード切り替え。1/true/yes/onの場合は Mode A を有効にします。未設定またはその他の値の場合は Mode B / C になります。OPENAI_API_KEY— Mode A では必須;B / C では不要。OPENAI_BASE_URL— デフォルトはhttps://api.openai.com/v1。サードパーティ製の互換ゲートウェイを指定することも可能です。OPENAI_IMAGE_MODEL— デフォルトgpt-image-2、ゲートウェイがサポートするモデル(例:gpt-image-1/dall-e-3)に変更可能。
デフォルトの実装は OpenAI 互換インターフェースに基づいて動作し、特定のサードパーティ製ゲートウェイに固定されていません。
デフォルトの出力ディレクトリ
ユーザーが出力パスを明示的に指定していない場合、現在のワークスペース内の以下のディレクトリが統一して使用されます:
- プロンプトディレクトリ:
garden-gpt-image-2/prompt/(A / B / C の3つのモードすべてで、再利用やバージョン管理の利便性から使用を推奨) - 画像ディレクトリ:
garden-gpt-image-2/image/(Mode A でのみ使用。Mode B はホスト側で決定、Mode C では画像は生成されません)
ディレクトリが存在しない場合、スクリプト(Mode A)は自動的に作成する必要があります。Mode B / C では、プロンプトを記述する前に手動で ` mkdir -p` を実行してください。
デフォルトの命名規則
ユーザーがファイル名を明示的に指定していない場合、スクリプトは現在のタスクに関連するファイル名を自動的に生成し、重複を避けるために現在のタイムスタンプを付加する必要があります。
命名規則:
- プロンプト:
garden-gpt-image-2/prompt/- .md - 画像:
garden-gpt-image-2/image/- .png
このうち:
:現在のユーザーの要求に基づいて、関連する短い名称を自動的に抽出する:現在のタイムスタンプ(例:20260424-153045)
例:
garden-gpt-image-2/prompt/live-commerce-ui-20260424-153045.mdgarden-gpt-image-2/image/live-commerce-ui-20260424-153045.pnggarden-gpt-image-2/prompt/vr-headset-exploded-view-20260424-153102.mdgarden-gpt-image-2/image/vr-headset-exploded-view-20260424-153102.png
プロンプトの保存ルール
| モード | プロンプトの保存が必要か | 説明 |
|---|---|---|
| モード A | ✅ 必須 | 実際の生成/編集プロセスに入る際は必ず保存する必要がある |
| モードB | 推奨 | 再利用しやすいよう、デフォルトでは保存を推奨。ユーザーが「不要」と指定した場合はスキップ |
| モードC | ✅ 必須 | ユーザーがプロンプトを取得して自分で実行します。ディスクに保存しなければ意味がありません |
共通ルール(3つのモードに適用):
- ユーザーがプロンプトファイルのパスを明示的に指定した場合は、そのファイルを入力として直接使用できます。
- ユーザーがテキスト形式のプロンプトを直接指定した場合でも、最終的なプロンプトをまず
garden-gpt-image-2/prompt/に保存する必要があります。 - ユーザーが --prompt-output を明示的に指定した場合は、
ユーザーが指定したパスを優先する。 - それ以外の場合は、デフォルトの命名規則に従って自動的に保存する。
画像の保存ルール(Mode Aのみ)
- ユーザーが
--imageまたは --output を明示的に指定した場合は、ユーザーが指定したパスを優先します。 - それ以外の場合は、デフォルトで
garden-gpt-image-2/image/に保存されます。 - ファイル名は現在のタスクの意味に関連したもので、タイムスタンプが追加される。
Mode B では、ホストの画像ツールによって保存方法が決定されます。Mode C では画像は生成されません。
クイックガイド
0. 実行モードの検出(どのタスクでも最初のステップ)
node skills/gpt-image-2/scripts/check-mode.js
出力結果により、現在が Mode A / B / C のいずれであるかが判明し、それに応じて generate.js / edit.jsを呼び出すかどうかが決まります。以下の 1~4 は Mode A でのみ使用します。
1. テキストから画像を生成(Mode A)
node skills/gpt-image-2/scripts/generate.js \
--prompt "A cute baby sea otter" \
--size 1024x1024 \
--quality high
2. プロンプトファイルを使用した画像生成(Mode A)
node skills/gpt-image-2/scripts/generate.js \
--promptfile garden-gpt-image-2/prompt/poster-20260424-153045.md
3. 既存の画像を編集する(モードA)
node skills/gpt-image-2/scripts/edit.js \
--image assets/source.png \
--prompt "背景をシンプルなスタジオのシーンに置き換えてください"
4. マスクを使用した部分編集(モードA)
node skills/gpt-image-2/scripts/edit.js \
--image assets/source.png \
--mask assets/mask.png \
--prompt "Replace only the masked area with a glass vase"
5. モード B / C の「使い方」
コマンドラインからの呼び出し方法はありません。このスキルは現時点ではプロンプトのエンジニアリングガイドとしてのみ機能します:
- モード B:最終的なプロンプトを生成 → ホストに標準搭載されている
image_generationクラスのツールを呼び出し(パラメータとしてプロンプトを渡す)→ 画像を取得。 - Mode C:最終的なプロンプトを生成 →
garden-gpt-image-2/prompt/に保存 → 内容をユーザーに直接表示 → どの画像ツールで直接再利用できるかをユーザーに提示。- .md
JSONテンプレートの動作
references/ に JSON テンプレートが用意されている場合、以下のルールに従って使用します:
- まず
SKILL.mdから最も近いカテゴリを特定します。 - 次に、具体的なテンプレートファイルを特定します。
- テンプレート内の
{argument ...}は置換可能なパラメータを表します。 - ユーザーが明示的に指定した値は、そのまま入力します。
- ユーザーが指定していないが、テンプレートに「
default」と記載されている場合は、まずデフォルト値を使用しても構いません。 - 情報の欠落が結果に著しい影響を与える場合は、ユーザーに積極的に確認してください。
- ユーザーが「ランダムに生成してください」と明示的に指示した場合は、デフォルト値を保持するか、テンプレートの許容範囲内で合理的にランダム化することができます。
質問のルール
テンプレートに重要な変数が欠けている場合、「どのようなスタイルをご希望ですか?」といった漠然とした質問は避けてください。テンプレートのフィールドに基づいて、正確な質問を行う必要があります。
例えば、ライブ配信UIテンプレートに「主体」が欠けている場合、優先して次のように尋ねるべきです:
- 配信者は誰ですか?
- 実写写真、有名人の名前、人物の説明、それとも完全にランダムに生成しますか?
商品情報が欠けている場合は、次のように尋ねてください:
- 商品名は何ですか?
- 商品の価格は指定されていますか?
- レビューやギフトの内容を自動補完してほしいですか?
テンプレートインデックス
タスクの種類に応じて、最も関連性の高い具体的なテンプレートファイルのみを読み込み、 references/ディレクトリ全体を一括で読み込まないようにしてください。
1. 方法論の総合ドキュメント
最初に読み込む:
references/prompt-writing.md
適用対象:
- JSONテンプレートの構成方法をまだ決めていない場合
- どのフィールドを質問すべきか、どのフィールドをデフォルト値にすべきか、どのフィールドをランダムに設定すべきかを判断する必要がある場合
- 事例を再利用可能なテンプレートに抽象化する必要がある場合
2. UI モックアップ (references/ui-mockups/)
「インターフェース+コンテンツ」の各種モックアップに適しています。現在実装済みのもの:
live-commerce-ui.md— ECライブコマースのスクリーンショットモックアップ(配信者 + チャットエリア + ギフトエリア + 商品カード)social-interface-mockup.md— ソーシャルプラットフォームの投稿詳細ページのモックアップ(Twitter/X、小紅書、Weibo、Threadsなど)product-card-overlay.md— ランディングページのヒーロー画像/詳細ページのメイン画像(人物+商品+セールスポイント+価格)chat-interface-scene.md— チャット/会話画面のモックアップ(iMessage、WeChat、グループチャット、AIアシスタント)short-video-cover-ui.md— ショート動画のカバー/ライブ配信のサムネイル(YouTube、TikTok、Bilibili、VTuberの配信)landing-page-case-study.md— ダークテーマのSaaS/マーケティング事例紹介用 ロングページUIモックアップ (複数セクション+スクロールによるストーリー展開+データカード+CTA)
3. プロダクトビジュアル (references/product-visuals/)
「商品を視覚的な中心とする」画像に適しています。現在実装済みのもの:
exploded-view-poster.md— 製品の分解図ポスター(メイン要素を縦に積み重ね + コールアウト + 上部のロゴ + 下部のブランドエリア)white-background-product.md— EC用純白背景のメイン画像(単品/多角度/ミニマルなマーケティングレイヤー)premium-studio-product.md— 高級スタジオ撮影の商品写真(雑誌広告レベルの雰囲気)packaging-showcase.md— ギフトボックス/パッケージ展示画像(外箱+内容物の展示)lifestyle-product-scene.md— ライフスタイル商品シーン写真(実際のシーンに商品が配置されたもの)ecommerce-marketing-board.md— 中国式EC用複合販売ボード(メイン画像+詳細ページ+セールスポイント+使用手順+シーン+TVCストーリーボードを1枚の画像にまとめたもの)
4. マップ (references/maps/)
「地図系ビジュアル」に適しています(インフォグラフィックは独立したカテゴリ17に抽出済み)。現在実装済みのもの:
food-map.md— 都市グルメの手描きマップ(番号付きスポット+凡例+マスコットキャラクター)travel-route-map.md— 旅行ルートマップ(複数日行程/1日シティウォーク/アウトドアルート)illustrated-city-map.md— 都市の風景を描いたイラストマップ(ランドマーク+自然景観+文化的要素)store-distribution-map.md— ブランド店舗/サービス提供エリア分布図itinerary-day-trip-map.md— 日帰り旅行用分割 ポスター(左:パーチメント風の行程カード+右:ファンタジーと写実を融合した地図、5~7箇所のスポットを厳密に揃える)
5. スライド&ビジュアルドキュメント (references/slides-and-visual-docs/)
「1ページで1つのことを明確に伝える」ビジュアルドキュメントに適しています。現在実装済み:
dense-explainer-slides.md— Irasutoya × 霞関のハイブリッド高密度解説スライドpolicy-style-slide.md— 政策/政府公告/白書スタイルの説明スライドvisual-report-page.md— ビジネスレポートのエグゼクティブサマリー/投資家向けブリーフィング/年次報告書の概要ページeducational-diagram-slide.md— 教育用図解(概念/仕組み/プロセスの分解)
6. ポスター&キャンペーン (references/poster-and-campaigns/)
「ブランドメインビジュアル + キャンペーン + バナー + 雑誌の表紙」に適しています。現在実装済みのもの:
brand-poster.md— ブランドメインポスター(製品/人物/テキストのみのメッセージ)campaign-kv.md— キャンペーン・キービジュアル + 派生レイアウト体系banner-hero.md— Webヒーロー / ランディングページ / アプリバナー(横長構図 + CTA)editorial-cover.md— 雑誌/定期刊行物/出版物の表紙biomimetic-concept-poster.md— バイオミメティック工業デザインコンセプトポスター(自然のプロトタイプ → 進化の過程 → ヒーローレンダリング → 多視点技術図)vintage-editorial-infographic.md— レトロアーカイブ/1940年代風エディトリアル・インフォグラフィックポスター(人物+数式+タイムライン+モデル、ベル研究所風)character-catalog-poster.md— 同一キャラクターの複数バージョンを紹介するインフォグラフィックポスター(星座/元素/王朝/人格シリーズのカード)lineup-comparison-poster.md— 製品ラインナップ比較インフォグラフィックポスター(30以上のSKUを1枚の図にまとめ + 凡例 + ランクキー)
7. ポートレート&キャラクター (references/portraits-and-characters/)
「人物ビジュアル」に適しています。現在実装済み:
professional-portrait.md— プロフェッショナルなビジネスポートレート(LinkedIn / チームページ / メディア用画像)founder-portrait.md— 創業者向けメディア用ポートレート(ドラマチックな照明+タイトル表示スペースあり)virtual-host.md— VTuber/バーチャル配信者のプロフィールカード+配信プレビューcharacter-sheet.md— キャラクター総合設定資料(三面図 + 表情 + 衣装 + カラーパレット)pose-reference-sheet.md— N×N ポーズ/アクション辞書(同一キャラクターの多彩なポーズ:ダンス/戦闘/フィットネス)
8. シーン&イラスト(references/scenes-and-illustrations/)
「雰囲気+ストーリー+感情」を表現するのに適したイラスト系のビジュアル。現在実装済み:
healing-scene.md— 癒やし系日常/季節のシーンイラストconcept-scene.md— 映画のようなコンセプトの大規模シーン/IPキーアートpicture-book-scene.md— 児童書/絵本の中面/季節のカードminimalist-mood-scene.md— ミニマルで余白を活かした雰囲気画 / 文学的な壁紙
9. 編集ワークフロー (references/editing-workflows/)
「既存の画像を基に編集を行う」タイプの画像編集タスクに適しています( scripts/edit.jsに対応)。現在実装済みのもの:
background-replacement.md— 背景置換(商品/人物/屋外/スタジオ風景)local-object-replacement.md— 部分的なオブジェクト置換(マスクの有無を問わず)object-removal.md— 雑物/通行人/電線/欠陥の除去product-retouching.md— 商品レタッチ(光沢/タグ/影/欠陥)portrait-local-edit.md— ポートレートの部分修正(ヘアスタイル/服装/メイク/アクセサリー)
10. アバター&プロフィール (references/avatars-and-profile/)
「スタイリッシュなアバター/キャラクターデザイン/グリッド/ステッカー/ポートレートシリーズ」などの「個人のイメージ」系ビジュアルに適しています。現在実装済みのもの:
style-transfer-selfie.md— 参考画像の人物を、コスプレ/ゴシック/レトロフィルム/アイドル写真など、任意のスタイルに変換character-grid-portrait.md— 同一キャラクターの n×n グリッドポートレート(複数職業/複数表情/複数時代/複数スタイル)themed-3d-icon.md— カワイイ3D/Minecraft/スクラッチ3Dのアプリアイコン風アバターsticker-set.md— ステッカーセット/スタンプコレクション(単体要素+アウトライン+ラベル)cultural-portrait-series.md— 時代 / 神話 / 文学 / 民族をテーマにした肖像画シリーズ
11. ストーリーボードとシーケンス (references/storyboards-and-sequences/)
「マルチカット/漫画/関係図/手順図」などの「物語性のあるシーケンス」系のビジュアルに適しています。現在実装済みのもの:
four-panel-comic.md— 4コマ漫画 / 風刺漫画 / ギャグ漫画(導入・展開・転・結 + セリフ吹き出し)manga-spread-page.md— 1ページ/見開き漫画のストーリーボード(不規則なマス目+セリフ+心の声)anime-key-visual.md— 単画像のアニメキービジュアル/ライトノベルの表紙/IPポスターcharacter-relationship-diagram.md— キャラクター関係図ポスター(カード+関係線+凡例)recipe-process-flowchart.md— レシピ/チュートリアル/手順図(番号+イラスト+説明)product-tvc-storyboard.md— 製品TVCM用ストーリーボード(9コマの実写風 + ショット説明 + 再生時間)cinematic-storyboard-grid.md— 映画的なストーリーテリング用ストーリーボード ・コンタクトシート(3×4/4×4、連続したストーリー+シネマティックな静止画)process-photo-board.md— 実写シネマティック・プロセスボード(装備の着用/メイク/トレーニング/操作の分解、番号+手順の進行)
12. グリッド&コラージュ (references/grids-and-collages/)
「マルチパネルグリッド/コラージュ/プロジェクトボード」系のビジュアルに適しています。現在実装済み:
banner-grid-2x2.md— 2×2 マーケティングバナーセット(統一されたシリーズデザインを4枚まとめて作成)lookbook-grid.md— 7日間のルックブック/9マスセルフケア/TOP Nリスト図mixed-style-multi-panel.md— マルチスタイル・コラージュ(同一テーマを異なる画風で表現)anime-pitch-board.md— アニメ/ゲーム/映像作品の企画ピッチボード(キービジュアル+キャラクター+世界観+コピー)ad-banner-multi-grid.md— 多業種・多テーマ混合広告バナーグリッド(各枠ごとに独立した業種+スタイル+コピー)
13. ブランディング&パッケージング (references/branding-and-packaging/)
「ブランドアイデンティティシステム/マスコット/パッケージデザイン」系のビジュアルに適しています。現在実装済み:
brand-identity-board.md— ブランドアイデンティティボード(ロゴ + 配色 + フォント + アプリケーションモックアップ)mascot-brand-kit.md— マスコットのマルチパネル・ブランドアイデンティティキット(メインビジュアル + 三面図 + 表情 + 応用例)cosmetic-packaging.md— 化粧品/スキンケア製品の単品/シリーズ/ギフトセットのパッケージbeverage-label-design.md— 飲料/食品/調味料のラベルデザイン(中国風/和風/洋風)full-mascot-brand-doc.md— 18以上のモジュールからなる大規模ブランドアイデンティティ+マスコット制作全工程ドキュメント(DNA/ムードボード/スケッチ/線画/3D/配色/マテリアル/応用事例の全体概要図)character-merch-board.md— IPキャラクター+グッズ/パッケージ/ポスター/SNSプロフィールなど、多要素を統合したブランドボード
14. タイポグラフィ&テキストレイアウト (references/typography-and-text-layout/)
「文字優先/バイリンガルレイアウト」など、「文字をメインビジュアルとする」タイプに適しています。現在実装済み:
title-safe-poster.md— 大きな文字を強調したポスター(日本式の高エネルギー/スイス式ミニマル/レトロ印刷)bilingual-layout-visual.md— 中国語・英語/中国語・日本語のバイリンガルレイアウトビジュアル(文化/学術/異文化ブランド)
15. アセット&小道具 (references/assets-and-props/)
「アイコンセット/ゲームスクリーンショット」など、「素材セット/ゲームアセット」系のビジュアルに適しています。現在実装済みのもの:
retro-skeuomorphic-icons.md— スキューモーフィック/Y2K/ピクセル アイコンセット(統一されたスタイルのセット)game-screenshot-mockup.md— ゲーム内スクリーンショットのモックアップ(HUD + 字幕 + クエストパネル)
16. 学術用図表 (references/academic-figures/)
「論文/トップカンファレンスへの投稿/学術ポスター/学位論文発表用PPT/研究計画発表/学術誌投稿用のGraphical Abstract」に適した図版。全体として白背景を基調とし、出版物用のフォント、幾何学的に正確なデザイン、彩度の低いエンジニアリングカラー(濃紺/青みがかったグレー/黒みがかったグレーを主体とし、メインカラーは3色以内)を採用し、単色印刷が可能であること。架空の定量データ(数値/等値線/カラースケールの範囲/数式)の使用は厳禁。
CS / CV / ML分野:
method-pipeline-overview.md— 手法の概要図/パイプライン図(多段階ブロック+データフロー;バリエーション4では、工学系の左/中/右の3段構成の技術ロードマップを提供)neural-network-architecture.md— ニューラルネットワークのアーキテクチャ図(レイヤーブロック+テンソル形状+ジャンプ接続)qualitative-comparison-grid.md— 複数手法の定性的比較表(行=サンプル、列=手法)
工学/自然科学/学位論文発表に共通:
scientific-schematic.md— 概念/原理/実験装置の概略図(自由度が高く、自然言語形式のテンプレート)mechanism-diagram.md— メカニズム図/因果関係/変換経路(中心対象+多段階変換+結果領域;3段階の因果連鎖/循環的自己増幅/多分岐競合の3つのバリエーションを含む)multi-condition-comparison.md— 複数条件/複数状況における結果比較図(同一対象の異なる条件下での並列結果、2×2/1×N/M×N;パネル間の厳密な統一性を重視)publication-chart.md— 出版用データ図表(棒グラフ/折れ線グラフ/散布図/ヒートマップ/箱ひげ図)
概要/要約/口頭発表トップページ:
graphical-abstract.md— 学術誌投稿用グラフィカルアブストラクト/図解要旨(横4段構成/中央展開/正方形/縦型 の4種類のバリエーション)research-overview-poster.md— 研究計画発表/学位論文審査/報告会のトップページ用研究概要図(上・中・下の3層+5つのモジュール;中心から放射状/左右2段組/極簡の3種類のバリエーションを含む)
選択方針:CS/CV/ML論文は
「method-pipeline-overview」+「qualitative-comparison-grid」を優先;工学/エネルギー/化学工学/材料分野は「method-pipeline-overview」バリエーション4+「mechanism-diagram」+「multi-condition-comparison」を優先;投稿ジャーナルの要旨図には「graphical-abstract」を使用;学位論文発表用PPTのトップページには「research-overview-poster」を使用。
17. インフォグラフィック (references/infographics/)
「インフォグラフィック/高密度な科学普及図/手描きインフォグラフィック/KPIダッシュボード」などの「情報可視化用大図」に適しています。現在実装済みのもの:
legend-heavy-infographic.md— 凡例が豊富な科学解説/因果関係/進化/解剖図(バイリンガル)hand-drawn-infographic.md— 手描き風インフォグラフィック(マカロン/モランディ/黒板/クラフト紙;自然言語テンプレート)bento-grid-infographic.md— 弁当箱型グリッドのモジュール式インフォグラフィック(高密度・多モジュールウィジェット配置)comparison-infographic.md— 二項/多項比較インフォグラフィック(A対B/プランの価格帯/誤解対正解)step-by-step-infographic.md— ステップバイステップ解説インフォグラフィック(イラスト調、温かみ;エンジニアリングのフローチャートではない)kpi-dashboard-infographic.md— KPIダッシュボード型インフォグラフィック(年間振り返り/Wrapped/業務ダッシュボード)
18. 技術図解 (references/technical-diagrams/)
「システムアーキテクチャ/プロセス/時系列/ステートマシン/ER/マインドマップ/ネットワークトポロジ」などのエンジニアリング図に適しています。統一されたダークカラーのグリッド背景+等幅フォント+ロールコード配色を採用しており、各テンプレートにはライトバージョンのバリエーションも付属しています。
⚠️ 注意:このディレクトリで生成されるのは PNGビットマップであり、編集可能なSVGではありません。編集が必要な場合は、mermaid / draw.io / excalidraw / Figmaをご利用ください。現在実装済みのもの:
system-architecture.md— システムアーキテクチャ図(フロントエンド + バックエンド + DB + キャッシュ + キュー + 外部)flowchart-decision.md— フローチャート/意思決定図(BPMN形状セマンティクス+Yes/No分岐)sequence-diagram.md— シーケンス図(アクター + ライフライン + メッセージ矢印 + アクティベーションバー)state-machine.md— ステートマシン/ライフサイクル図(state + transition + guard/action)er-diagram.md— ER図 / データモデル図(エンティティ + フィールド + PK/FK + クロウズフット関係)mind-map-tech.md— 技術テーマのマインドマップ(中心 + 放射状の分岐)network-topology.md— ネットワークトポロジ図(デバイス記号 + ゾーン / VPC + 帯域幅 / プロトコルラベル)
プロンプトワークフロー(パターン認識)
A / B / Cのいずれの場合でも、最初の6ステップは共通です。違いは、7~8ステップ目の「図の出力方法」のみです。
-
check-mode.jsを実行してモード(A / B / C)を決定する。 - タスクが図の作成か修正かを判断する。
- それがどの分類ディレクトリに属するかを識別する(下部の「テンプレートインデックス」を参照)。
- 対応する特定のテンプレートファイルのみを読み込み、references/ディレクトリ全体を一度に読み込まないようにします。
- テンプレートの形式を厳守する:大部分のテンプレートはJSONメインテンプレート(構造化タスクに最適)を使用するが、一部のテンプレート(
infographics/hand-drawn-infographic.md、academic-figures/scientific-schematic.mdなど)は、「構造化された自然言語+パラメータ」の混合形式を採用している。これは、JSONを強制すると創作の自由が制限されるためである。 - ユーザー入力をテンプレートのパラメータにマッピングしてください。重要な情報が不足している場合は、的を絞った確認の質問を能動的に投げかけてください。
これでプロンプトの生成は完了です。以下、モードごとに分岐します:
7-A. モード A:最終的なプロンプトを garden-gpt-image-2/prompt/に保存し 、 scripts/generate.js または scripts/edit.js を呼び出し、 画像は garden-gpt-image-2/image/ に保存される。
7-B. モード B:最終的なプロンプトをホストの画像ツールに直接渡して呼び出す;必要に応じて、プロンプトのコピーを garden-gpt-image-2/prompt/に保存する。
7-C. モード C:最終的なプロンプトを garden-gpt-image-2/prompt/に保存し、 、 完全なプロンプト を対話画面でユーザーに表示し、簡単な「使用方法/推奨ツール」のアドバイスを添える。
- タスク終了後、ユーザーに次のことを1文で伝える:現在のモード、プロンプトの保存場所、画像(ある場合)の保存場所。
重要な制約
全般:
- テンプレートファイル内のJSONはプロンプト構造のテンプレートであり、APIリクエストボディのテンプレートではありません。
- 3つのモードのいずれにおいても、最終的に画像モデルに渡されるのは「レンダリング後のプロンプト文字列」です。これは、フラット化されたJSONでも、構造化された自然言語の段落でも構いません。テンプレート通りに使用してください。
- ユーザーから明示的な要求がない限り、SKILL.md内の「モードの説明」を最終的なプロンプトにコピーしないでください。それはエージェント向けのメタ情報です。
モード A のみ適用:
- 生成スクリプトで JSON ボディを使用する場合
- 編集スクリプトではマルチパートフォームデータを使用
- レスポンスは優先的に
data[0].b64_jsonで解析されますが、data[0].urlにも対応しています - 上流のインターフェースで明示的に要求されない限り、特別なクエリパラメータを追加で導入しないでください
質問するタイミング
以下の情報が欠如しており、結果に著しい影響を与える場合にのみ質問してください:
- プロンプトの目的が不明確な場合
- 画像を編集する際、元の画像がない
- 被写体の属性や視覚的タイプが結果の方向性を決定する場合
- 商品/価格/コピー/UIテキストが画面の核心的な構成要素である場合
- ユーザーが互いに矛盾する複数の目標を同時に表明している場合
それ以外の場合は、自ら合理的なデフォルトを設定し、それを継続して実行する。
---
name: gpt-image-2
description: Generates and edits images using GPT Image 2 across three modes: direct generation via OpenAI-compatible API, prompt engineering for host-native image tools, or pure prompt advisory. Includes 80+ structured templates for posters, UI mockups, product visuals, maps, slides, and more.
---
# GPT Image 2
这是一个面向 GPT Image 2 的聚焦型技能,在 3 种运行环境下都能用,但行为差异显著。**第一步必须先确定当前运行模式**。
它只做两类图像任务:
- 生成图片:`POST /images/generations`
- 编辑图片:`POST /images/edits`
本文件保留:运行模式、技能结构、环境变量、保存 / 命名规则、模板索引、模式感知工作流。详细模板全部放在 `references/`,分层组织:
- 一级:分类目录
- 二级:单模板 Markdown 文件
## 运行模式(必读,做任何事之前先确定)
本 Skill 自带一个轻量探测脚本,先跑一次,再根据结果决定怎么干活:
```bash
node skills/gpt-image-2/scripts/check-mode.js
# 想拿结构化结果给上层程序用:
node skills/gpt-image-2/scripts/check-mode.js --json
```
输出会给出 `mode = A` / `A?` / `B-or-C` 以及 `recommendation`。三个模式定义如下:
### Mode A · Garden 本地生图
**触发条件**:环境变量 `ENABLE_GARDEN_IMAGEGEN` 为真(`1` / `true` / `yes` / `on`)**且** 存在 `OPENAI_API_KEY`。
**行为**:完整端到端跑通"选模板 → 写 prompt → 调用脚本 → 出图落盘"。
- 用 `scripts/generate.js` 文本生图、`scripts/edit.js` 编辑现有图。
- prompt 默认落盘到 `garden-gpt-image-2/prompt/`、图片落盘到 `garden-gpt-image-2/image/`。
- 这是最强的模式:你是图像工具的"持有者"。
### Mode B · Host-Native 委托宿主出图
**触发条件**:未启用 Garden(`ENABLE_GARDEN_IMAGEGEN` 未设置 / 为假),但**当前宿主 Agent 自带图像生成工具或图像 MCP**。
**典型识别信号**(你应该自检):
- 你的工具集里出现 `image_generation` / `imagegen` / `dalle` / `nano_banana` / `mcp__*image*` / `make_image` / 类似名字
- 用户在 ChatGPT / Codex / Gemini / Cursor 等支持原生出图的客户端中调用本 Skill
- 用户显式说"用你自己的工具出图"
**行为**:本 Skill **退化成提示词工程指引**——
1. 仍按"选模板 → 填字段 → 渲染最终 prompt"的流程走。
2. **不要调用 `node scripts/generate.js`**(没有 API key、必失败)。
3. 直接调用宿主自带的图像工具,把渲染好的 prompt 作为输入。
4. 如用户希望可顺手把 prompt 文件保存到 `garden-gpt-image-2/prompt/`,但图片去向由宿主决定,不强制。
### Mode C · Advisor 纯提示词顾问
**触发条件**:未启用 Garden,**且**宿主 Agent 也没有任何图像生成工具。
**行为**:本 Skill 退化为"高质量 prompt 撰写顾问"——
1. 按"选模板 → 填字段 → 渲染最终 prompt"流程走,缺信息就问用户。
2. 把最终 prompt **直接打印给用户** + 保存一份到 `garden-gpt-image-2/prompt/<task-slug>-<timestamp>.md`。
3. 附一句简短的"如何使用"建议(如:丢进 ChatGPT / Midjourney / DALL·E / Sora / Nano Banana / 自己后端 / 第三方 GPT Image 2 网关)。
4. **不要假装出图成功**。明确告知用户:"已生成可直接复用的高质量 prompt,请用你的图像工具执行。"
### 模式决策表
| 条件 | 模式 | 调用脚本? | 落盘 prompt? | 落盘图片? |
|---|---|---|---|---|
| `ENABLE_GARDEN_IMAGEGEN=1` + 有 KEY | **A** | ✅ `generate.js` / `edit.js` | ✅ 自动 | ✅ 自动 |
| `ENABLE_GARDEN_IMAGEGEN=1` 但没 KEY | A? | ❌(先要 KEY) | — | — |
| 未启用 + 宿主有图像工具 | **B** | ❌(用宿主工具) | 可选 | 由宿主决定 |
| 未启用 + 宿主无图像工具 | **C** | ❌ | ✅ 必须 | ❌(无法) |
### 模式不确定时
- 如果你判断不清自己是 B 还是 C,**直接问用户一句**:"是用你环境里的图像工具出图,还是只要我写好提示词?"
- Mode A 调脚本失败(401 / 网络 / 配额)→ 报错并询问"切到 B / C 吗?"
## 用户输入工具
当此技能需要向用户提问时,遵循以下规则:
1. 优先使用当前运行时提供的用户输入工具。
2. 如果没有对应工具,则用简短的纯文本编号问题提问。
3. 能合并的问题尽量一次问完。
## 技能结构
- `scripts/check-mode.js`:**先跑这个**,检测运行模式(A / B / C)
- `scripts/generate.js`:文本生图(仅 Mode A 使用)
- `scripts/edit.js`:基于原图 / 遮罩改图(仅 Mode A 使用)
- `scripts/shared.js`:共享请求、保存、环境变量读取逻辑
- `references/`:分层结构化提示词模板(A / B / C 三模式都用)
## 环境变量
按以下顺序读取配置:
1. CLI 参数
2. `process.env`
3. `<cwd>/.env`
4. `<cwd>/.gateway.env`
5. `~/.gateway.env`
核心变量:
- `ENABLE_GARDEN_IMAGEGEN` — **模式开关**。`1` / `true` / `yes` / `on` 时启用 Mode A;未设置或其它值则进入 Mode B / C。
- `OPENAI_API_KEY` — Mode A 必需;B / C 不需要。
- `OPENAI_BASE_URL` — 默认 `https://api.openai.com/v1`,可指向第三方兼容网关。
- `OPENAI_IMAGE_MODEL` — 默认 `gpt-image-2`,可换成网关支持的型号(如 `gpt-image-1` / `dall-e-3`)。
默认实现按 OpenAI 兼容接口工作,不写死任何第三方网关。
## 默认输出目录
如果用户没有明确指定输出路径,统一使用当前工作区下的:
- 提示词目录:`garden-gpt-image-2/prompt/`(**A / B / C 三种模式都建议用**,方便复用与版本管理)
- 图片目录:`garden-gpt-image-2/image/`(**仅 Mode A 使用**;Mode B 由宿主决定,Mode C 不产生图)
如果目录不存在,脚本(Mode A)必须自动创建;Mode B / C 在写 prompt 前手动 `mkdir -p`。
## 默认命名规则
如果用户没有明确指定文件名,脚本应自动生成与当前任务相关的文件名,并追加当前时间戳,避免重名。
命名规则:
- 提示词:`garden-gpt-image-2/prompt/<task-slug>-<timestamp>.md`
- 图片:`garden-gpt-image-2/image/<task-slug>-<timestamp>.png`
其中:
- `<task-slug>`:根据当前用户要求自动提取一个相关短名称
- `<timestamp>`:当前时间戳,例如 `20260424-153045`
示例:
- `garden-gpt-image-2/prompt/live-commerce-ui-20260424-153045.md`
- `garden-gpt-image-2/image/live-commerce-ui-20260424-153045.png`
- `garden-gpt-image-2/prompt/vr-headset-exploded-view-20260424-153102.md`
- `garden-gpt-image-2/image/vr-headset-exploded-view-20260424-153102.png`
## Prompt 保存规则
| 模式 | 是否必须保存 prompt | 说明 |
|---|---|---|
| Mode A | ✅ 必须 | 进入实际生成 / 编辑流程必落盘 |
| Mode B | 推荐 | 默认建议保存方便复用;用户说"不用"就略过 |
| Mode C | ✅ 必须 | 用户拿走 prompt 自己执行,不落盘等于白干 |
通用规则(适用三种模式):
1. 如果用户显式给了 prompt 文件路径,可直接使用该文件作为输入。
2. 如果用户直接给的是文本 prompt,也要先把最终 prompt 保存到 `garden-gpt-image-2/prompt/`。
3. 如果用户显式指定了 `--prompt-output`,则尊重用户指定路径。
4. 否则使用默认命名规则自动保存。
## 图片保存规则(仅 Mode A)
1. 如果用户显式指定了 `--image` 或 `--output`,则尊重用户指定路径。
2. 否则默认保存到 `garden-gpt-image-2/image/`。
3. 文件名应和当前任务语义相关,并附加时间戳。
Mode B 由宿主图像工具决定保存方式;Mode C 不产生图片。
## 快速用法
### 0. 检测运行模式(**任何任务的第一步**)
```bash
node skills/gpt-image-2/scripts/check-mode.js
```
输出会告诉你当前是 Mode A / B / C,决定后续是否调用 `generate.js` / `edit.js`。下面 1~4 仅在 **Mode A** 下使用。
### 1. 文本生图(Mode A)
```bash
node skills/gpt-image-2/scripts/generate.js \
--prompt "A cute baby sea otter" \
--size 1024x1024 \
--quality high
```
### 2. 用提示词文件生图(Mode A)
```bash
node skills/gpt-image-2/scripts/generate.js \
--promptfile garden-gpt-image-2/prompt/poster-20260424-153045.md
```
### 3. 编辑已有图片(Mode A)
```bash
node skills/gpt-image-2/scripts/edit.js \
--image assets/source.png \
--prompt "Replace the background with a clean studio scene"
```
### 4. 带遮罩的局部编辑(Mode A)
```bash
node skills/gpt-image-2/scripts/edit.js \
--image assets/source.png \
--mask assets/mask.png \
--prompt "Replace only the masked area with a glass vase"
```
### 5. Mode B / C 的"用法"
没有命令行入口——本 Skill 此时只是**提示词工程指南**:
- **Mode B**:渲染好最终 prompt → 调用宿主自带的 `image_generation` 类工具(参数中传入 prompt)→ 拿到图。
- **Mode C**:渲染好最终 prompt → 保存到 `garden-gpt-image-2/prompt/<task-slug>-<timestamp>.md` → 把内容直接展示给用户 → 提示用户在哪些图像工具中可以直接复用。
## JSON 模板工作方式
当 `references/` 中提供 JSON 模板时,按下面规则使用:
1. 先从 `SKILL.md` 找到最贴近的分类目录。
2. 再定位到具体模板文件。
3. 模板中的 `{argument ...}` 表示可替换参数。
4. 用户明确提供的值,直接填入。
5. 用户没有提供,但模板标了 `default` 的,默认可以先用默认值。
6. 如果缺失信息会显著影响结果,主动询问用户。
7. 用户也可以明确说“你随机生成”,这时可以保留默认值或在模板允许范围内合理随机化。
## 询问规则
当模板缺少关键变量时,不要笼统地问“你想要什么风格?”。应当根据模板字段精确提问。
例如直播 UI 模板缺少主体时,应优先问:
- 主播是谁?
- 用真人照片、名人名字、人物描述,还是完全随机生成?
缺少商品信息时应问:
- 商品名称是什么?
- 商品价格是否指定?
- 是否希望我自动补全评论和礼物内容?
## 模板索引
按任务类型只读取最贴近的具体模板文件,不要一次性全读整个 `references/`。
### 1. 方法论总文档
先读:
- `references/prompt-writing.md`
适用于:
- 你还没决定怎么构造 JSON 模板
- 你需要判断哪些字段该问、哪些字段可默认、哪些字段可随机
- 你需要把案例抽象成可复用模板
### 2. UI Mockups (`references/ui-mockups/`)
适合各种“界面 + 内容”的样机视觉。当前已落地:
- `live-commerce-ui.md` — 电商直播带货截图样机(主播 + 聊天区 + 礼物区 + 商品卡)
- `social-interface-mockup.md` — 社交平台动态详情页样机(Twitter/X、小红书、微博、Threads 等)
- `product-card-overlay.md` — 落地页 hero / 详情页主图(人物 + 商品 + 卖点 + 价格)
- `chat-interface-scene.md` — 聊天 / 对话界面样机(iMessage、微信、群聊、AI 助手)
- `short-video-cover-ui.md` — 短视频封面 / 直播缩略图(YouTube、抖音、B 站、VTuber stream)
- `landing-page-case-study.md` — 深色 SaaS / 营销 case study **长页面** UI mockup(多 section + 滚动叙事 + 数据卡 + CTA)
### 3. Product Visuals (`references/product-visuals/`)
适合“以商品为视觉中心”的图。当前已落地:
- `exploded-view-poster.md` — 产品爆炸视图海报(主体垂直堆叠 + callout + 顶部 logo + 底部品牌区)
- `white-background-product.md` — 电商纯白底主图(单品 / 多角度 / 极简营销叠层)
- `premium-studio-product.md` — 高级影棚商业产品图(杂志广告级氛围)
- `packaging-showcase.md` — 礼盒 / 包装展示图(外盒 + 内容物展示)
- `lifestyle-product-scene.md` — 生活方式产品场景图(商品出现在真实场景中)
- `ecommerce-marketing-board.md` — 中式电商超复合销售看板(主图 + 详情页 + 卖点 + 使用步骤 + 场景 + TVC 分镜组合一图)
### 4. Maps (`references/maps/`)
适合“地图类视觉”(信息图已抽离到独立分类 17)。当前已落地:
- `food-map.md` — 城市美食手绘地图(编号点位 + 图例 + 中心吉祥物)
- `travel-route-map.md` — 旅行路线图(多日行程 / 单日 city walk / 户外路线)
- `illustrated-city-map.md` — 城市风貌插画地图(地标 + 江山 + 文化元素)
- `store-distribution-map.md` — 品牌门店 / 服务覆盖分布图
- `itinerary-day-trip-map.md` — **一日游** split 海报(左 parchment 行程卡 + 右奇幻写实地图,5-7 站点严格对齐)
### 5. Slides & Visual Docs (`references/slides-and-visual-docs/`)
适合“一页讲清楚一件事”的视觉文档。当前已落地:
- `dense-explainer-slides.md` — Irasutoya × 霞关混合高密度讲解 Slide
- `policy-style-slide.md` — 政策 / 政府公告 / 白皮书风格说明 Slide
- `visual-report-page.md` — 商业报告执行摘要 / 投资人简报 / 年报概览页
- `educational-diagram-slide.md` — 教学示意图(概念 / 机制 / 流程分解)
### 6. Poster & Campaigns (`references/poster-and-campaigns/`)
适合“品牌主视觉 + campaign + banner + 杂志封面”。当前已落地:
- `brand-poster.md` — 品牌主海报(产品 / 人物 / 纯文字主张)
- `campaign-kv.md` — Campaign Key Visual + 衍生 layout 系统
- `banner-hero.md` — Web hero / 落地页 / app banner(横向构图 + CTA)
- `editorial-cover.md` — 杂志 / 期刊 / 出版物封面
- `biomimetic-concept-poster.md` — 仿生工业设计概念海报(自然原型 → 演化条 → hero render → 多视图技术图)
- `vintage-editorial-infographic.md` — 复古档案 / 1940s 编辑式信息图海报(人物 + 公式 + 时间轴 + 模型,Bell Labs 风)
- `character-catalog-poster.md` — 同一角色多版本信息图海报(星座 / 元素 / 朝代 / 人格系列卡片)
- `lineup-comparison-poster.md` — 系列产品 lineup 对比信息图海报(30+ SKU 同图 + 图例 + 等级 key)
### 7. Portraits & Characters (`references/portraits-and-characters/`)
适合“人物视觉”。当前已落地:
- `professional-portrait.md` — 职业级商务肖像(LinkedIn / 团队页 / 媒体配图)
- `founder-portrait.md` — 创始人媒体大片肖像(戏剧灯光 + 留标题位)
- `virtual-host.md` — VTuber / 虚拟主播个人卡 + 直播预览
- `character-sheet.md` — 角色综合设定稿(三视图 + 表情 + 服装 + 配色板)
- `pose-reference-sheet.md` — N×N 姿势 / 动作字典参考表(同一角色多姿势,舞蹈 / 战斗 / 健身)
### 8. Scenes & Illustrations (`references/scenes-and-illustrations/`)
适合 “氛围 + 故事 + 情绪” 的插画类视觉。当前已落地:
- `healing-scene.md` — 治愈系日常 / 季节场景插画
- `concept-scene.md` — 电影感概念大场景 / IP key art
- `picture-book-scene.md` — 童书 / 绘本内页 / 节日卡片
- `minimalist-mood-scene.md` — 极简留白氛围图 / 文学性壁纸
### 9. Editing Workflows (`references/editing-workflows/`)
适合“基于现有图片做编辑”的图改任务(对应 `scripts/edit.js`)。当前已落地:
- `background-replacement.md` — 背景替换(商品 / 人像 / 户外 / 棚景)
- `local-object-replacement.md` — 局部对象替换(配合或不配合蒙版)
- `object-removal.md` — 杂物 / 路人 / 电线 / 瑕疵去除
- `product-retouching.md` — 产品精修(光泽 / 标签 / 阴影 / 瑕疵)
- `portrait-local-edit.md` — 人像局部修改(发型 / 服装 / 妆容 / 配饰)
### 10. Avatars & Profile (`references/avatars-and-profile/`)
适合“风格化头像 / 人设 / 网格 / 贴纸 / 系列肖像”等"个人形象"类视觉。当前已落地:
- `style-transfer-selfie.md` — 把参考图人物转成 cosplay / 哥特 / 复古胶片 / 偶像写真等任意风格
- `character-grid-portrait.md` — 同一角色 n×n 网格肖像(多职业 / 多表情 / 多朝代 / 多风格)
- `themed-3d-icon.md` — Kawaii 3D / Minecraft / 拟物 3D 应用图标式头像
- `sticker-set.md` — 贴纸套装 / 表情包合集(独立元素 + 描边 + 标签)
- `cultural-portrait-series.md` — 朝代 / 神话 / 文学 / 民族系列肖像
### 11. Storyboards & Sequences (`references/storyboards-and-sequences/`)
适合“多分镜 / 漫画 / 关系图 / 流程步骤”等"叙事性序列"类视觉。当前已落地:
- `four-panel-comic.md` — 4 格漫画 / 讽刺漫画 / 段子漫画(起承转合 + 对话气泡)
- `manga-spread-page.md` — 单页 / 跨页漫画分镜(不规则格子 + 对话 + 心声)
- `anime-key-visual.md` — 单图动漫 KV / 轻小说封面 / IP 海报
- `character-relationship-diagram.md` — 角色关系图海报(卡片 + 关系连线 + 图例)
- `recipe-process-flowchart.md` — 食谱 / 教程 / 流程步骤图(编号 + 插图 + 说明)
- `product-tvc-storyboard.md` — 产品 TVC 商业广告分镜板(9-panel 实拍质感 + 镜头描述 + 时长)
- `cinematic-storyboard-grid.md` — **电影感叙事分镜** contact sheet(3×4 / 4×4,连续叙事 + cinematic still)
- `process-photo-board.md` — 真人 cinematic 流程板(装备穿戴 / 化妆 / 训练 / 操作分解,编号 + 步骤递进)
### 12. Grids & Collages (`references/grids-and-collages/`)
适合“多面板网格 / 拼贴 / 立项 board”类视觉。当前已落地:
- `banner-grid-2x2.md` — 2×2 营销 banner 套装(一次出 4 张统一系列设计)
- `lookbook-grid.md` — 7 日 lookbook / 9 宫 self-care / TOP N 清单图
- `mixed-style-multi-panel.md` — 多风格混合拼贴(同一主体不同画风演绎)
- `anime-pitch-board.md` — 动漫 / 游戏 / 影视立项 pitch board(KV + 角色 + 世界观 + 文案)
- `ad-banner-multi-grid.md` — 多行业 / 多主题混合广告 banner 网格(每格独立行业 + 风格 + 文案)
### 13. Branding & Packaging (`references/branding-and-packaging/`)
适合“品牌识别系统 / 吉祥物 / 包装设计”类视觉。当前已落地:
- `brand-identity-board.md` — 品牌识别系统板(logo + 配色 + 字体 + 应用 mockup)
- `mascot-brand-kit.md` — 吉祥物多面板品牌识别套装(主形象 + 三视图 + 表情 + 应用)
- `cosmetic-packaging.md` — 化妆品 / 护肤品 单瓶 / 系列 / 礼盒包装
- `beverage-label-design.md` — 饮料 / 食品 / 调味品标签设计(国潮 / 日式 / 西式)
- `full-mascot-brand-doc.md` — **18+ 模块大型品牌识别 + 吉祥物全流程文档**(DNA / moodboard / 草图 / 线稿 / 3D / 配色 / 材质 / 应用一图概览)
- `character-merch-board.md` — IP 角色 + 周边 / 包装 / 海报 / 社交 profile 多元素综合品牌板
### 14. Typography & Text Layout (`references/typography-and-text-layout/`)
适合“字面优先 / 双语版式”等"以文字为主视觉"的类型。当前已落地:
- `title-safe-poster.md` — 大字主张型海报(日式高能量 / 瑞士极简 / 复古印刷)
- `bilingual-layout-visual.md` — 中英 / 中日双语版式视觉(文化 / 学术 / 跨文化品牌)
### 15. Assets & Props (`references/assets-and-props/`)
适合“图标集 / 游戏截图”等"成套素材 / 游戏资产"类视觉。当前已落地:
- `retro-skeuomorphic-icons.md` — 拟物 / Y2K / 像素 图标集(成套统一风格)
- `game-screenshot-mockup.md` — 游戏内截图 mockup(HUD + 字幕 + 任务面板)
### 16. Academic Figures (`references/academic-figures/`)
适合“论文 / 顶会投稿 / 学术海报 / 答辩 PPT / 开题答辩 / 期刊投稿 Graphical Abstract”的配图。整体偏白底 + 出版物字体 + 几何精确 + 低饱和工程色(深蓝 / 灰蓝 / 黑灰为主,≤3 主色)+ 可单色印刷。**严格禁止虚构定量数据**(数值 / 等值线 / 色标范围 / 公式)。
CS / CV / ML 方向:
- `method-pipeline-overview.md` — 方法总览图 / pipeline figure(多 stage 块 + 数据流;变体 4 提供工程类左/中/右 三段式技术路线图)
- `neural-network-architecture.md` — 神经网络架构图(layer 块 + tensor shape + 跳连)
- `qualitative-comparison-grid.md` — 多方法 qualitative 对比网格(**行 = 样本,列 = 方法**)
工程 / 自然科学 / 答辩通用:
- `scientific-schematic.md` — 概念 / 原理 / 实验装置示意图(自由度高,自然语言模板)
- `mechanism-diagram.md` — 机理示意图 / 因果链路 / 转化路径(中心对象 + 多阶段转化 + 结果区;含三段式因果链 / 循环自激发 / 多分支竞争 三种变体)
- `multi-condition-comparison.md` — **多工况 / 多条件结果对比图**(同一对象在不同 condition 下的并列结果,2×2 / 1×N / M×N;强调 panel 间严格统一)
- `publication-chart.md` — publication-ready 数据图表(bar / line / scatter / heatmap / box)
总览 / 摘要 / 答辩首页:
- `graphical-abstract.md` — 期刊投稿 Graphical Abstract / 图形摘要(横向 4 段式 / 中心展开 / 方形 / 竖版四种变体)
- `research-overview-poster.md` — 开题 / 答辩 / 汇报首页研究总览图(上中下三层 + 五模块;含中心辐射 / 左右双栏 / 极简 三种变体)
> 选择策略:CS/CV/ML 论文首选 `method-pipeline-overview` + `qualitative-comparison-grid`;工程 / 能源 / 化工 / 材料方向首选 `method-pipeline-overview` 变体 4 + `mechanism-diagram` + `multi-condition-comparison`;投稿期刊摘要图用 `graphical-abstract`;答辩 PPT 首页用 `research-overview-poster`。
### 17. Infographics (`references/infographics/`)
适合“信息图 / 高密度科普 / 手绘信息图 / KPI 仪表盘”等"信息可视化大图"。当前已落地:
- `legend-heavy-infographic.md` — 高图例密度科普 / 因果链 / 演化 / 解剖图(双语)
- `hand-drawn-infographic.md` — **手绘风**信息图(macaron / morandi / 黑板 / 牛皮纸;自然语言模板)
- `bento-grid-infographic.md` — 便当格模块化信息图(高密度多模块 widget 排布)
- `comparison-infographic.md` — 二元 / 多元对比信息图(A vs B / 套餐档位 / 误区 vs 正解)
- `step-by-step-infographic.md` — 步骤教程信息图(插画感、温暖;非工程流程图)
- `kpi-dashboard-infographic.md` — KPI 仪表盘式信息图(年度回顾 / Wrapped / 业务 dashboard)
### 18. Technical Diagrams (`references/technical-diagrams/`)
适合“系统架构 / 流程 / 时序 / 状态机 / ER / 思维导图 / 网络拓扑”等工程示意图。统一暗色 grid 背景 + 等宽字体 + 角色编码配色,每个模板都附 light 变体。
⚠️ 注意:本目录生成的是 **PNG 位图**,**不是可编辑 SVG**;需要可编辑请改用 mermaid / draw.io / excalidraw / Figma。当前已落地:
- `system-architecture.md` — 系统架构图(前端 + 后端 + DB + 缓存 + 队列 + 外部)
- `flowchart-decision.md` — 流程图 / 决策图(BPMN 形状语义 + Yes/No 分支)
- `sequence-diagram.md` — 时序图(actor + lifeline + 消息箭头 + 激活条)
- `state-machine.md` — 状态机 / 生命周期图(state + transition + guard / action)
- `er-diagram.md` — ER 图 / 数据模型图(实体 + 字段 + PK/FK + crow's foot 关系)
- `mind-map-tech.md` — 技术主题思维导图(中央 + 放射式分支)
- `network-topology.md` — 网络拓扑图(设备 glyph + zone / VPC + 带宽 / 协议标)
## 提示词工作流(模式感知)
无论 A / B / C,**前 6 步是共用的**;区别只在第 7-8 步如何"出图"。
1. **跑 `check-mode.js` 确定模式**(A / B / C)。
2. 判断任务是生图还是改图。
3. 识别它属于哪个分类目录(参考下方"模板索引")。
4. 只读取对应的具体模板文件,**不要一次读整个 references/**。
5. 严格遵循模板格式:大部分模板用 JSON 主模板(结构化任务首选),少数模板(`infographics/hand-drawn-infographic.md`、`academic-figures/scientific-schematic.md` 等)使用「结构化自然语言 + 参数」混合形式,因为强行 JSON 会限制创作自由。
6. 把用户输入映射到模板参数;关键信息不足时主动发起有针对性的澄清问题。
到此 prompt 已渲染好。下面按模式分叉:
7-A. **Mode A**:把最终 prompt 保存到 `garden-gpt-image-2/prompt/`,调用 `scripts/generate.js` 或 `scripts/edit.js`,图片落到 `garden-gpt-image-2/image/`。
7-B. **Mode B**:把最终 prompt 直接传给宿主的图像工具调用;按需保存 prompt 副本到 `garden-gpt-image-2/prompt/`。
7-C. **Mode C**:把最终 prompt 保存到 `garden-gpt-image-2/prompt/<task-slug>-<timestamp>.md`,并把完整 prompt 在对话中展示给用户,附一句简短的"如何使用 / 推荐工具"建议。
8. 任务结束后用一句话告诉用户:当前模式是什么、prompt 落在哪、图(如有)落在哪。
## 重要约束
通用:
- 模板文件中的 JSON 是**提示词结构模板**,不是 API 请求体模板。
- 三种模式下,最终交给图像模型的都是"渲染后的 prompt 字符串"——可以是拍平的 JSON、可以是结构化自然语言段落,按模板原样使用。
- 除非用户明确要求,否则**不要把 SKILL.md 里的"模式说明"复制到最终 prompt 里**——那是给 Agent 看的元信息。
仅 Mode A 适用:
- 生成脚本使用 JSON body
- 编辑脚本使用 multipart form data
- 响应优先按 `data[0].b64_json` 解析,也兼容 `data[0].url`
- 除非上游接口明确要求,不额外引入特殊 query 参数
## 何时提问
只在这些信息缺失且会显著影响结果时提问:
- 没有 prompt 目标
- 改图时没有原图
- 主体身份或视觉类型决定结果走向
- 商品 / 价格 / 文案 / UI 文本是画面核心组成部分
- 用户同时表达了多个互相冲突的目标
除此之外,优先自己做合理默认并继续执行。
すべてのファイル
103件のファイルgpt-image-2をインストール
スキルファイルをダウンロードし、.claude/skills/ ディレクトリに解凍してください。
ZIPをダウンロードリポジトリをクローンし、スキルファイルをプロジェクトにコピーしてください。
git clone https://github.com/ConardLi/garden-skills/tree/main/skills/gpt-image-2 # Copy SKILL.md to your .claude/skills/ directory
コピー





家
