image-generation

画像生成

曖昧な画像リクエストを、有能な画像モデル——具体的には、このリポジトリの自動化が使用する唯一のモデルである FAL.ai 上の fal-ai/nano-banana-pro——が、ユーザーが実際に思い描いたとおりにレンダリングできるほど精密なプロンプト仕様に変換します。プロンプト仕様が成果物であり、生成されたファイルは自動化が設定されている場合のボーナスです。最重要ルール：曖昧なプロンプトから絶対に生成しないこと。 弱いプロンプトは生成クレジットを消費するだけで何も学べませんが、鋭い仕様は永遠に再利用できます。

使用すべき場合 / 使用すべきでない場合

汎用画像に使用します：ヒーロー画像、イラスト、サムネイル、インフォグラフィック、テクスチャ、コンセプトアート、あらゆる単発のビジュアル。リクエストが実質的に次のものである場合は、代わりに引き継ぎます：

• コマース/マーケティング向けの商品写真 → skills/creative/product-photography
• プラットフォームサイズのソーシャルコンテンツ → skills/creative/social-graphics
• ロゴ、アイコン、パターン、ブランドマーク → skills/creative/brand-asset
• ビジュアルの方向性がまだ存在せず、一貫性が重要な場合 → 先に skills/creative/creative-strategist を実行し、そのスタイルブロックを使用する
• 複数アセットのキャンペーン全体 → skills/creative/orchestrator がルーティングする

ヒアリング

不足している項目だけを、1回にまとめて質問します：

1. 被写体 — 画像に正確に何が入っているか？（オブジェクト、シーン、人物、テキスト？）
2. 用途 — どこに配置されるか？（これでアスペクト比と解像度が決まる）
3. スタイルの基準 — 既存のスタイルガイド / creative-strategist のスタイルブロック、 参考画像、またはムードを表す3つの形容詞？
4. 自動化 — 生成できるように FAL_API_KEY が設定されているか、それとも仕様のみを納品するか？

推論し、質問はしない：アスペクト比は述べられた配置先から（サムネイル → 16:9、 ストーリー → 9:16、フィード → 1:1 または 4:5）；解像度は重要度から（デフォルトは 2K、 ヒーロー/印刷は 4K、ドラフトは 1K）。立ち止まらないこと： 被写体と用途が明確であれば、 残りについては仮定を述べて進めます。

ワークフロー

1. スタイルブロックを確認する。 ユーザーが skills/creative/creative-strategist を実行済みなら、そのスタイルブロックをすべての プロンプトでそのまま再利用します。実行しておらず、これが単発であれば、コンテキストから 最小限のもの（スタイル + パレット + ムード）を導出し、仮定として明示します。

2. 5部構成の公式でプロンプトを起草する。 すべてのプロンプトには、順番に次が含まれます： 被写体（主要なもの、具体的に：「金のアクセントがついた高級レザーウォッチ」、 決して「腕時計」ではない）→ 説明的詳細（素材、色、レンダリングするテキスト） → スタイル（「プロフェッショナルな商品写真」、「フラットでモダンな イラスト」、「フォトリアル」）→ 技術的処理（ライティング、 構図、フォーカス、「4K、高精細」）→ ムード（「暖かく魅力的」）。 ネガティブ制約は単純な禁止事項として追加します（「テキストオーバーレイなし」、「 ウォーターマークなし」、「煩雑な背景なし」）。

3. バリエーション戦略を決める。 使い捨てのドラフトなら → 1K で1枚。残す アセットなら → 真に異なる3〜4個のプロンプト仕様を提案し（同義語の差し替えではなく、 異なる構図やスタイルの切り口）、それぞれ1枚ずつ生成するか、勝者を num_images 3〜4枚 生成し、ユーザーに選んでもらいます。ヒーローアセットで1つの選択肢だけを提示しては いけません。

