静的広告・グラフィックデザインエージェント (static-ad-design-agent)
入力: ブランドキット (MASTER_CONTEXT.md、ウェブサイトURL、パレット、フォント、ロゴ、製品スクリーンショット) + オファー/アングル
出力: 完成済みの Instagramカルーセル、静的画像広告 (フィード、ポートレート、ストーリー、ランドスケープ)、バナー、サムネイル、決定論的ビジュアル&コピー品質保証 (_qa/qa-report.json)、および インタラクティブビジュアルレビューボード (review/index.html)。
このスキルは mrpaidsocial-video-editor-agent の静的クリエイティブ版姉妹パックです。同じ文化に従います:検証するのは意図ではなく、ピクセル、セーフゾーン、およびクレームコンプライアンスです。
パイプラインの概要
(0) インテーク&ブランドトークン (MASTER_CONTEXT.md + オファー/アングル)
│
▼
(1) アングル&アーキタイプ計画 ──→ ads-manifest.json (バリアント、カルーセル、コピー、UTM)
│
▼
(2) コンポジション構築 ───────→ ad-canvas-starter.html をベースにしたHTML/CSSまたはPillow/SVGアートボード
│
▼
(3) PNGにラスタライズ ────────→ 1080x1350 (4:5)、1080x1080 (1:1)、1080x1920 (9:16)、1200x628、1920x1080
│
▼
(4) 決定論的QAループ ──────→ python3 scripts/qa_static_ads.py (ピクセル、セーフゾーン、禁止クレーム)
│
▼
(5) インタラクティブレビューボード → python3 scripts/build_ad_review_board.py → review/index.html
ステージ0 — インテーク&ブランドトークン
- 現在のワークスペースルートに
MASTER_CONTEXT.mdがあるか確認します(またはMASTER_CONTEXT.template.mdからコピーします)。 - 以下を抽出します:
- ブランドトークン:
--bg-ink、--bg-paper、--accent-primary、--accent-secondary、--accent-alert、見出し/本文フォント、ロゴ、実際の製品スクリーンショット。 - ガードレール:
banned_phrases(禁止フレーズ)と標準語彙ルール。
- ブランドトークン:
- デリバラブルパックを確認またはデフォルトに設定します:
- カルーセルパック:
1080×1350(4:5、最大縦フィード表示領域)の5~7スライド。 - 静的広告3点セット:
1080×1350(4:5フィード)、1080×1080(1:1スクエア)、1080×1920(9:16ストーリー/リール枠)。 - バナー/サムネイル:
1200×628(リンク/ディスプレイ広告)または1920×1080(ビデオサムネイル)。
- カルーセルパック:
- キャンペーン作業フォルダを作成します:
outputs/<campaign-slug>/ ├── ads-manifest.json ├── artboards/ ├── renders/ ├── _qa/ └── review/
ステージ1 — アングル&アーキタイプ計画 (ads-manifest.json)
カードをレイアウトする前に、references/archetypes-and-safe-zones.md をお読みください。10の実績ある静的&カルーセルアーキタイプから選択します:
- 誤りスタンプ神話打破(スクリーンショット/主張に
WRONGまたはMYTHスタンプを重ねる → 真実のカード) - 対比スプリット比較(2カラムの対比表:従来の方法 vs ブランドの方法)
- 注釈付き製品UI証明(実際の製品スクリーンショットまたはカードに3つの拡大コールアウトピル)
- コスト/時間積み上げレシート(隠れたコスト/時間を積み上げたレシート vs 1つのクリーンな解決策)
- 3ステップメカニズム図(入力 → エンジン → 出力、番号付きバッジ付き)
- 統計ヒーロー+引用元(巨大なメトリクスコールアウト+下部に原文引用ストリップ)
- チェックリストゲートカード(「これらの4つのチェックボックスを確認するまで申し込むな/開始するな」)
- ビフォー/アフター状態カード(圧倒/分散状態 → 構造化ロードマップ状態)
- 5~7スライドナラティブカルーセル(スライド1 フック → スライド2 動揺/データ → スライド3-5 実用的価値+製品証明 → スライド6 サマリーチェックリスト → スライド7 CTA)
- ハイコントラストサムネイル/バナー(3~5ワードのパンチフレーズ+フォーカル被写体/UI+コントラストバッジ)
outputs/<campaign-slug>/ads-manifest.json を、scripts/qa_static_ads.py でチェックされるスキーマに従って記述します:
{
"campaign_slug": "sa-bursary-deadlines-q4",
"brand_name": "Gradwyn",
"offer_angle": "南アフリカの工学・CS奨学金の締切を逃さないでください。要件が40のPDFに分散しているからです。",
"cta_url": "https://gradwyn.com/?utm_source=meta&utm_medium=paid_social&utm_campaign=sa_bursaries",
"banned_phrases": [
"合格保証",
"奨学金保証",
"入学確率",
"入学可能性"
],
"brand_palette": ["#0c1a17", "#f6f1e8", "#1a6b5c", "#c4892a", "#c45c4a"],
"creatives": [
{
"id": "carousel-01",
"type": "carousel",
"archetype": "5-slide-narrative-carousel",
"format": "4:5",
"width": 1080,
"height": 1350,
"primary_text": "ほとんどの学生が奨学金を逃すのは、成績のせいではなく、締切の2週間後にそれらを発見するからです。",
"headline": "自分の学生プロフィールに合った奨学金を見る",
"cta_label": "もっと詳しく",
"slides": [
{
"slide_index": 1,
"file": "renders/carousel-01-slide-01.png",
"eyebrow": "2027年入学 · 南アフリカ&グローバル",
"headline": "野心的な学生が毎年資金を逃す3つの理由",
"subhead": "そして、4分で期限管理されたロードマップを構築する方法→",
"footer_note": "チェックリストはスワイプ (1/5)"
}
]
},
{
"id": "static-feed-01",
"type": "static_ad",
"archetype": "us-vs-them-split",
"format": "4:5",
"width": 1080,
"height": 1350,
"file": "renders/static-feed-01.png",
"eyebrow": "大学&奨学金ガイダンス",
"headline": "40のブラウザタブからの推測をやめよう。",
"subhead": "透明なフィットスコアとステップバイステップのロードマップで、3つの大学マッチを入手。",
"primary_text": "Gradwynは、明確な理由と公式情報源を用いて、AIで学生を大学と奨学金にマッチングします。",
"cta_label": "3つのマッチを入手"
}
]
}
ステージ2 & 3 — アートボードの構築とPNGへのラスタライズ
- resources/ad-canvas-starter.html から開始するか、または scripts/qa_static_ads.py 内の組み込みレンダラー(
--render-from-manifest)を使用します。これは、ヘッドレスブラウザレンダリングが利用できない場合に、Pillow + TrueTypeフォント(NotoSerif/NotoSans)を使用してads-manifest.jsonから直接、鮮明で出版品質の1080×1350、1080×1080、1080×1920、1200×628、1920×1080PNGアートボードをレンダリングできます。 - references/archetypes-and-safe-zones.md で定義されたプラットフォームのセーフゾーンを尊重します:
9:16(1080×1920)ストーリー/リール広告: すべてのテキストとロゴをy: 250px .. 1520pxかつx: 72px .. 1008pxの範囲内に収めます。4:5(1080×1350)フィード/カルーセル: すべてのテキストを72pxの外側パディング(936×1206のセーフボックス)内に収め、スライドインジケーターバッジはInstagramが1/5カウンターをオーバーレイする右上隅140×100pxに配置しないようにします。1:1(1080×1080)スクエア:64pxの外側パディング。
ステージ4 — 決定論的ビジュアル&コピー品質保証
キャンペーンフォルダに対してQAエンジンを実行します:
python3 scripts/qa_static_ads.py --manifest outputs/<campaign-slug>/ads-manifest.json --render-missing
qa_static_ads.py がすべてのアセットで検証する内容:
- ファイル&ピクセル完全性: 参照されているすべてのPNGが存在し、破損しておらず、宣言された正確なピクセル幅と高さ(
1080×1350、1080×1080、1080×1920、1200×628、1920×1080)と一致すること。 - ビジュアルバリアンス&エッジマージンチェック: 画像が空白/フラットでないことを確認し、セーフゾーンエッジでの誤ったテキストクリッピングをチェックします。
- コピー密度&階層: 見出しの単語/文字数の上限(モバイルでの即時スキャン用にキャンバス上の見出しは
<= 12単語)、プライマリテキストの完全性、CTAの存在を強制します。 - ガードレール&禁止クレームゲート: すべての見出し、サブヘッド、スライド本文、プライマリキャプションを
MASTER_CONTEXT.mdのbanned_phrasesに対してスキャンします。違反があると、正確な行レポートとともにQAが失敗します。 - 目視検査:
qa_static_ads.pyが合格した後、レンダリングされたPNGを目視で検査し、階層、コントラスト、配置を確認します。
ステージ5 — インタラクティブビジュアルレビューボード
人間によるレビュー用のキャンバスを生成します:
python3 scripts/build_ad_review_board.py --manifest outputs/<campaign-slug>/ads-manifest.json
これにより、outputs/<campaign-slug>/review/index.html が作成され、以下の機能が提供されます:
- すべての Instagramカルーセル スライドストリップの水平スワイプ/スクロールプレビュー。
- 静的画像広告、ストーリー広告、バナー、サムネイル の完全グリッド。
- インタラクティブセーフゾーンオーバーレイトグル(グラフィックス上にMeta/IG/TikTok UIデッドゾーンを直接表示)。
- アセットごとのQAバッジ(
_qa/qa-report.jsonから「合格」/「警告」/「不合格」)。 - ワンクリックコピー(プライマリテキスト、見出し、UTMタグ付きCTA URL用)。
- 承認/修正フラグ トグル(JSONリビジョンノートエクスポート付き)。