这个 Skill 的目标是让 Codex 像一个小型视频制片流程一样工作，将产品信息转化为带研究、分镜、配音、字幕和质检的成片。它的核心是建立一套完整的参考驱动视频生产工作流。

部署教程：reference-driven-cinematic-video-skill

1. 准备工作：核心依赖

在安装 Skill 之前，请确保你的系统已安装以下基础工具：

  • Python 3：脚本运行环境。
  • FFmpeg / ffprobe：用于视频分析、转码和质量检查。
  • Node.js：Codex 及其生态的依赖环境。
  • Git：用于克隆仓库。
  • Codex：该 Skill 的运行载体。安装方法可以参考相关指南。

在 Windows 上，需要将 FFmpeg 的 bin 目录添加到系统环境变量 PATH 中，才能在命令行中直接调用。

2. 安装 Skill

这个 Skill 本质上是 Codex 的“专项能力包”，需要将文件放置到 Codex 能够识别的位置。

  1. 克隆仓库：

    1
    2
    git clone https://github.com/siuserxiaowei/reference-driven-cinematic-video-skill.git
    cd reference-driven-cinematic-video-skill

  2. 同步到 Codex 技能目录：
    将 Skill 核心文件夹（reference-driven-cinematic-video）复制或同步到 Codex 的用户级技能目录。

    1
    2
    mkdir -p ~/.codex/skills
    rsync -a reference-driven-cinematic-video-skill/reference-driven-cinematic-video/ ~/.codex/skills/reference-driven-cinematic-video/

    除了用户级目录，Skills 也可以安装在仓库级 .codex/skills/，便于团队共享。

  3. 验证安装（可选）：
    运行验证脚本，确保 Skill 结构正确。

    1
    python3 ~/.codex/skills/.system/skill-creator/scripts/quick_validate.py ~/.codex/skills/reference-driven-cinematic-video

  4. 重启 Codex：新安装的 Skill 需要重启 Codex 才能生效。

3. 在 Codex 中使用 Skill

安装并重启后，就可以在对话中调用这个 Skill 了。有两种主要方式：

  • 显式调用：在提示词中直接提及 Skill 名称，例如 $reference-driven-cinematic-video。
  • 自动触发：Codex 会根据你的任务描述，匹配 Skill 的 description 来自动调用。

使用提示词示例（参考仓库 README）：

你可以根据需要，参考以下几种提示词模板来启动视频制作流程。

  • 柔和温暖风产品介绍片：

    用 $reference-driven-cinematic-video
    这是我的产品介绍：<产品文档链接>
    目标：30-40 秒产品介绍片，中文配音，偏柔和温暖风。
    配音要求：优先使用我提供的录音或我接入的配音 API。如果我没有提供，就使用默认中文神经音色。
    你自己搜索补全，最后给我成片。

  • 高级科技感产品发布片：

    用 $reference-driven-cinematic-video
    这是我的产品介绍：<产品文档、官网或功能说明>
    目标：30-40 秒产品介绍片，中文配音，高级科技感。画面希望有曲面屏、UI 宏观特写或代码流动效。
    请你搜索补全产品定位和用户痛点，写口播稿、分镜、字幕，并生成最终成片。

  • 带参考视频的风格复刻：

    用 $reference-driven-cinematic-video
    产品介绍：<产品说明或文档链接>
    参考视频：<本地视频路径或公开视频链接>
    目标：45 秒以内，中文配音，保留参考视频的节奏、镜头语言、字幕风格和转场感觉。
    请先分析参考视频，再生成我的产品成片。

4. 质量检查与交付

Skill 的核心要求之一是，在最终交付前必须通过质量检查。它自带了质检脚本 quality_check_video.py。

示例命令：

1
2
3
4
5
python3 reference-driven-cinematic-video/scripts/quality_check_video.py final.mp4 \
  --expect-audio \
  --expect-subtitles \
  --srt captions.srt \
  --min-score 80

该脚本会检查音视频流是否存在、音量、SRT 字幕、长黑屏/静音/冻帧等情况，并最终给出一个分数。低于 80 分的版本默认只能被称作草稿（draft），从而确保产出的基础质量。