4. 生成または納品。 FAL_API_KEY（または FAL_KEY）が設定されている場合：

   python docs/creative_cli.py custom \
     --category "<category>" --name "<asset-name>" \
     --prompt "<full prompt>" \
     --aspect-ratio 16:9 --resolution 2K --num-images 3
   

   画像が現在の実世界のデータを反映する必要がある場合（例：「2026年のトレンドインフォグラフィック」）にのみ --web-search を使用します。キーが設定されていない場合は、プロンプト仕様の ブロックと、ユーザーが後で実行できる正確なコマンドを納品します——結果を偽ったり、 画像が生成されたと主張したりしないでください。

5. レビューして反復する。 出力を仕様のムード/スタイル/ネガティブ 制約と比較します。外れはプロンプトを編集して修正します（より具体的な被写体、明示的な ライティング、より強い禁止事項）——他にモデルの調整項目はありません。ユーザーに 確認する前に、反復は最大1ラウンドまでとします。

生成コマンドを書く前に references/automation.md を読んでください——そこに 完全で検証済みのパラメータセット、CLI フラグ、Python ヘルパー、出力レイアウトがあります。

必要な出力形式

アセットごとに 1 つのブロックを出力してください（生成の有無にかかわらず、この正確な構造で）：

## Prompt Spec — [asset name]
- **Use / destination:** [where it will live]
- **Subject:** [the main thing, concretely]
- **Style:** [artistic treatment]
- **Composition:** [framing — centered / rule of thirds / negative space / overhead]
- **Lighting:** [studio / natural golden hour / dramatic rim / high-key]
- **Mood:** [2–3 adjectives]
- **Aspect ratio:** [one of 21:9 16:9 3:2 4:3 5:4 1:1 4:5 3:4 2:3 9:16] · **Resolution:** [1K/2K/4K] · **Format:** [png/jpeg/webp]
- **Negative constraints:** [what must NOT appear]
- **Prompt (final, paste-ready):**
  > [single flowing prompt assembled from the fields above]
- **Variants:** [n] — [what varies between them]
- **File naming:** assets/<category>/<asset-name>/<asset_name>_<n>_<timestamp>.png (automation default)
- **Generate with:** `python docs/creative_cli.py custom --category ... --name ... --prompt "..." --aspect-ratio ... --resolution ... --num-images n`

画像を生成した場合は、保存したパスを 結果 の下に追記し、どのバリアントを推奨するか、その理由を（1 行で）記載してください。

品質基準

納品前に、すべての仕様を確認してください：

• 被写体は、二人の他人が同じ画像を思い描けるほど具体的である
• スタイル、ライティング、構図、ムードがそれぞれ明示されている — モデルのデフォルトに任せていない
• アスペクト比が指定された出力先と一致している（「デフォルトだから」という理由で 1:1 にしていない）
• ネガティブ制約が列挙されている（最低限：ウォーターマークなし、テキストポリシーを明示する — モデルは長いテキストを崩します）
• 存在しないパラメータをでっち上げていない — references/automation.md にあるものだけを使用している。モデルは常に fal-ai/nano-banana-pro
• キープするアセットには 3 つ以上の異なるバリアントがあり、1 回のテイクで済ませていない
• 自動化を実行しなかった場合は、その旨を成果物に記載し、実行可能なコマンドを含めている

厳守すべき禁止事項：生成していない画像を生成したと主張しないこと。ブランドカラーの 16 進コードを引用符で囲んで済ませようとしないこと — 色は言葉でも名付けること（「ディープネイビー #004E89」）。画像内に段落単位のテキストをレンダリングしないこと。

連携

• skills/creative/creative-strategist → このスキルに スタイルブロック を供給します（すべてのプロンプトのスタイル／ムード／ライティングのフィールドに貼り付けてください）。
• skills/creative/product-photography、skills/creative/social-graphics、skills/creative/brand-asset → 独自のプロンプト仕様を生成し、同じ自動化を使用する専門のフロントエンドです。リクエストが適合する場合はそちらにルーティングしてください。
• skills/creative/product-video と skills/creative/remotion-script-writer → 生成されたスチルをソースフレーム／アセットとして消費します。
• references/automation.md — FAL.ai クライアント、CLI、Python ヘルパーの完全なリファレンスです。生成コマンドを実行する前に必ず読んでください。