靜態廣告與圖形設計代理 (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和標準詞彙規則。
- 品牌代碼:
- 確認或預設交付包:
- 輪播包: 5–7 頁,尺寸
1080×1350(4:5垂直動態消息最大實際佔用面積)。 - 靜態廣告三件組:
1080×1350(4:5動態消息)、1080×1080(1:1正方形)、1080×1920(9:16限時動態/Reels 版位)。 - 橫幅/縮圖:
1200×628(連結/展示廣告)或1920×1080(影片縮圖)。
- 輪播包: 5–7 頁,尺寸
- 建立廣告活動工作資料夾:
outputs/<campaign-slug>/ ├── ads-manifest.json ├── artboards/ ├── renders/ ├── _qa/ └── review/
階段 1 — 切入點與原型計畫 (ads-manifest.json)
在佈局卡片之前,請閱讀 references/archetypes-and-safe-zones.md。從 10 個經過驗證的靜態與輪播原型中選擇:
- 錯誤戳記神話破解者(螢幕截圖/聲明加上清晰的
錯誤或神話戳記 → 真相卡) - 我們 vs. 他們分割比較(雙欄對比表格:舊方法 vs. 品牌方法)
- 註釋產品 UI 證明(真實產品螢幕截圖或卡片,帶有 3 個放大標註藥丸)
- 成本/時間累積堆疊(隱藏成本/小時的堆疊收據 vs. 1 個乾淨的解決方案)
- 三步機制圖解(輸入 → 引擎 → 輸出,帶有編號徽章)
- 統計英雄 + 引用來源(大型指標標註 + 底部逐字引用條)
- 檢查清單閘門卡(「在您檢查這 4 個項目之前,請勿申請/啟動」)
- 之前/之後狀態卡(不知所措/分散的狀態 → 結構化的路線圖狀態)
- 5–7 頁敘事輪播(第 1 頁鉤子 → 第 2 頁煽動/數據 → 第 3–5 頁可操作價值 + 產品證明 → 第 6 頁摘要檢查清單 → 第 7 頁行動呼籲)
- 高對比縮圖/橫幅(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": "別錯過 SA 工程與 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": "大多數學生錯過獎學金不是因為成績——而是因為他們在截止日期兩週後才發現它們。",
"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),該渲染器可在無頭瀏覽器渲染不可用時,直接從ads-manifest.json使用 Pillow + TrueType 字體(NotoSerif/NotoSans)渲染清晰的、出版級的1080×1350、1080×1080、1080×1920、1200×628和1920×1080PNG 畫板。 - 遵守 references/archetypes-and-safe-zones.md 中定義的平台安全區域:
9:16(1080×1920)限時動態/Reels 廣告: 將所有文字和標誌保持在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 個字以利即時行動裝置瀏覽)、主要文字完整性和行動呼籲的存在。 - 護欄與禁用聲明閘門: 針對
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 標記的行動呼籲 URL。
- 核准 / 標記為需要修訂 切換開關,並附有 JSON 修訂筆記匯出功能。