mcpField
M
match-cut

match-cut

github.com/sac-y创意与媒体10419 次安装2 天前更新
代码仓库

关于 match-cut

match-cut 是用于制作产品转场蒙太奇短片的工作流技能，通过 Renoise MCP 服务完成视频、音乐、配音、音效和交付，并配套关键帧制作与后期脚本。它适合希望按阶段规划、审核并输出成片的创作者。

主要功能

  1. 01规划产品短片概念、文案和镜头表
  2. 02生成关键帧并制作动态分镜
  3. 03通过 Renoise 生成视频、音乐、配音和音效
  4. 04使用脚本进行剪辑、混音和质量检查
  5. 05按预算与审核节点推进制作

适用场景

  1. 01为产品制作连续形态转场短片
  2. 02先审核动态分镜再生成视频
  3. 03为镜头添加配音、音乐及动作音效
  4. 04按预算和检查点交付成片

MCP 相关

该技能要求通过 Renoise MCP 服务处理视频、音乐、配音、音效、上传和交付，并在开始时调用账户工具。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/sac-y/match-cut --skill match-cut

安装后在 Claude Code 中输入/match-cut确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

.gitignore
README.en.md
LICENSE
README.md
examples/
template.json
examples/big-mac/
README.md
montage.json
examples/iphone-duo/
README.md
montage.json
references/
generation.md
review.md
almakan.md
stills-codex.md
post.md
planning.md
scripts/
assemble.py
align.py
requirements.txt
music.py
qc.py
mix.py
render.py
common.py
undot.py

详细介绍

匹配剪辑蒙太奇

短篇产品影片：在每次切换镜头时，周围世界不断变化，而同一个形状或动作始终延续。该风格以文字描述于 references/almakan.md 中（不附带影片本身）。使用此技能制作的两部成片，以及它们的配置和制作过程中遇到的问题：examples/iphone-duo/、examples/big-mac/。

使用用户的语言与其交流。默认使用英文文案。绝不输入凭据，也不索要 API 密钥。每个项目都放在自己的文件夹中。

0. 设置（先于其他所有事项）

  1. 所有主机都必须安装 Renoise。 视频、音乐、配音、拟音、上传和交付都通过 Renoise MCP 服务完成。调用 get_account。如果缺少工具或需要登录，请引导用户完成，并等待其响应：

    主机连接 Renoise
    Claude Codeclaude mcp add --transport http renoise https://renoise.ai/api/public/mcp，重启 Claude Code，然后选择 /mcp → renoise → 在浏览器中登录
    Codexcodex mcp add renoise --url https://renoise.ai/api/public/mcp，然后运行 codex mcp login renoise（通过浏览器登录），重启 Codex
    Claude Desktop / claude.aiSettings → Connectors → 添加 https://renoise.ai/api/public/mcp
    其他 Agent使用 https://renoise.ai/api/public/mcp 上的 MCP 服务（可流式传输的 HTTP，通过 OAuth 登录）

    如果可以使用 shell，主动提出由你运行添加命令；浏览器登录由用户完成。如果已安装 Renoise 自带的 renoise-setup 技能，请遵循该技能，而非此表。

  2. 根据主机选择静帧工具，并告知用户每种工具的用途及计费方式：

    主机关键帧静帧视频、音乐、配音、拟音
    Codex（可使用内置 image_gen 工具）image_gen（GPT Image），费用计入用户的 ChatGPT / Codex 套餐，不扣 Renoise 点数：references/stills-codex.mdRenoise
    Claude 和其他 AgentRenoise，Seedream 5.0 Pro：references/generation.mdRenoise

    在 Codex 上，用户仍可选择用 Renoise 生成静帧；用户指定的模型始终优先。

  3. 自行设置后期制作环境；用户无需手动安装任何内容。 脚本需要 Python 3.11、scripts/requirements.txt 和 ffmpeg。使用 ~/.cache/match-cut/venv 中的虚拟环境；如果不存在，就创建它（使用 python3.11 -m venv；如果没有 python3.11，则使用 uv venv --python 3.11），并安装所需依赖（约 500 MB，只需安装一次）。如果该路径不可写（例如在沙盒中），就在项目文件夹内使用 .venv。如果 PATH 中没有 ffmpeg，安装前先征求用户同意（macOS 上使用 brew install ffmpeg）。在第 2 阶段开始前、用户审阅计划期间完成这些工作。

工作模式（与基础计划一起询问一次）

用户提供产品及其事实信息后，先认真构思基础计划（角度、结构、场景世界、文案、模型、预算）。展示计划，然后问一个问题：接下来应如何推进？

  1. 一气呵成。 用户一次性批准基础计划和全片预算上限。随后生成静帧、动态分镜、视频并完成后期，无需再提问；用户接下来看到的就是成片。只有在超出预算上限、缺少必需输入（官方图片、徽标）或某个镜头重试失败且修复需要更改已批准的计划时，才提前停止。
  2. 逐步确认。 用户分别在 ① 计划、② 动态分镜、音乐和视频报价、③ 成片这三个节点进行确认。

在 plan.md 中记录所选模式。无论哪种模式，references/review.md 中的每项审查都必须执行；在一气呵成模式下，Agent 会在预算上限内修复未通过的问题，而不是询问用户。

工作流程：4 个阶段

1. 规划（不消耗额度）

