电影感游戏混剪 Skill

从一次《使命召唤：无限战争》混剪及多轮修改中整理的可复用技能。覆盖素材定位、音乐踩点、原声混合、卡顿修剪、片头动画、奖项核实、封面设计与成片验收。

技能名：cinematic-game-montage。入口：SKILL.md。案例参数与通用流程分开保存，换游戏或音乐时不必复用旧时码。

使用

在安装后的 Codex 会话中调用：

使用 $cinematic-game-montage，把这些游戏素材配上这首音乐制作高燃混剪。
保留原始画幅，原声与音乐混合；先完整展示登机和起飞，再进入两段高潮，最后归航。

也可以仅修改已有工程的片头、延长一个动作、修剪录制卡顿，或制作匹配的视频封面。技能不会自带或下载游戏素材、商业音乐和字体。

安装与更新

Python 3.10 或更高版本：

python tools/install_skill.py

安装到 $CODEX_HOME/skills/cinematic-game-montage；未配置 CODEX_HOME 时使用 ~/.codex/skills/cinematic-game-montage。原位置已经存在时，默认拒绝覆盖。显式更新会把旧目录完整保存在相邻备份目录：

python tools/install_skill.py --update

本项目在本机创建时已执行安装。后续源代码以本仓库为准，修改后重新运行安装脚本。若当前会话未显示新技能，在新会话中调用。

随附内容

• skills/cinematic-game-montage/：可独立安装的技能、参考流程、模板与两个小工具。
• scripts/timeline.py（位于技能内）：有理数节拍网格、时间线校验、音画同源区间滤镜、椭圆侧弧坐标。
• scripts/media.py（位于技能内）：媒体探查、带时码联系表、疑似卡顿检测、逐帧解码验收。
• tests/：数学和输入校验测试，以及合成视频的修剪/音频同步集成测试。
• tools/install_skill.py：安装与保留旧版的更新工具。

工具是剪辑辅助件，不会自动判断一段 CG 是否精彩，也不包含通用 NLE 或一键成片模型。具体使用见 工具文档。

验证

只使用节拍、布局和时间线工具不需要第三方包。媒体工具及集成测试需要：

python -m pip install -r requirements.txt
python -m unittest discover -s tests -v
python tests/integration_media.py --ffmpeg "路径/ffmpeg.exe"

初始版本已通过 22 项测试和实际媒体修剪/变速测试，详见 验证记录。

FFmpeg 查找顺序为显式 --ffmpeg、FFMPEG_BINARY、PATH、已安装的 imageio_ffmpeg。没有 FFmpeg 时不会自动安装系统软件。代码通过参数数组调用进程，不拼接 shell 命令。

大型媒体、渲染缓存、虚拟环境、私有路径及本机字体不进入 Git。案例中的数值是一次制作的实测记录，不是所有新项目的默认值。奖项事实保留主办方来源，复用时重新核对。

目录结构与元数据参考 OpenAI 技能构建文档。当前技能安装目录遵循本机 skill-creator 的约定。