xianyu110 / selling-point-storyboard

卖点分镜表 · Selling-Point Storyboard

从「卖点清单」到「能直接渲染的分镜表」。输出两份：人看的 Markdown 表格 + 机器跑的 storyboard.json（给 ffmpeg-auto-assemble）。

Part of ecommerce-video-skills

输入 Inputs

• 商品信息与 真实 卖点（3 个最好，最多 5 个）
• 时长目标：15s（种草/主图视频）· 30s（标准带货）· 60s（测评/讲解）
• 现有素材：商品图、场景图、实拍视频（文件名列出来）
• 平台 + 画幅；配音语言与音色偏好

结构公式 Structure

规则：一镜一信息；每个卖点都要配「证明画面」（演示、细节、对比），光说不演不算卖点。

步骤 Steps

1. 卖点排序：按「用户最在意 × 画面最好证明」排序，最强的放第 2–3 镜。
2. 每镜写：时间、画面（用哪张素材/要拍什么）、台词（每镜 ≤ 2 句，中文 4–5 字/秒）、字幕（关键词用 **加粗** 标高亮）、花字（可选）、运镜。
3. 时长核算：台词字数 ÷ 4.5 ≈ 秒数；总时长超了就删台词，不要加快语速超过 +20%。
4. 缺素材的镜头标记 TODO，并给出拍摄/生成建议（可交给 image-to-video-shots 或姊妹仓库 ecommerce-image-skills 出图）。
5. 输出 Markdown 表 + storyboard.json。

分镜表模板

storyboard.json 模板

{
  "voice": "zh-CN-YunxiNeural", "rate": "+10%", "bgm": "auto", "tag": "品牌名 · 型号",
  "shots": [
    {"image": "assets/scene.jpg", "motion": "punch", "line": "钩子台词", "sub": "钩子**关键词**", "title": "花字"},
    {"image": "assets/main.jpg", "motion": "zoom_in", "line": "产品亮相台词"},
    {"image": "assets/detail.jpg", "motion": "pan_down", "fit": "blur", "line": "卖点一台词", "sub": "卖点一|**证明**"},
    {"video": "clips/demo.mp4", "start": 3.0, "line": "卖点二演示台词"},
    {"image": "assets/end-card.png", "min": 3.0, "line": "行动号召台词", "sub": "", "cta": "点击下方链接 ›"}
  ]
}

字段说明见 ffmpeg-auto-assemble。渲染：python skills/ffmpeg-auto-assemble/scripts/assemble.py storyboard.json -o out/video.mp4。

提示词模板 Prompt template

你是电商短视频编导。根据以下信息写一份 {15} 秒竖屏带货分镜表。
商品：{…}；目标人群：{…}；平台：{…}
真实卖点（不得编造数据、认证、价格）：{…}
可用素材文件：{lifestyle.webp, white-bg.webp, …}
要求：一镜一信息；每个卖点配证明画面；台词每镜 ≤ 2 句，总字数 ≤ {时长×4.5}；
关键词用 **加粗**；最后一镜是行动号召。
先输出 Markdown 分镜表，再输出符合下面 schema 的 storyboard.json：{粘贴上方模板}

检查清单 Checklist

• [ ] 第 1 镜是钩子（见 hook-3s-script），最后 1 镜是行动号召
• [ ] 总台词字数 ≈ 时长 × 4.5（中文）/ × 2.5 词（英文）
• [ ] 每个卖点都有证明画面；没有编造的数据、认证、价格
• [ ] 每镜素材都存在或标了 TODO
• [ ] JSON 能通过 python -m json.tool storyboard.json

常见问题与修复 Failure fixes