video-shotcraft — 用 AI 生成电影级产品宣传视频

这是什么

video-shotcraft 是一个面向 AI 代理（Agent）的技能包，发布于 GitHub，仓库名为 vincentwei1021/video-shotcraft。它让 Claude Code 或 Codex 这类 AI 编程助手变成一个专业的动效设计工作室：你只需提供产品信息，它就能帮你完成分镜、动画、音效设计，并基于 Remotion 渲染出电影级的产品宣传视频——包括真实页面捕捉、2.5D 镜头运动、随音乐节拍切换的剪辑，以及电影级别的音效。

根据仓库描述，该技能包含 152 张镜头配方卡片和 209 个动效预览，并附赠一个经过验证的完整视频模板。项目采用 Apache-2.0 协议，目前已经获得 8531 个 Star、775 个 Fork，开放 Issue 4 个，活跃度很高。

适合谁

产品经理、创业者：快速制作产品宣传片，不需要专业视频剪辑技能。
独立开发者 / 一人公司：用 AI 自动生成营销视频，节省外包费用。
内容创作者：将文字创意转化为有视觉冲击力的视频素材。
AI Agent 工具使用者：已有 Claude Code 或 Codex，希望扩展其能力边界。

能做什么

一键生成产品宣传视频：告诉 AI “用 video-shotcraft 给我的桌面产品做一个宣传片”，它就会自动规划分镜、选择镜头、生成 Remotion 工程并渲染。
丰富的镜头配方库：内置 152 张镜头配方卡，覆盖 10 大功能分类，每张卡都包含用途、能量、建议时长、参数、实现细节和常见坑。
动效预览画廊：提供 209 个动效预览，可在线上画廊中搜索、筛选，并复制所选镜头卡名称用于生成。
内置完整模板 “Ink Press”：一个 36.2 秒、1920×1080、30fps 的 10 镜头产品宣传模板，采用纸张-墨水-琥珀风格，带 2.5D 真实页面运镜、标题卡、转场和完整的电影级音效。你只需替换产品截图和文案即可得到成品。
后续编辑能力：交付后可导出到剪映（CapCut 中国版）工程，或在浏览器中使用 Motion Workbench 进行时间轴编辑、调整镜头、拖拽动效并重新渲染。

该项目主要面向 Web 和桌面产品宣传视频，但单个镜头卡也适用于功能演示、品牌片、发布视频等更多动效场景。

使用前准备

安装 Node.js（建议 18 以上）和 npm，用于运行 Remotion 渲染。
安装 Claude Code 或 Codex，并确保能通过命令行调用。
准备好你的产品截图、文案和品牌信息（用于替换模板中的演示素材）。

安装方法

最直接的方式是在 AI Agent 中对它说：“Install this skill for me: https://github.com/Vincentwei1021/video-shotcraft”，Agent 会自动克隆仓库并链接到你的技能目录。也可以使用官方推荐的 skills CLI 安装：

npx skills add Vincentwei1021/video-shotcraft

或者手动克隆并添加软链接：

git clone https://github.com/Vincentwei1021/video-shotcraft.git
cd video-shotcraft
ln -s "$(pwd)" ~/.claude/skills/video-shotcraft   # Claude Code
# 或
ln -s "$(pwd)" ~/.codex/skills/video-shotcraft    # Codex

使用示例

安装完成后，你可以直接向 Agent 发出指令，例如：

Use video-shotcraft to create a promo for my desktop product.
Use the deck-deal-flyin and row-embed shot cards to present this feature.
Design a product close-up inspired by spotlight-hero-card.
如果不想指定镜头卡，可以说：Use video-shotcraft to make a promo for my product with the Ink Press template.，它会自动采用内置模板生成高质量成品。

如果未指定镜头卡，技能会先介绍内置视频模板并询问是否使用；你也可以提前在 Gallery 中选择喜欢的镜头卡。

风险与注意事项

需要本地环境：该技能依赖 Node.js 和 Remotion，必须在本地或支持 Node 的 CI 环境中运行。
无头渲染注意事项：在无显示器的 Linux 服务器上渲染时，可能遇到并发限制或 Chromium 兼容问题，需要按文档设置 --concurrency=1 或使用 chrome-headless-shell。
素材替换责任：模板附带的产品截图是演示素材，发布前必须替换为目标产品的截图，并检查是否需要匿名化敏感数据。
音频版权：仓库内的音频文件各有许可条款，商用前请查看 ATTRIBUTION.md 确认合规。
商标声明：镜头配方参考了 ClickUp、Perplexity 等产品的官方宣传片，但所有实现均从零编写，未包含任何受版权保护的素材；商标归各自所有者所有。
版本差异：仓库描述中为 152 张卡片 / 209 个预览，而 README 中提到了 157 张卡片 / 214 个预览，实际以最新文档为准，安装后可查看仓库内 references/shots/ 目录。

总体而言，这是一款高质量、开源的 AI 视频生成技能，适合对视频质量要求较高、又希望快速交付的用户。如果你正在寻找一种 AI 驱动的产品视频制作方案，这个仓库值得一试。