/edit — 剪輯片段 → 影片,在故事指定的程式中完成
影片將在作者後續會繼續編輯的程式中完成剪輯。config.json 中的 editor 設定指定編輯器:
"editor": { "id": "davinci_resolve", "mcp": true, "computer_use": true }
| 鍵 | 意義 |
|---|---|
id | none — 你自行使用 ffmpeg 剪輯。或是程式名稱:davinci_resolve、premiere_pro、final_cut_pro、capcut,或作者指定的其他名稱。 |
mcp | true 表示該程式的 MCP 伺服器已安裝並連接到你的客戶端。 |
computer_use | true 表示你可以操控螢幕(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 成功訊息。 以錯誤幀率匯入的片段、錯誤解析度的時間軸、或空的渲染隊列,都會回報成功。
當只有一種資源可用時:
mcp | computer_use | 工作方式 |
|---|---|---|
| true | true | 兩者並用,如上所述。預設且最佳模式。 |
| true | false | 僅使用 MCP。告知作者剪輯未經目視驗證,請他們自行檢查接合處。 |
| false | true | 僅使用電腦使用。速度較慢,請告知作者,並以小步驟進行,每一步後都截圖。 |
| false | false | 你無法驅動該程式。產生 renders/edit/timeline.edl(CMX 3600 格式,根據 shotlist.json 和片段實際時長,按順序每個區塊一個事件),告訴作者如何匯入該檔案,並同時透過 assemble 技能產出 renders/final/film.mp4,確保無論如何都有一份影片。 |
B3. 編輯作業
- 專案名稱使用
storyseam.md中的title,解析度和幀率使用片段的實際值(使用ffprobe檢查一個片段即可,請勿假設)。 - 一個時間軸。區塊依序放置在 V1 軌道,其音訊放置在 A1 軌道,無間隙、無重疊。
- 每個區塊一個標記,名稱使用該區塊的 ID 和第一個鏡頭。
- 保留一條空的音樂軌道(A2)給作者使用。切勿添加音樂。 配樂是作者的工作,應放入
assets/audio/music/。 - 渲染輸出至
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)、任何你未能目視確認的事項,以及「刻意未添加音樂」的說明。