video-shotcraft 详细部署教程：用AI打造电影级产品宣传片

video-shotcraft 是一个专为 AI 编程助手（如 Claude Code、Codex）设计的技能包，它能让你通过自然语言指令，自动生成具有电影质感的产品宣传视频。它基于 Remotion 框架，内置了 157 种镜头卡片（Shot Recipe Cards）、214 种动态预览 和一个可直接运行的视频模板。

本教程将指导你完成安装，并带你快速上手制作第一个视频。

第一步：准备工作与环境要求

在安装技能前，请确保你的开发环境满足以下条件。

1. 核心依赖

组件 版本/要求 说明
AI 编程助手 Claude Code 或 Codex 技能运行的基础环境，通过自然语言驱动。
Node.js 推荐 Node 18+ 或 20+ Remotion 基于 Node.js，用于渲染视频。
npm 通常随 Node.js 安装 用于安装项目依赖。
Git 最新版 用于克隆技能仓库。

2. 硬件与系统建议

  • 操作系统：macOS、Linux 或 Windows（需配置好上述环境）。
  • 网络：安装和渲染过程需要下载依赖包（如 Remotion、Chromium 等），请确保网络通畅。
  • CPU：至少 2 核心（Render 时可使用 --concurrency=1 来适配低配机器）。

第二步：安装 video-shotcraft 技能

推荐的安装方式是通过 AI 助手自动完成，或使用技能 CLI 手动安装。

方式一：让 AI 助手自动安装（最直接）

在你的 Claude Code 或 Codex 对话框中，直接输入以下指令：

text

1
Install this skill for me: https://github.com/Vincentwei1021/video-shotcraft

AI 助手会自动克隆仓库并将其链接到正确的技能目录。

方式二：使用技能 CLI 安装

如果你偏好命令行，可以使用 skills CLI 进行安装：

1
npx skills add Vincentwei1021/video-shotcraft

方式三：手动克隆与链接

  1. 克隆仓库到你的本地开发目录：

    1
    2
    git clone https://github.com/Vincentwei1021/video-shotcraft.git
    cd video-shotcraft

  2. 链接到 AI 助手的技能目录（根据你的工具选择其一）：

    • 对于 Claude Code：

      1
      ln -s "$(pwd)" ~/.claude/skills/video-shotcraft

    • 对于 Codex：

      1
      ln -s "$(pwd)" ~/.codex/skills/video-shotcraft

说明：技能安装后，其核心文件位于 video-shotcraft/ 目录下。SKILL.md 是代理的入口文件，references/ 包含所有镜头卡片和制作流程文档，template/ 是完整的视频模板。

第三步：首次使用与视频生成

安装完成后，你就可以通过自然语言指挥 AI 为你生成视频了。

1. 基础用法：使用内置模板

最简单的方式是使用项目自带的 “Ink Press” 视频模板。这是一个经过验证的、完整的宣传片模板（36.2秒，10个镜头）。

在你的 AI 助手中，输入类似以下的指令：

text

1
Use video-shotcraft to make a promo for my product with the Ink Press template.

AI 会引导你提供产品相关信息（如截图、文案、品牌色等），然后自动替换模板内容并开始渲染。

2. 进阶用法：指定镜头卡片

你可以更精确地控制视频内容，指定使用哪些镜头卡片：

text

1
2
Use video-shotcraft to create a promo for my desktop app.
Use the deck-deal-flyin and row-embed shot cards to present these features.

如果不指定，技能会先介绍内置模板并询问你的选择。

3. 查看所有可用镜头

你可以浏览项目自带的 在线画廊 (Gallery) 来查看所有 157 种镜头卡片及其动态预览，找到你喜欢的风格，然后告诉 AI 使用它。

第四步：在无图形界面服务器（Headless）上渲染

如果需要在没有图形界面的 Linux 服务器上进行渲染（例如 CI/CD 环境），需要注意以下三个关键参数，否则渲染可能失败：

  1. 限制并发数：低核心机器需要添加 --concurrency=1 参数。
  2. 使用 headless-shell 浏览器：高版本 Chrome 移除了旧版 headless 模式，需要指定使用 chrome-headless-shell。
  3. 指定浏览器路径：如果自动下载被拦截，可手动指定本地二进制文件路径。

完整的渲染命令示例：

1
npx remotion render --concurrency=1 --browser-executable=/path/to/chrome-headless-shell Shell ./template/index.tsx

第五步：项目结构与关键文件一览

了解项目结构能帮助你更高效地使用和定制。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
video-shotcraft/
├── SKILL.md                 # 【核心】AI 代理的入口指令和生产规则
├── references/              # 【知识库】所有制作文档和镜头卡片
│   ├── pipeline.md          # 端到端视频制作工作流
│   ├── shots/               # 157 张镜头卡片（按功能分类）
│   ├── aesthetic-rules.md   # 视觉质量审查标准
│   └── jianying-export.md   # 【新功能】导出到剪映专业版的指南
├── demos/                   # 每个镜头卡片的 Remotion 参考实现代码
├── gallery/                 # 静态画廊页面，用于预览所有镜头
├── template/                # 可直接运行的完整视频模板 (Ink Press)
├── jianying-export/         # 【新功能】剪映工程文件导出工具 (macOS已验证)
└── assets/
    ├── lib/                 # 可复用的 Remotion 组件
    ├── scripts/             # 页面截图捕获脚本
    └── audio/               # 背景音乐 (BGM) 和 音效 (SFX)

第六步：常见问题与高级技巧

1. 如何替换产品素材？

视频模板中的截图是演示用的。你需要准备自己产品的实际截图，并按照 references/pipeline.md 中的指引，替换 assets/ 下的对应文件或通过 AI 指令完成替换。

2. 如何添加自定义镜头？

参考 references/shots/ 下现有卡片的格式，编写一个新的 Markdown 卡片，并在 demos/ 下实现对应的 Remotion 组件。然后通过 AI 指令告知技能使用新卡片。

3. 渲染遇到内存或超时问题？

  • 可以尝试在 template/package.json 中调整 --concurrency 和 --timeout 参数。
  • 对于大型项目，考虑分段渲染。

4. 导出到剪映专业版（JianYing Pro）继续编辑？

视频渲染完成后，技能支持导出为剪映工程文件（.draft）：

  1. 确保视频已渲染完成。

  2. 在你的请求中提及导出剪映工程，例如：

    “把这个视频导出为 JianYing draft”

  3. 技能会生成 .draft 文件夹，在剪映专业版中导入即可进行剪辑、调色、字幕修改等。

总结

通过本教程，你已经成功安装了 video-shotcraft 技能，并了解了如何通过 AI 助手生成电影级产品视频。它的核心流程是：

  1. 安装：通过自然语言或 CLI 将技能添加到你的 AI 编程助手。
  2. 指挥：用自然语言描述你的视频需求（使用模板、指定镜头、描述风格）。
  3. 迭代：AI 助手会根据内置的镜头卡片、制作流程和视觉规范，完成故事板、动画、音效设计和渲染。
  4. 交付：获得最终视频文件，或导出到剪映等专业工具进行二次编辑。

这是一个将 AI 创意与代码实现深度结合的工具，适合快速制作营销、启动和产品演示视频。更多细节和高级用法，强烈建议浏览其项目中的 SKILL.md 和 references/ 目录下的完整文档。