video-shotcraft 是一个开源的 AI Agent 技能包（Apache-2.0 许可），把「电影级产品宣传片」的制作方法固化成了 Claude Code、Codex 可以直接执行的技能：给它一个产品，它自动完成分镜、动效、音效设计与成片渲染。仓库当前在 GitHub 上拥有 7.0k star、623 fork，内置 157 张镜头配方卡、214 种动效风格与预览，以及一套验证过的完整宣传片模板。
镜头配方卡与 Remotion 实现
核心资产是镜头配方卡：每张卡记录镜头的用途、能量、建议时长、参数、实现要点和已知坑。与之配套的 demos 目录提供可运行的 Remotion TSX 组件，缓动与时间参数直接可见，不靠猜。音频侧内置 149 个音效（分 16 个场景类别）和 5 首 BGM，均来自 Mixkit 免费商用许可。所有镜头卡都可以在在线 Gallery 里搜索、筛选、切换变体并复制卡名。
镜头库仍在扩充：2026 年 8 月一批新增 48 张卡，是从 209 个候选动效里经 8 轮逐帧评审提炼出来的；9 月 1 日又加入「环形卡阵标题开场」「首词推近组句」两张新卡。
安装与使用
安装有两种方式：npx skills add Vincentwei1021/video-shotcraft，或 git clone 后把仓库软链到 ~/.claude/skills 与 ~/.codex/skills。装好后用自然语言提需求即可，比如「用 video-shotcraft 给我的桌面产品做一支宣传片」。不指定镜头卡时，技能会先展示内置模板并询问是否直接采用。
内置模板 Ink Press
模板是出片最快的路径：Ink Press 为一支完整的 36.2 秒产品宣传片，1920×1080、30fps、10 个镜头，纸墨琥珀风格，含 2.5D 真实页面运镜、标题卡、转场与完整的电影级音效通道。换入自己的产品截图、文案与品牌色，即可复现同等成片。官方 Gallery 的 38 秒开场视频本身就是用这套技能制作的。
无头渲染的三个坑
在无头 Linux 环境（官方测试为 2 核 + Node 22）渲染会踩三个墙：低核机器上 Remotion 的并发上限为 2，需要传 --concurrency=1；新版 Chrome 移除了旧版 headless 模式，应改用 chrome-headless-shell 而不是完整 Chrome；若 remotion.media 不可达导致 headless-shell 自动下载被拒，用 --browser-executable 指向本地二进制。三条对应修好后，模板帧渲染即可跑通。
剪映工程导出
成片交付后可导出为可编辑的剪映工程：镜头按片段切开（可变速、重排、调色），字幕重建为原生文本轨，音效与 BGM 落在独立音轨。该能力在 macOS 版剪映专业版 11.2 上验证通过，适合把 AI 成片接入人工后期流程。
姊妹项目 video-talkcraft
作者还维护面向解说视频的姊妹项目 video-talkcraft：78 张镜头卡，逐字时间戳本地对齐（中位 20–40 毫秒/字），配 7 层防幻灯片式镜头系统，适合把脚本加配音做成动态解说视频，工作流与 video-shotcraft 一致。
对大多数团队来说，这套技能包的实际价值是把「镜头设计、动效实现、音效卡点」这条最难复用的经验链固化成可执行资产：7.0k star 的社区验证说明它解决的是真实需求。想用 Claude Code 或 Codex 做产品视频的团队，可以从仓库地址 github.com/Vincentwei1021/video-shotcraft 开始，跑一遍 Ink Press 模板再谈定制。