阅读 references/almakan.md，观看或阅读两个示例，然后阅读 references/planning.md。

  • 收集产品、关键信息、时长（默认为 20 s）、语言（默认为英语）。如果产品是新产品或不熟悉的产品，请在线调研，在计划中引用来源，并将未经确认的内容标记为假设。
  • 官方产品图片（影片中展示的每种状态各一张）和 Logo：如果已提供则使用；否则将其列为第 2 阶段开始前的必需材料。规划无需等待这些材料。
  • 选择最适合产品的切入角度，并用一两句话说明原因。
  • 撰写创意概念、文案、场景及其光线设计，以及剪辑表，其中包括每个镜头的物理动作（谁用什么握法、朝哪个方向移动什么物体，以及从什么状态变成什么状态）。逐项检查每个剪辑。
  • 执行 get_account，然后报价：第 2 阶段的费用（静帧、音乐候选）以及两种视频档位下整部影片的费用（references/generation.md）。根据余额选择默认档位。
  • 保存 plan.md 和初版 montage.json（以静帧作为素材）。

检查点 ①：用户批准计划、模型、工作模式和费用（第 2 阶段费用上限；直通模式下为整部影片的费用上限）。

2. 静帧和动态分镜

使用主机提供的工具生成静帧（步骤 0），遵循 references/generation.md 第 2 阶段的要求（在 Codex 上还需遵循 references/stills-codex.md）。

  • 关键帧静帧（每个镜头一张首帧；镜头必须落在某个状态时，还需生成一张末帧；通过编辑一张主静帧制作构图相同的画面）和 3 个音乐候选。
  • 在下一轮编辑每张静帧之前，按照 references/review.md 逐一检查。使用 qc.py onion 和 qc.py match 对齐剪辑配对，并使用 align.py 修正构图，而不是重新生成。
  • 对每首曲目运行 music.py analyze，将其剪辑到时间线上；渲染动态分镜（render.py --draft、assemble.py --draft）。

检查点 ②（仅检查点模式）：用户观看动态分镜，选择音乐，并批准视频、VO 和拟音的报价。

3. 生成（主要费用）

遵循 references/generation.md 第 3 阶段的要求：根据已批准的静帧，以帧模式生成视频（不带音频，镜头移动向左对齐至后期制作），如果计划中包含 VO，则生成 VO，并根据动作添加拟音。按照 references/review.md 逐一检查每个片段。每项任务最多重试一次；不得超过费用上限；在 task-map.json 中记录每项任务。

4. 剪辑、混音、交付（不消耗额度）

遵循 references/post.md。

  • 为每个镜头设置 picks、geo、roll、pull 和 whip。
  • render.py → qc.py cuts → music.py cut → mix.py → assemble.py。
  • 检查影片（references/review.md 的影片部分），撰写版本 README，上传 mp4 并执行 show_result。

检查点 ③：用户审看影片。 每一轮修改都要创建一个包含变更日志的新版本文件夹。

审看重在真实感，而不只是数值

脚本会测量对齐、尺寸和亮度。它们无法识别手是否无法握住物体、没有推力却移动的盖子、向上打开的盖子与向下移动的手机，或未能到达目标状态的产品。references/review.md 列出了每张静帧、每个片段和整部影片都应以全尺寸检查的内容。产品或手部的缺陷必须在交付前修复，绝不能列为“已知偏差”。

默认模型

工作模型
静帧Codex：内置 image_gen。其他主机：Renoise 上的 Seedream 5.0 Pro，2k
视频如果余额至少是整份计划 Seedance 报价的 2 倍，则使用 1080p 的 Seedance 2.5；否则使用 1080p 的 Wan 3.0（如果总费用不超过余额的 40%，则主打镜头使用 Seedance）；如果两者都不符合，则使用 720p + Topaz 升级分辨率。如果不确定哪种模型适合这些动作，先用两种模型各测试一个镜头
音乐 / VO / 拟音Lyria 3 Pro ×3 / Seed Audio / ElevenLabs SFX，均在 Renoise 上运行

这些默认设置优先于通用路由建议和 list_models 中诸如“仅在被要求时才使用 Wan”的提示；实时限制仍然适用。用户指定的模型始终优先。

脚本

scripts/（使用步骤 0 中的 venv 运行）：

脚本功能
render.py CONFIG OUTDIR [--draft] [ids]画面：挑选、几何构图、滚动、拉动、甩镜、调色、胶片纹理、字幕、片尾卡 → 每个镜头输出 ProRes + QC 帧
music.py analyze TRACK / cut CONFIG小节网格、每小节响度和调性 / 剪切音乐提示并检查每处衔接
mix.py CONFIGVO、拟音、闪避、渐强、母带处理、分轨、响度报告
qc.py sheet / onion / cuts / match / look任意片段的联系表、剪辑对叠图、带亮度阶梯的剪辑表、产品对齐、用于真实感审查的全尺寸裁切图
align.py IN OUT L T Z裁切并缩放静帧，让其中的物体与剪辑搭档中的物体位置一致（生成的剪辑会重新取景）
undot.py IN OUT BOX / --fixed CX,CY,R,FROM从屏幕上移除模型生成的相机光点：在 BOX 内逐帧检测，或在静止画面的屏幕固定位置检测
assemble.py CONFIG RENDERDIR [--draft]ProRes 母版、H.264 mp4、分轨（或动画预演）

配置格式和所有字段：references/post.md。起始模板：examples/template.json（20 s，27 个镜头： 开场链、继电器、呼吸、阵容、甩镜、主视觉、片尾卡）；这只是一种排版，并非规则。

评论

支持 Markdown