ads-generate

Ads Generate：AI 广告图片生成器

根据广告系列简报和品牌档案生成符合各平台尺寸要求的广告创意图片。使用 banana-claude 作为图片生成服务提供方。

快速参考

命令	功能
/ads generate	根据 campaign-brief.md 生成所有图片
/ads generate --platform meta	仅生成 Meta 素材
/ads generate --prompt "text" --ratio 9:16	不使用简报，独立生成图片

环境设置

运行前必须完成：

• 需要 banana-claude（v1.4.1+），并配置 nanobanana-mcp
• 运行 /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（Feed/Reels/Stories 规格 + 安全区域）
• ~/.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：电商、产品图
• Editorial：品牌认知、生活方式
• Cinema：视频缩略图、戏剧化风格
• UI/Web：应用安装、SaaS
• Portrait：客户评价、人物

第 6 步：启动视觉设计师 Agent

使用 Task 工具启动 visual-designer Agent，并设置 context: fork，传入所选域模式和预设名称。

该 Agent 将：

• 解析 campaign-brief.md 中的图片生成简报
• 从 brand-profile.json 注入品牌颜色和氛围
• 为每项素材使用配置了相应域模式的 banana-claude
• 按 ./ad-assets/[platform]/[concept]/ 目录结构保存
• 写入 generation-manifest.json

第 7 步：使用格式适配器验证

visual-designer 完成后，启动 format-adapter Agent，并设置 context: fork，以验证尺寸并报告缺失的格式。

步骤 8：质量门槛

使用 Claude vision 根据创意简报评估每张生成的图片（从品牌契合度、构图和平台适配度三个方面打分，1 到 10 分）。如果任何图片的评分低于 6 分，则调整提示词后重新生成一次。

质量门槛评分标准：

• 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）

在没有 campaign brief 的情况下运行时：

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：品牌信息注入架构