ad-orchestrator

name	ad-orchestrator
description	端到端广告生成流水线编排，一键完成从商品信息到完整广告素材包的生成
metadata	{"openclaw":{"emoji":"🚀","requires":{"bins":["python3"],"env":["ARK_API_KEY"]},"primaryEnv":"ARK_API_KEY"}}

流水线编排 Skill

将所有广告生成Skills组合为端到端的一键流水线：商品信息 → 文案 → 场景图 → 视频 → 分析 → 变体。

使用方法

python3 scripts/run_pipeline.py \
  --product-image ./product.jpg \
  --product-info '{"name": "无线耳机", "price": "299元", "features": ["主动降噪", "40小时续航"]}' \
  --platform douyin \
  --style minimal \
  --output-dir ./ad_output

参数说明

参数	类型	必填	说明
--product-image	string	✅	商品主图路径
--product-info	JSON	✅	商品信息，包含名称、价格、卖点等
--platform	string	✅	目标平台：douyin/xiaohongshu/taobao/kuaishou
--tone	string		文案风格：urgent/elegant/fun/professional/cute/casual/formal，默认根据平台自动选择
--style	string		视觉风格：minimal/realistic/cartoon/vintage/futuristic，默认minimal
--motion	string		运镜效果：zoom/pan/rotate/parallax/static，默认zoom
--duration	number		视频时长（秒），默认15
--ratio	string		视频比例，默认根据平台自动选择
--skip-variants	boolean		跳过A/B测试变体生成，默认false
--variant-count	number		变体数量，默认3
--skip-analysis	boolean		跳过素材分析，默认false
--output-dir	string		输出目录，默认 ./ad_output
--resume	boolean		从上次中断的地方继续，默认false

输出目录结构

ad_output/
├── task_info.json           # 任务信息
├── copy/                    # 文案
│   └── ad_copy.json
├── scenes/                  # 场景图
│   ├── scene_1.png
│   ├── scene_2.png
│   └── scene_metadata.json
├── video/                   # 主视频
│   ├── ad_video.mp4
│   └── ad_video.srt
├── analysis/                # 分析报告
│   └── analysis_report.json
├── variants/                # A/B测试变体
│   ├── original/
│   ├── variant_1/
│   ├── variant_2/
│   └── variants_report.json
└── events/                  # 事件日志
    ├── event_copy_generated.json
    ├── event_scene_generated.json
    ├── event_video_generated.json
    ├── event_analysis_completed.json
    └── event_variants_generated.json

事件流

流水线会按顺序触发以下事件：

1. pipeline.started → 流水线启动
2. copy.generated → 文案生成完成
3. scene.generated → 场景图生成完成
4. video.generated → 视频生成完成
5. analysis.completed → 分析完成（如果启用）
6. variants.generated → 变体生成完成（如果启用）

平台默认配置

平台	默认比例	默认文案风格	建议时长
抖音	9:16	urgent	10-15秒
小红书	3:4	elegant	15-30秒
淘宝	1:1	professional	15-20秒
快手	9:16	fun	10-15秒

错误处理

• 每个步骤失败都会自动重试2次
• 支持断点续传，使用--resume参数从中断处继续
• 所有错误都会记录到 {output_dir}/pipeline.log