ads-generate

広告生成：AI 広告画像ジェネレーター

キャンペーン概要とブランドプロフィールをもとに、各プラットフォーム向けのサイズに合わせた広告クリエイティブ画像を生成します。画像生成プロバイダーとして banana-claude を使用します。

クイックリファレンス

コマンド	機能
/ads generate	campaign-brief.md からすべての画像を生成します
/ads generate --platform meta	Meta 用アセットのみを生成します
/ads generate --prompt "text" --ratio 9:16	brief を使わずに単独で生成します

環境設定

実行前に必須：

• nanobanana-mcp が設定された banana-claude（v1.4.1 以降）が必要です
• /banana setup を実行して、API キーと MCP を設定してください
• フォールバック：banana を利用できない場合は、scripts/generate_image.py を使用します（非推奨）

banana-claude がインストールされていない場合、このスキルはセットアップ手順を表示して終了します。エラーを通知せずに失敗することはありません。

banana-claude が利用できない場合の代替手段には、OpenAI gpt-image-1（$0.040/画像）、Stability SD 3.5（$0.065）、Replicate FLUX.1 Pro（$0.055）があります。ADS_IMAGE_PROVIDER 環境変数で設定してください。

処理手順

ステップ 1：banana-claude を確認する

banana-claude がインストールされていることを確認します（確認するには /banana setup を実行します）。インストールされていない場合は、セットアップ手順を表示して終了します。

ステップ 2：ソースファイルを探す

次のファイルを確認します：

• campaign-brief.md → プロンプトと寸法の主要なソース
• brand-profile.json → ブランドの色・スタイルの適用（任意ですが推奨）

campaign-brief.md が見つかった場合：## Image Generation Briefs セクションを生成ジョブのリストとして使用します。

campaign-brief.md がない場合：単独モードに入ります（ステップ 2b）。

ステップ 2b：単独モード

ユーザーに次の項目を尋ねます：

1. 生成プロンプト（画像に何を表示するか）
2. 対象プラットフォーム（適切な寸法を設定するため）
3. 出力ファイル名（任意）

その後、ステップ 5 に進みます。

ステップ 3：プロバイダー設定を読み込む

~/.claude/skills/ads/references/image-providers.md を読み込み、次の項目を確認します：

• アクティブなプロバイダーの料金（費用の見積もりをユーザーに提示）
• 現在のティアのレート制限
• バッチ API の利用可否

ステップ 4：プラットフォーム仕様を読み込む

キャンペーン概要に含まれる各プラットフォームについて、該当する仕様のリファレンスを読み込みます：

• ~/.claude/skills/ads/references/meta-creative-specs.md（フィード／リール／ストーリーズの仕様とセーフゾーン）
• ~/.claude/skills/ads/references/google-creative-specs.md（PMax／RSA／YouTube の生成対応仕様）
• ~/.claude/skills/ads/references/tiktok-creative-specs.md（9:16 のみ＋セーフゾーンのオーバーレイ）

さらに、プラットフォーム間のアスペクト比と文字数を標準化するため、~/.claude/skills/ads/references/platform-specs-cross.md を読み込みます。

ステップ 5：banana の設定を準備する

~/.banana/presets/{brand-slug}.json にブランドプリセットがまだ存在しない場合は、brand-profile.json から banana のブランドプリセットを作成します。

キャンペーン概要の内容に基づいて、banana のドメインモードを選択します：

• Product：E コマース、商品写真
• Editorial：ブランド認知、ライフスタイル
• Cinema：動画サムネイル、ドラマチックな表現
• UI/Web：アプリのインストール、SaaS
• Portrait：お客様の声、人物

ステップ 6：ビジュアルデザイナーエージェントを起動する

選択したドメインモードとプリセット名を渡し、context: fork を指定して Task ツールで visual-designer エージェントを起動します。

エージェントは次の処理を行います：

• campaign-brief.md から画像生成ブリーフを解析します
• brand-profile.json からブランドカラーと雰囲気を適用します
• 各アセットに、設定されたドメインモードで banana-claude を使用します
• ./ad-assets/[platform]/[concept]/ のディレクトリ構成に保存します
• generation-manifest.json を書き込みます

ステップ 7：フォーマットアダプターで検証する

visual-designer の処理が完了したら、context: fork を指定して format-adapter エージェントを起動し、寸法を検証して不足しているフォーマットを報告させます。

ステップ 8：品質ゲート

Claude vision を使用して、生成された各画像をブリーフに照らして評価します（ブランドとの一致度、構図、プラットフォームへの適合度を 1〜10 で採点します）。いずれかの画像のスコアが 6 未満の場合は、プロンプトを調整して 1 回だけ再生成します。

品質ゲートの評価基準：

• 9-10：プロフェッショナルな品質で、ブランドと一致し、プラットフォーム向けに最適化されており、問題がありません
• 7-8：品質は良好です。構図やブランドとの一致度には、多少の改善の余地があります
• 5-6：許容範囲ですが、再生成が必要です。テキストの読みづらさ、構図の悪さ、またはブランドとの不一致があります
• 5 未満：却下します。プロンプトを調整して再生成してください

ステップ 9：コストの集計

~/.banana/costs.json から banana のコストデータを読み込み、generation-manifest.json にクリエイティブの合計費用を記載します。

ステップ 10：結果の報告

概要を提示します：

Generation complete:

  Generated assets:
    ✓ ./ad-assets/meta/concept-1/feed-1080x1350.png
    ✓ ./ad-assets/tiktok/concept-1/vertical-1080x1920.png
    ✗ ./ad-assets/google/concept-1/landscape-1200x628.png [error reason]

  Format validation: See format-report.md

  Cost: $[N] total creative spend (from ~/.banana/costs.json)

  Next steps:
    1. Review assets in ./ad-assets/
    2. Check format-report.md for any missing formats
    3. Upload to your ad platform managers

コストの透明性

生成を始める前に、コストを見積もって提示します：

• campaign-brief.md にある画像ブリーフの数を数えます
• banana の料金ティアに基づく推定コストを提示します
• $1.00 を超える場合は、続行する前に確認を求めます

スタンドアロンモード（campaign-brief.md がない場合）

キャンペーンブリーフなしで実行する場合：

Platform target → dimensions used:
  meta-feed     → 1080×1350 (4:5)
  meta-reels    → 1080×1920 (9:16)
  tiktok        → 1080×1920 (9:16)
  google-pmax   → 1200×628 (1.91:1)
  linkedin      → 1080×1080 (1:1)
  youtube       → 1280×720 (16:9)
  youtube-short → 1080×1920 (9:16)

指定されたプロンプトとアスペクト比を使用して、/banana generate を直接実行します。

参照ファイル

• ~/.claude/skills/ads/references/image-providers.md：プロバイダー設定、料金、制限
• ~/.claude/skills/ads/references/[platform]-creative-specs.md：プラットフォームごとの仕様
• ~/.claude/skills/ads/references/brand-dna-template.md：ブランド情報の挿入スキーマ