Communitygithub.com

/edit — 在編輯程式中將片段剪輯成影片

根據 config.json 中的編輯器設定(`editor.id`),在指定程式中將片段剪輯成最終影片。支援 DaVinci Resolve、Premiere Pro 等專業編輯軟體,或使用 ffmpeg 自行剪輯。

edit — 在編輯程式中將片段剪輯成影片 是什麼?

這個技能負責將已產生的影片片段組合成最終作品,並在作者指定的編輯程式中進行後續處理。它會讀取 `config.json` 中的 `editor` 設定,決定剪輯方式:若設為 `none`,則完全由 AI 使用 ffmpeg 獨立完成(等同於 `assemble` 技能);若設為具體程式名稱(如 `davinci_resolve`),則會利用 MCP 進行精確操作,並搭配電腦使用(computer use)進行螢幕驗證。 在混合模式下,MCP 負責重複性高的精確工作(如建立專案、導入片段、設定時間軸),而電腦使用則用於視覺確認(如檢查片段接合處、音訊儀表)、處理 MCP 不支援的對話框或拖曳操作。技能要求先確認 MCP 伺服器是否可連線、編輯程式是否已開啟,並**明確請求許可**後才操控使用者的滑鼠與鍵盤。 它支援多種編輯軟體,包括 DaVinci Resolve(需 Studio 版以支援腳本 API)、Premiere Pro、Final Cut Pro、CapCut 等。針對無法控制的編輯器,技能會產生 CMX 3600 EDL 檔案供匯入,並同時透過 `assemble` 技能產出 H.264 影片。關鍵限制是:**絕不產生媒體素材、也不添加音樂**——配樂必須由作者自行放入 `assets/audio/music/` 資料夾。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bidah/storyseam/tree/HEAD/.claude/skills/edit

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

/edit — 剪輯片段 → 影片,在故事指定的程式中完成

影片將在作者後續會繼續編輯的程式中完成剪輯。config.json 中的 editor 設定指定編輯器:

"editor": { "id": "davinci_resolve", "mcp": true, "computer_use": true }
鍵意義
idnone — 你自行使用 ffmpeg 剪輯。或是程式名稱:davinci_resolve、premiere_pro、final_cut_pro、capcut,或作者指定的其他名稱。
mcptrue 表示該程式的 MCP 伺服器已安裝並連接到你的客戶端。
computer_usetrue 表示你可以操控螢幕(Claude 的 computer use,或你工具的同等功能)。
notes選填自由文字:程式的版本、版本類型、專案位置。

沒有 editor 鍵等同於 { "id": "none" }。

步驟 0 — 驗證所有片段(每個路徑)

無論使用哪個編輯器,都先執行 assemble 技能的步驟 1:每個區塊都有對應的片段,依序排列,且為其實際時長。建立在缺失區塊上的剪輯,就像一部有洞的影片。

路徑 A — editor.id: "none":你就是剪輯師

遵循 assemble 技能。輸出為 renders/final/film.mp4。這就是整個階段的結果。

路徑 B — 指定程式:在程式中編輯

B1. 檢查你可使用的資源,然後告知作者

在動手之前,先確認 config.json 中的設定是否正確:

  • MCP: 呼叫該程式伺服器上的一個唯讀工具(對於 DaVinci Resolve,可列出專案或時間軸)。如果失敗,則輸出 config.json 中 mcp_servers 的安裝指令(npx storyseam mcp --agent <yours>;對於 Resolve,使用 npx davinci-resolve-mcp setup),然後等待。僅在作者確認該伺服器不應存在後,才將 editor.mcp 設為 false。切勿自行安裝。
  • 電腦使用: 擷取一張螢幕截圖,確認該程式已開啟,或可以開啟。

然後用一句話告訴作者你將使用哪種模式工作,並在操控螢幕前請求許可:電腦使用會移動他們的滑鼠和鍵盤。

B2. 同時使用 MCP 和電腦使用

單獨使用其中一種都不足夠,而最佳結果來自於每個步驟都結合兩者:

  • MCP 負責精確、可重複的工作: 以故事的解析度和幀率建立專案和時間軸,依區塊順序匯入 renders/clips/block_NN.mp4,將每個片段依序放置於 V1/A1 軌道上,根據 shotlist/shotlist.json 為每個區塊添加標記,設定渲染設定並開始渲染。確保數值精確、無誤點擊。
  • 電腦使用是你的眼睛,也是處理 API 無法觸及之處的雙手: 在每個 MCP 步驟後截圖,確認其操作是否如報告所述;在檢視器中逐格檢查每個接合處兩側的畫格;檢查音訊儀表;處理 MCP 未暴露的任何對話框、面板、拖曳動作或設定。
  • 切勿相信未經你目視確認的 MCP 成功訊息。 以錯誤幀率匯入的片段、錯誤解析度的時間軸、或空的渲染隊列,都會回報成功。

當只有一種資源可用時:

mcpcomputer_use工作方式
truetrue兩者並用,如上所述。預設且最佳模式。
truefalse僅使用 MCP。告知作者剪輯未經目視驗證,請他們自行檢查接合處。
falsetrue僅使用電腦使用。速度較慢,請告知作者,並以小步驟進行,每一步後都截圖。
falsefalse你無法驅動該程式。產生 renders/edit/timeline.edl(CMX 3600 格式,根據 shotlist.json 和片段實際時長,按順序每個區塊一個事件),告訴作者如何匯入該檔案,並同時透過 assemble 技能產出 renders/final/film.mp4,確保無論如何都有一份影片。

B3. 編輯作業

  1. 專案名稱使用 storyseam.md 中的 title,解析度和幀率使用片段的實際值(使用 ffprobe 檢查一個片段即可,請勿假設)。
  2. 一個時間軸。區塊依序放置在 V1 軌道,其音訊放置在 A1 軌道,無間隙、無重疊。
  3. 每個區塊一個標記,名稱使用該區塊的 ID 和第一個鏡頭。
  4. 保留一條空的音樂軌道(A2)給作者使用。切勿添加音樂。 配樂是作者的工作,應放入 assets/audio/music/。
  5. 渲染輸出至 renders/final/film.mp4(H.264、AAC、時間軸解析度),並將程式本身的專案檔案儲存在其預設位置。將該路徑記錄在 editor.notes 中。

B4. 各程式注意事項

  • DaVinci Resolve。 其 MCP 伺服器驅動 Resolve 的腳本 API。外部腳本僅限 Studio 版;在免費版中,應用程式內的橋接功能(工作區 › 腳本)是唯一途徑,而在免費的 21.1+ 版本中,Python 腳本功能已被移除,因此預期在此情況下需依賴電腦使用。使用「剪輯」頁面操作時間軸,使用「交付」頁面進行渲染;在開始渲染前,務必透過螢幕截圖確認渲染佇列。
  • 任何其他程式。 先尋找其 MCP 伺服器。如果沒有,則對應上述 mcp: false 的處理方式。請勿自行安裝軟體、外掛或 MCP 伺服器;告知作者什麼資源會有幫助,讓他們自行處理。

最後一步 — 回報

回報內容包括:影片的路徑、實際播放時間和解析度、程式的專案檔案、你使用的工作模式(MCP + 電腦使用、僅其一、或 EDL)、任何你未能目視確認的事項,以及「刻意未添加音樂」的說明。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相關技能