AI Product Video — AI skill for Claude Code

ai-product-video：用 AI 给实体产品做视频

一个 AI 编程助手的 skill，**同时支持 [Claude Code](https://docs.claude.com/en/docs/claude-code) 和 [Codex](https://developers.openai.com/codex)**（两者用同一套开放的 Agent Skills 格式）。它把"3D 预演定位 → 图像模型画关键帧 → 视频模型生成镜头 → 代码剪辑、字幕、配乐、混音 → 多版本交付"这套流程，整理成 AI 助手可以照着执行的方法、模板和脚本。

适用于**实体产品**的视频：产品功能演示片、品牌广告（15/30/60 秒）、抖音、小红书、视频号等竖版短视频、电商主图视频、发布会和路演短片。纯剧情短剧、MV、动画等没有实体产品的视频不适用。

English summary: an Agent Skill for Claude Code and Codex for making AI-generated videos of physical products (explainers, ads, vertical social videos, e-commerce clips, launch films). It encodes a hybrid pipeline: 3D previs (optional) locks layout and scale; an image model paints photoreal keyframes on top; a video model animates first/last frames from per-second scripts; a code-driven EDL editor adds transitions, captions, leader-line callouts and cards; music and SFX are mixed by measurement. Documentation is in Simplified Chinese; scripts are cross-platform Python run with `uv`.

它解决什么问题

AI 视频做产品片，常见三种失败：

• 产品被画走样：接口方向、字样、比例都不对；
• 画面一股 CG 味或塑料感；
• 剪出来很生硬，字幕和声音都要手工反复改。

这个 skill 用三条原则来解决：

1. 产品事实和 3D（或产品图）是标准答案。 AI 只负责"画得真"，不负责"摆在哪"。代码对照标准答案检查每张图和每段视频，检查不过就不花钱。
2. 写实关键帧直接驱动视频。 先由图像模型在定位底图上画出照片质感的首帧和尾帧，再交给视频模型，按逐秒脚本生成。
3. 剪辑、字幕和声音都是数据。 EDL、字幕和标注都是 JSON，声音按时间线生成；改一个字或调一次顺序，几分钟就能重出一版。

目录结构

ai-product-video/
├── SKILL.md                 入口：先问什么、项目文件夹约定、流水线、最重要的 12 条、协作与安全
├── references/              方法库：按阶段分 10 篇，另有规则手册 139 条和常见坑速查表
├── templates/               立项单、产品事实确认单、质量标杆、预算、宣称清单、授权记录、镜头表、关键帧清单、反馈 brief、决策清单、音效表、出图包与手动视频包、提示词模板、EDL/字幕/标注/批准账本示例
├── scripts/
│   ├── edl_editor/          EDL 剪辑器和排版引擎（16:9、9:16、1:1），make_demo.py 一键生成演示项目
│   ├── video_api/           Seedance（火山方舟）客户端：草稿、高清升级、可续跑查询、费用账本，可照着它写别的模型的适配
│   ├── audio/               按时间窗平衡音乐和音效、实测、响度标准化
│   └── qc/                  逐帧拼图、运动和亮度曲线、硬切与定格检测、联系表、关键帧统一尺寸、提示词禁用词扫描
└── examples/case-study.md   一个真实项目的匿名复盘

安装

先装好 [uv](https://docs.astral.sh/uv/)（脚本都用它运行），再按你用的 AI 编程助手选一种方式。

方式一