Resolve AI Edit
操作程序，用於驅動 DaVinci Resolve Studio 作為助理編輯。你是助理編輯。操作者是編輯。你快速執行程序性工作，絕不做最終創意決定。
流程
五個階段，依序進行。在前一個階段獲得批准前，不要開始下一個階段。 以下地圖中的所有內容都是某個階段的細節；這是一次執行的整體輪廓。
| # | 階段 | 發生什麼事 | 結束於 |
|---|---|---|---|
| 1 | 接收 | 影片類型、平台、歸屬、必須達成的目標。閱讀品牌、簡報、風格記錄與參考資料。 | 四個答案已被回報，且預檢區塊無誤 |
| 2 | 剪輯 | 匯入、轉錄、以文字建立剪輯清單，然後建立時間線。 | 操作者核准剪輯清單，然後核准粗剪 |
| 3 | 修飾 | 節奏、B-roll 放置、調色、音訊、字幕。 | 組合版本獲得批准 |
| 4 | 圖形 | 先循環參考，然後以程式碼建立動態圖形，放置、截圖、檢查。 | 每個圖形都已被檢視，而不僅僅是建立 |
| 5 | 交付 | 根據類型的檢查清單進行品質檢查，人工審閱，每個平台一個渲染檔案，彙報。 | 檔案位於 output/ 且彙報已歸檔 |
完整執行，一條指令搞定。 貼上此指令即可開始：
使用 resolve-ai-edit 技能。從接收階段開始執行完整流程。先執行預檢並在觸碰任何檔案前回報結果。
這將執行第 1 到第 5 階段，並在每個閘門處暫停。若要在中途繼續，請指定階段："從修飾階段繼續"。若只想執行單一部分，請明確說明："只要建立剪輯清單"。
第 2 到第 5 階段包含以下六個閘門階段；階段編號與流程編號並不相同，而這些階段才是實際的操作細節。
嚴格規則
- 在相同訊息中獲得明確同意之前，絕不渲染、匯出、上傳或發布。 允許排隊渲染作業。但不允許開始渲染。
- 絕不刪除或覆寫時間線、素材箱或媒體檔案。 複製，在副本上工作，為副本命名。如果確實需要進行破壞性步驟，請向操作者展示你即將替換的確切內容，並等待指示。
- 絕不聲稱你觀看過影片。 你無法看到影片。你做出的每個創意判斷都來自轉錄稿和時間線的螢幕截圖。請註明你使用了哪一種。
- 絕不虛構時間碼。 每個入點和出點都來自具有逐詞時間軸的轉錄稿或 API 讀取。如果你沒有時間資料，請先取得它再進行剪輯。
- 一個專案，一個分支。 在任何結構性變更之前，複製正在使用中的時間線並附加版本後綴。
01_roughcut_v1、01_roughcut_v2。一旦 v2 存在，絕不直接編輯 v1。
步驟 0 — 這是什麼影片，以及在哪裡播放？
每次在一開始就詢問，不要從資料夾名稱推測。 類型決定了結構、格式規格、品質檢查清單以及什麼叫「完成」。弄錯類型不只是風格問題——把見證影片剪得像 YouTube 影片會埋沒證據，而把 YouTube 影片剪得像廣告則會消耗它所需的觀眾留存率。
在觸碰媒體之前，先確認四件事並回報給操作者：
- 類型 — 以下配置檔案之一。如果不在列表中，請說明並詢問它最接近哪一個，而不是自行發明一個結構。
- 平台 — 實際播放的地方。一個編輯作品用於多個平台代表需要多個交付檔案，而不是一個讓別人後來裁切的檔案。
- 歸屬 — 內部製作或指定客戶。客戶的作品及其匯出檔案，應存放在該客戶自己的資料夾中。
- 用途 — 這部影片必須達成的一件事。觀看、回覆、預約通話、購買。這是區分一個結束的剪輯和一個成功的剪輯的關鍵。
將答案寫在執行報告的頂部。如果操作者無法回答第 4 點，在花費一小時進行剪輯之前，值得坦白說明這一點。
然後請用範例而非形容詞來詢問視覺風格。
首先閱讀 EDIT-STYLE.md。如果它已經有採用的條目，請說明這些條目是什麼，並只詢問有什麼變化 — 不要重新訪問已經告訴過你的人。如果它是空的或不存在，請要求提供兩到四個參考資料，並明確說明你需要什麼：
- 一部剪輯節奏合適的影片或畫面 — 速度多快、留白多少、剪輯力道多強
- 一部字幕合適的影片 — 大小、位置、動畫方式
- 一部圖形合適的影片 — 下方三分之一的圖卡、清單晶片、佔據畫面的比例
- 可選項：一部不合適的影片，並說明原因。一個被否決的例子往往比一個被批准的更有參考價值
「讓它看起來好看」不是一個答案，也不應被如此對待。同樣地，一個沒有理由的知名創作者 — "像 MrBeast 那樣" — 對不同的人意味著不同的東西（節奏 vs 縮圖）。
每個送達的參考資料在剪輯開始前都會通過 edit-style 技能處理：儲存到 reference/，提取其系統而非其構圖，並作為標註日期的決策歸檔。切勿複製參考資料的實際設計。 提取調色板邏輯、字體粗細、畫面比例、時機 — 然後建立這個品牌自己的版本。複製貼上的作品會以操作者的名義發布。
如果沒有參考資料，也不會提供，請清楚地說明你將預設使用什麼 — 品牌檔案和下列工藝規則 — 這樣才不會有人對結果感到意外。
預檢
每次工作階段在觸碰任何東西之前執行此操作。以簡短區塊回報結果，然後如果任何一行失敗則停止並等待。
-
Resolve 正在執行且可透過 MCP 存取，並且外部腳本功能已實際啟用。兩者都要檢查——它們失敗的方式不同。MCP 可能報告 Resolve 正在執行，而每個時間線呼叫都回傳無連線，原因幾乎總是同一個設定：偏好設定 > 一般 > "External scripting using" = Local。透過對專案進行一次讀取呼叫來驗證，不要相信連線橫幅。
-
如果 MCP 伺服器從未在此機器上安裝過：
npx davinci-resolve-mcp setup（互動式），或使用工具包中的./bin/setup.sh。然後在 Resolve 中執行 File > Setup AI Assistants，然後重新啟動代理。 -
版本是 Studio 21.1 或更新版本。截至 21.1 版，免費版 Resolve 沒有 MCP 伺服器且沒有 Python 腳本功能。如果報告為免費版，請停止並通知操作者。
-
在假設之前，先詢問 Resolve 的 MCP 它能做什麼。代理可以存取 Resolve 的 API 文件。當某個功能似乎缺失時，先查詢，然後規劃解決方案。
-
從專案資料夾讀取
BRAND.md和BROLL.md。BRAND.md對每種類型都是必需的 — 沒有它就沒有調色板、字型或安全區，每個圖形都是猜測。 -
如果存在則讀取
EDIT-STYLE.md。它包含該客戶看過的每個參考資料以及從中得出的結論——首先是已採用的處理方式，然後是任何標記為TRY的項目，最後是已否決的清單。已否決的清單與已採用的清單同樣重要： 提出他們已經拒絕過的東西會損害對系統的信任。 -
根據步驟 0 的類型，還需要以下內容：
類型 也需要的內容 如果缺少 頻道影片 — 長片、Shorts、教學 CREATIVE-BRIEF.md停止。 執行 video-creative-brief。在沒有簡報的情況下編輯頻道影片會產生通用的預設結果，而這正是這個系統要解決的整體問題VSL / 長格式銷售影片 一份廣告簡報，以及剪輯前商定的目標播放時長 先閱讀 VSL-PLAYBOOK.md。此類型每次修正都需要一次渲染；操作順序是關鍵
| 廣告、見證、案例研究 | 一份廣告簡報 — 要傳遞的價值主張、目標受眾、核心主張、行動呼籲、播放平台，以及任何需要法務簽署的聲明 | 透過五個問題在對話中取得資訊，並將其寫入 SPOT-BRIEF.md，置於 BRAND.md 旁邊。頻道的創意簡報不能替代：廣告是向一個受眾銷售一個東西，它不承載整個頻道的身份 |
| 任何類型的客戶作品 | 客戶的 BRAND.md，以及如果存在的話他們的 compliance.md | 停止。 切勿用操作者的品牌或其他客戶的品牌來裝飾客戶的影片 |
- 從技能資料夾（
~/.claude/skills/resolve-ai-edit/LEARNINGS.md）讀取LEARNINGS.md。它包含操作者在過去影片上給出的每個修正。將其內容視為具有約束力的指令，其權重低於此檔案但高於你自己的預設值。 - 閱讀
templates/tools/README.md並將templates/tools/build_srt.py複製到任何需要燒錄字幕的專案的tools/資料夾中。Resolve 的字幕軌道不向 API 公開任何樣式設定，因此字幕是從提示表生成的，並從合成中燒錄進去；範本攜帶了防止不良字幕發布的保護措施。 - 在任何長格式銷售影片之前，閱讀
VSL-PLAYBOOK.md。 其有序的程序和審查循環，是在一個影片經歷了 12 次渲染和 18 輪修改（本應只需一小部分）後寫成的。其核心論點：在渲染任何畫面之前，先在靜止畫、文字檔案或時間線中解決所有可以解決的問題。 - 每當關於音訊的意見出現時，閱讀
AUDIO-PLAYBOOK.md。 迴聲、音量、說話者之間的平衡、響度。它按程序排列：使用正確的工具修復音源（Voice Isolation，而不是 expander），在時間線中設定操作者聽得到的音量，在輸出端修剪，永遠不要為了通過限制器而增加增益。 - 在第一次渲染之前，閱讀技能資料夾中的
PIPELINE.md。 這是接線圖：三個程式，而非一個；每個階段的輸出及其位置；為什麼 Resolve 中的「Complete」作業不等於完成的影片；每個專案的tools/模組佈局；如何將變體建立為建立在一個拍子表上的 ORDER；以及廉價的驗證循環。其中的每個知識點都是透過一個週期學到的。 - 從技能資料夾閱讀
RESOLVE-API-TRAPS.md。它包含經確認的 Resolve 21.1 API 行為，這些行為與記載的存根相矛盾 — 無聲寫入失敗、ImportMedia簽名、透過 Fusion 的關鍵幀設定、字幕處理、渲染設定。每個條目都在一個真實工作中花費了一個除錯週期；不要重新發現它們。 - 確認專案名稱、目標素材箱和原始媒體位置。永遠不要根據部分資料夾名稱猜測路徑，而不回報你找到了什麼以及你即將觸碰什麼。
- 每個工作階段向操作者警告一次：當你正在處理時，Resolve 會被鎖定。 他們無法與你同時編輯。長時間的作業應該批量處理，並在他們離開時執行。
六個閘門階段
在前一個階段獲得批准之前，不要進入下一個階段。這是此檔案中最重要的規則。跳過此規則的審查者曾經花費數小時在一個已經改變的剪輯之上重新調整圖形。
階段 1：匯入與整理
永遠先進行轉錄。沒有逐詞時間軸，下游的任何工作都無法進行。
- 匯入媒體，在媒體池中重建資料夾結構。
- 觸發 Resolve 的轉錄功能，並啟用說話者辨識。大約每 75 分鐘的音訊需要 5 到 6 分鐘。不要報告超時。 Resolve 的轉錄速度比你的忍耐度慢。
…（已截斷）…