ecommerce-video-skills Skill 技能

ecommerce-video-skills 是什么

ecommerce-video-skills（GitHub: xianyu110/ecommerce-video-skills，MIT 开源）是一组专门为 Claude Code / Codex / Cursor 设计的电商短视频 Agent Skill 集合。它把"写带货脚本 → 写钩子 → 拆 15/30/60 秒分镜 → 出图生视频镜头提示词 → edge-tts 配音 → ASS 字幕/花字 → 本地 ffmpeg 拼片 → 平台规格导出 → 封面 A/B"的全链路拆成 13 个可独立安装的 Skill，丢几张商品图给 Agent，它就能出一段带字幕、配音、转场的 9:16 竖屏带货视频，全程不需要剪映/Pr、不需要云端视频服务、不需要任何 API Key（除了可选的图生视频模型）。

核心能力

• 爆款拆解复刻：viral-remake skill 把抖音/TikTok 链接或转写拆成 8 维结构 + 5-beat 模型，再换成自己的商品直接出分镜 JSON。
• 可执行的本地流水线：edge-tts 逐句配音 → Ken Burns 镜头（scale + crop，比 zoompan 稳）→ xfade 转场（居中在镜头分界，不吃配音）→ ASS 字幕/花字/CTA → 自动 BGM 闪避 → 两遍 loudnorm 到 -14 LUFS → MP4 + SRT。
• 商品一致性锁：图生视频提示词第一步先锁定形状/颜色/Logo，减少"视频很酷但商品变形"的常见问题。
• 平台规格导出：抖音 / TikTok Shop / 视频号 / 小红书 3:4 / 淘宝主图 1:1 / Amazon 16:9 一键导出，字幕自动避开底部商品卡和右侧按钮。
• 多语言本地化配音：同一份 storyboard 加 line_en 等字段，--lang en 直接渲染英文版，东南亚、日韩、拉美音色已内置。
• 直播录像自动切片：传入 3 小时直播录像 + 字幕，可按"关键词 + 停顿"批量切 30 秒竖屏高光。

安装配置

• 一行安装：执行 npx skills add xianyu110/ecommerce-video-skills，Skill CLI 自动完成。
• Claude Code 安装：在 Claude Code 中执行 /plugin marketplace add xianyu110/ecommerce-video-skills，或手动 cp -r skills/* ~/.claude/skills/。
• Codex 安装：手动 cp -r skills/* ~/.codex/skills/。
• Cursor 安装：手动 cp -r skills/* .cursor/skills/（项目内）。
• 依赖：pip install -r requirements.txt（pillow / numpy / edge-tts）+ 系统级 ffmpeg（需含 libass）。

使用步骤

1. 把商品图丢给 Agent（例如保温杯拍 6 张），调用 selling-point-storyboard 让它生成 storyboard.json。
2. 调用 hook-3s-script 让 Agent 出 8 个 3 秒开场钩子（含广告法禁用词自检），选 Top 3。
3. 调用 ffmpeg-auto-assemble 用 storyboard.json 渲染本地成片：python scripts/assemble.py storyboard.json -o out/demo.mp4。
4. 调用 platform-spec-export 同时导出抖音、TikTok Shop、小红书等平台规格：--platform douyin tiktok-shop xiaohongshu。
5. 调用 cover-title-ab 生成 3 种封面 / 标题 A/B 版本：python scripts/cover_ab.py out/demo.mp4 --images build/still00.png build/still03.png --titles "..."。

适用场景

• 跨境电商运营：把同一段成片一键本地化为美/英/印尼/泰语，铺 TikTok Shop 多市场。
• 抖音带货剪辑：用 live-stream-clips 把 3 小时直播录像批量切成 30 秒高光，复用为短视频素材。
• 小红书 / 视频号：3:4 或 9:16 一键导出，自动避开底部商品卡安全区。
• 淘宝主图视频：1:1 主图视频规格直接出，OSS/详情页自动播放。
• Amazon 视频主图：16:9 横屏 + 多语言配音，符合 Amazon Brand Video 广告规范。

适用人群

• 独立电商卖家：每天要发 5-10 条短视频、没有剪辑师的小团队。
• 跨境电商代运营：多市场多语种铺货，要求快速本地化的内容团队。
• 带货博主：个人 IP，需要每天输出 5-15 秒高完播率钩子的内容创作者。
• Agent 应用开发者：研究如何把"AI 写脚本 + 工程化剪辑"流水线化的开发者。

工作原理

每个 Skill 在 skills//SKILL.md 自包含一份契约文档 + scripts/ 子目录里携带可执行 Python 脚本，Agent 通过读 SKILL.md 理解契约，调用脚本完成具体剪辑/合成工作。Skill 之间通过一份统一的 storyboard.json 编排契约进行解耦：钩子 skill 输出钩子、卖点分镜 skill 输出 storyboard、AI 配音 skill 输出配音音频、字幕花字 skill 输出 ASS 字幕、ffmpeg-auto-assemble 把它们组合成片，平台导出 skill 再把片切成不同规格。

官方链接

• GitHub 仓库：https://github.com/xianyu110/ecommerce-video-skills
• 配套出图 Skill：https://github.com/xianyu110/ecommerce-image-skills