静态广告与图形设计智能体 (static-ad-design-agent)
输入: 品牌套件(MASTER_CONTEXT.md、网站 URL、调色板、字体、Logo 或产品截图)+ 优惠/角度
输出: 完整的 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、标题/正文字体、Logo 和真实产品截图。 - 护栏:
banned_phrases和标准词汇规则。
- 品牌令牌:
- 确认或默认物料包:
- 轮播图包: 5-7 张幻灯片,尺寸
1080×1350(4:5垂直信息流最大展示面积)。 - 静态广告三件套:
1080×1350(4:5信息流)、1080×1080(1:1正方形)、1080×1920(9:16快拍/Reel 投放位)。 - 横幅/缩略图:
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. 他们分屏对比(2 栏对比表:旧方式 vs. 品牌方式)
- 带标注的产品 UI 证明(真实产品截图或卡片,附有 3 个放大的标注气泡)
- 成本/时间累加堆栈(隐藏成本/小时的堆叠收据与 1 个清晰解决方案对比)
- 3 步机制示意图(输入 → 引擎 → 输出,带编号徽章)
- 数据英雄 + 引用来源(巨大的指标数字 + 底部逐字引用条)
- 清单关卡卡片(“在检查这 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": "Don't miss SA engineering & CS bursary deadlines because requirements are buried across 40 PDFs.",
"cta_url": "https://gradwyn.com/?utm_source=meta&utm_medium=paid_social&utm_campaign=sa_bursaries",
"banned_phrases": [
"guaranteed admission",
"guaranteed scholarship",
"chance of getting in",
"admission probability"
],
"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": "Most students miss scholarships not because of grades—but because they discover them 2 weeks after the deadline closed.",
"headline": "See scholarships matched to your Student Profile",
"cta_label": "Learn More",
"slides": [
{
"slide_index": 1,
"file": "renders/carousel-01-slide-01.png",
"eyebrow": "2027 INTAKE · SOUTH AFRICA & GLOBAL",
"headline": "3 Reasons Ambitious Students Miss Funding Every Year",
"subhead": "And how to build a deadline-tracked Roadmap in 4 minutes →",
"footer_note": "Swipe for the checklist (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": "UNIVERSITY & SCHOLARSHIP GUIDANCE",
"headline": "Stop Guessing From 40 Open Browser Tabs.",
"subhead": "Get 3 university Matches with a transparent Fit Score and step-by-step Roadmap.",
"primary_text": "Gradwyn matches students to universities and scholarships using AI—with clear reasons and official sources.",
"cta_label": "Get Your 3 Matches"
}
]
}
阶段 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)快拍/Reel 广告: 将所有文字和 Logo 保持在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 标签的行动号召链接。
- 批准 / 标记为修订切换开关,并支持 JSON 修订笔记导出。