ad-abtest

name	ad-abtest
description	自动生成广告素材的A/B测试变体，支持多个维度的变体生成
metadata	{"openclaw":{"emoji":"🔬","requires":{"bins":["python3","ffmpeg"],"env":["ARK_API_KEY"]},"primaryEnv":"ARK_API_KEY"}}

A/B测试变体生成 Skill

基于原始广告素材自动生成多个测试变体，支持文案、色调、运镜、时长等多个维度的变化，用于A/B测试效果对比。

使用方法

python3 scripts/generate_variants.py \
  --base-video ./ad_video.mp4 \
  --base-copy ./ad_copy.json \
  --dimensions copy,color,motion \
  --count 4 \
  --output-dir ./variants

参数说明

参数	类型	必填	说明
--base-video	string	✅	原始广告视频路径
--base-copy	string	✅	原始广告文案JSON路径
--dimensions	string	✅	变体维度，多个用逗号分隔：copy/color/motion/duration/subtitle
--count	number		生成的变体数量，默认4
--output-dir	string		输出目录，默认 ./variants
--keep-original	boolean		是否在输出中保留原始版本，默认true
--generate-metadata	boolean		是否生成变体元数据报告，默认true

支持的变体维度

维度	说明	变化范围
copy	文案变体	不同的标题、描述、CTA
color	色调变体	冷色调、暖色调、复古色调、高对比度
motion	运镜变体	不同的镜头运动方式和速度
duration	时长变体	7秒、10秒、15秒、30秒
subtitle	字幕变体	不同的字幕样式、位置、内容

输出目录结构

variants/
├── original/                # 原始版本（可选）
│   ├── video.mp4
│   └── copy.json
├── variant_1/               # 变体1
│   ├── video.mp4
│   ├── copy.json
│   └── metadata.json
├── variant_2/               # 变体2
│   ├── video.mp4
│   ├── copy.json
│   └── metadata.json
└── variants_report.json     # 变体总报告

事件发布

生成完成后会发布 variants.generated 事件到消息总线。

变体报告格式

{
  "taskId": "task_123456",
  "baseVideo": "./ad_video.mp4",
  "dimensions": ["copy", "color"],
  "count": 4,
  "variants": [
    {
      "id": "variant_1",
      "dimensions": {"copy": "variant_A", "color": "warm"},
      "videoPath": "./variants/variant_1/video.mp4",
      "description": "文案变体A，暖色调"
    }
  ],
  "generatedAt": "2026-03-11T12:00:00Z"
}

使用建议

1. 一次测试不要超过3个维度，避免变量过多难以分析
2. 变体数量建议4-6个，包含原始版本作为对照
3. 测试时保持投放渠道、时间、预算一致
4. 重点关注转化率、完播率、点击率等核心指标