Communitygithub.com

alyssasworld/edit-twin-mcp

使用 Edit Twin MCP 对 Final Cut Pro 中打开的项目进行粗剪——重拍、嗯/呃、停顿,以及你保存的外观和声音——适配短视频/竖屏或横屏 Vlog。

edit-twin-mcp 是什么?

该技能通过 Edit Twin MCP 工具集,在 Final Cut Pro 中自动完成视频粗剪,同时严格保护原始项目。它首先获取用户保存的风格偏好(停顿设置、音频链、默认外观等),然后导出项目并分析时间线。技能会识别重拍、重复和填充词(如“嗯”“呃”),根据清晰度和自然度选择保留最佳片段;对于停顿,它根据输出格式(竖屏短视频或横屏 Vlog)使用不同的检测参数,并在静音剪辑时保留 B-roll、风景和音乐片段。在获得用户批准后,它执行剪切、应用外观和音频样式,最后将结果作为新项目导入 Final Cut Pro。该技能适用于 Final Cut Pro,支持 Claude Code,并包含 macOS 权限问题的处理指导。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/alyssasworld/edit-twin-mcp/tree/HEAD/skills/edit-twin-rough-cut

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

使用 Edit Twin 进行粗剪

使用 edit-twin MCP 工具。用户的原始项目永远不会被修改:结果将作为新项目导入到其旁边。时间以当前时间线上的秒数为单位。剪辑引用(如“4”表示故事线剪辑,“4.0”表示连接项目)每次编辑后都会发生变化,因此在使用引用前请重新读取 get_timeline。

1. 获取项目及用户风格

  1. get_style:已保存的默认设置(停顿设置、音频链、默认外观、从其编辑中学到的笔记)。遵循笔记。
  2. fcp_export_project。如果它警告项目为空,请让用户在 Final Cut 的浏览器中选择正确的项目(或点击其时间线)并重试。如果导出失败,请让他们使用“文件”>“导出 XML…”并给你路径,或使用 find_fcpxml_files + open_timeline。
  3. get_timeline,然后根据 summary.format(宽度/高度)和时长决定格式,除非用户已指定:
    • 短视频 / 竖屏:垂直(高度 > 宽度),或时长约 3 分钟以下。
    • Vlog / 横屏:水平,或包含 B-roll、风景、音乐或氛围时刻的较长片段。 用一句话告诉用户你选择的格式。

2. 分析(先不改变任何内容)

  1. transcribe,将 vocabulary 设置为视频中可能出现的人名和术语。
  2. find_repeats:口吃、重拍和“嗯”“呃”填充词。对于每个重拍,比较各个版本并做出选择。保留表达更清晰、没有结巴且结尾干净的那个;如果质量相同,保留后面的版本。移除重拍时,如果保留版本开头的连接词(如“然后”“所以”)不再读起来自然,也一并删除。
  3. 停顿,取决于格式:
    • 短视频:find_silences 使用已保存的默认设置。
    • Vlog:find_silences 使用更宽松的覆盖参数(min_silence 0.6,keep_after_speech 0.15,keep_before_speech 0.15),并且只在说话部分内(转录文字之间)提议停顿。切勿剪切属于 B-roll、风景、音乐或反应镜头的静音段落;不确定时使用 get_timeline 和 preview_frame。
  4. 停下来展示一个简短的计划:重拍(引用两个版本,说明你将保留哪一个及原因)、填充词数量、停顿数量及其累计秒数,以及预计的新长度。等待用户的同意或修改指示。

3. 剪切(获得批准后)

  1. cut_ranges 用于已批准的重拍和填充词。
  2. 短视频:remove_silences 使用已保存的默认设置。Vlog:cut_ranges 仅用于已批准的停顿范围。
  3. 短视频:检查前约 3 秒是否能作为钩子起效,即开头的话语是否陈述了主题或一个令人惊讶的主张。如果后面有更强的钩子句,建议使用它,但未经询问不要移动。如果短视频超过 90 秒,则标记出来。

4. 外观和声音

  1. 如果存在带效果的调节剪辑,运行 fit_to_timeline。否则,如果风格有默认外观,运行 apply_look。
  2. 如果风格有音频链,运行 apply_audio_style。如果没有,运行 measure_loudness 并建议增益(社交视频通常约为 -14 LUFS),或提供 normalize_audio。
  3. 除非被要求,否则不要碰音乐和连接的音频。

5. 检查并发送

  1. validate_timeline,然后 render_preview。告诉用户预览的位置和新时长。
  2. send_to_final_cut,项目名称为“<原始名称> (粗剪)”。
  3. 用几行总结:剪切了哪些内容(重拍、填充词、停顿、节省的秒数)以及应用的外观和声音。
  4. 最后建议,如果他们手动精修编辑,可以要求 Claude 进行 learn_from_edit(设置 save=true 和 look_name),以便下一次粗剪符合其风格。对于在短视频之后制作的首个 Vlog,以 save=false 运行,并用 update_style add_note 记录建议的 Vlog 停顿设置,以免覆盖短视频的默认设置。

规则

  • 在步骤 2.4 用户批准计划之前,永远不要更改任何内容。
  • 永远不要编辑他们的原始项目;始终发送一个新项目。
  • 外部硬盘上的媒体必须已插入。
  • 如果某个工具因 macOS 权限失败,请引导他们前往“系统设置”>“隐私与安全性”(辅助功能,以及运行 Claude Code 的应用程序的自动化)。

相关技能