Communitygithub.com

alyssasworld/edit-twin-mcp

在 Final Cut Pro 中對開啟的專案進行粗剪 — 包括重拍、嗯/呃、停頓,以及您儲存的外觀與音效 — 並適應 Reels/Shorts 或橫式 Vlog。

edit-twin-mcp 是什麼?

這個技能讓 AI 代理(如 Claude Code)可以透過 Edit Twin MCP 工具,在 Final Cut Pro 中直接對專案進行粗剪。它專注於自動化常見的影片修剪任務:移除重拍、填充詞(嗯、呃)以及過長的停頓,並根據目標格式(直式短影音如 Reels/Shorts,或橫式 Vlog)調整剪輯策略。使用者儲存的個人風格偏好(停頓設定、音訊鏈、預設外觀與編輯筆記)會被套用,確保每次粗剪都符合個人習慣。重要的是,原始專案絕不會被修改;所有編輯都會匯入為一個新的專案,並以「(粗剪)」後綴命名。此技能支援 macOS 上的 Final Cut Pro,並需要透過 MCP 工具與外部儲存裝置正確連接。

相容平台✓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 工具。使用者的原始專案絕不會被修改:結果會作為一個 NEW 專案匯入其旁。時間單位為目前時間軸上的秒數。類似「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(寬/高)與持續時間決定格式,除非使用者已指定:
    • Reel / short:垂直(高度 > 寬度),或約 3 分鐘以下。
    • Vlog / landscape:水平,或較長的影片(包含 B-roll、風景、音樂或氛圍時刻)。 用一行話告訴使用者您選擇了哪種格式。

2. 分析(目前不更改任何內容)

  1. transcribe,並將 vocabulary 設為影片中可能出現的名字與行話。
  2. find_repeats:結巴、重拍與嗯/呃填充詞。對於每個重拍,比較各個 take 並做出選擇。保留表達更清晰、沒有失誤且結尾乾淨的 take;如果兩者相同,則保留較晚的 take。移除重拍時,如果保留的 take 開頭的殘留連接詞(「然後」、「所以」)不再自然,也一併刪除。
  3. 根據格式決定停頓處理:
    • Reel:使用已儲存的預設值執行 find_silences。
    • Vlog:使用較寬鬆的覆寫值(min_silence 0.6,keep_after_speech 0.15,keep_before_speech 0.15)執行 find_silences,並且只建議對話段落內(轉錄文字之間)的停頓。絕不剪掉屬於 B-roll、風景、音樂或反應鏡頭的靜默片段;如有疑問,請使用 get_timeline 與 preview_frame。
  4. 停下來並顯示一個簡短計畫:重拍(引用兩個 take,說明您將保留哪個及其原因)、填充詞數量、停頓數量及其總計秒數,以及預期的新長度。等待使用者的確認或修改。

3. 剪輯(獲得批准後)

  1. cut_ranges:針對已批准的重拍與填充詞。
  2. Reels:使用已儲存的預設值執行 remove_silences。Vlogs:使用 cut_ranges,僅針對已批准的停頓範圍。
  3. Reels:檢查前 3 秒左右是否作為鉤子有效運作,即第一句話是否陳述主題或提出驚人主張。如果稍後有更強的鉤子台詞,請提出建議,但未經詢問不要移動它。如果 Reel 超過 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,專案名稱為「<原始名稱> (rough cut)」。
  3. 用幾行總結:剪掉了什麼(重拍、填充詞、停頓、節省的秒數)以及套用的外觀與音效。
  4. 最後建議,如果他們手動潤飾編輯,請要求 Claude 執行 learn_from_edit(使用 save=true 與 look_name),以便下一次粗剪符合他們的風格。對於 Reels 之後的第一個 Vlog,請使用 save=false 執行它,並使用 update_style add_note 記錄建議的 Vlog 停頓設定,這樣就不會覆寫 Reel 的預設值。

規則

  • 在使用者批准步驟 2.4 的計畫之前,絕不更改任何內容。
  • 絕不編輯他們的原始專案;總是傳送一個新專案。
  • 外部磁碟上的媒體必須已插入。
  • 如果工具因 macOS 權限而失敗,請指引他們前往「系統設定 > 隱私權與安全性」(輔助使用,以及執行 Claude Code 的 App 的自動化)。

相關技能