Remotion 影片製作
將原始素材轉換為連貫且可編輯的影片。使用 React 創作影片;從已儲存的媒體渲染輸出。請遵循以下階段,並根據使用者的指示及現有專案進行調整。保留一份簡短的生產紀錄,以便其他代理無需重新建構決策即可繼續進行。
1. 檢查簡報、資產與能力
確定目標觀眾、預期收穫、交付格式、調性以及可用的資產。區分原始事實、編輯詮釋及未解決的資訊;請勿憑空捏造缺少的事實步驟、能力或結果。在將文件讀入上下文之前,先提取大型內嵌資產。在生產專案中保留一份原始出處與場景的對應關係。
檢查相關的圖片與錄音,而不僅僅是檔名。注意實際可見的構圖、內嵌標籤、聲音與動作。確認此代理能否檢查圖片、聽取音訊、執行程式碼,並提供使用者可存取的預覽。缺少感知能力時,需使用 references/runtime.md 中的備援方案;腳本無法判斷這些模型能力或取代人類判斷。
對於現有的 Node 專案,可選擇性地執行 node <skill-dir>/scripts/doctor.mjs <project-dir>。此指令會盤點相依性,但無法證明可進行渲染。請使用專案的套件管理工具與 lockfile。若目前有可用的 Remotion 最佳實踐技能,則遵循該技能,否則請遵循官方文件。
2. 提出方向,並僅釐清有意義的不確定性
提供一個建議的方向:目標觀眾/預期收穫、粗略的時長與畫面比例、場景進展、視覺調性以及旁白方式。說明原始素材與觀看目的如何影響此方向。對於結構與風格的選擇,請參考 references/editorial.md。
僅在答案會改變事實內容、目標觀眾、方向或無法使用資產時,提出少量重點問題。請勿重複已回答的問題,也無需為每個工作都要求填寫問卷。在等待期間可繼續獨立工作;不得憑空捏造未解決的必要事實。若使用者未指定可選偏好,則陳述合理的假設,並在使用者授權範圍內繼續進行。
3. 編寫緊湊的故事板
針對每個場景,記錄其目的、原始證據、口說詞語、畫面重點、預期的視覺/動畫效果以及大約的時長。確保旁白與標題及說明文字有所區別。將未解決的事實單獨列出。將故事板視為編輯文件,而非新的程式語言。如果視覺或音訊方向不確定,請儘早測試一個代表性的段落。
4. 準備媒體與精確計時
為每種媒體類型使用適當的轉接器。語音請求與影片生成請求的輸入格式可能不同。將它們的結果標準化為已儲存的檔案與有用的中繼資料,包括時長、尺寸、生成設定、來源出處以及必要的歸屬資訊。
在預覽或渲染之前,先完成媒體生成。根據輸入內容與有效的提供者設定快取輸出結果,並驗證快取的檔案。請勿在 React 渲染函數或中繼資料評估中觸發付費或非確定性的生成。
對於旁白,必要時將顯示文字與發音文字分開。測量實際的音訊時長,然後為相關的圖片與文字留下足夠的理解時間。當狀況允許時,使用片語或句子的時間點。文字高亮需要可靠的時間戳記或對齊方式;均勻分配字元並非準確的對齊方式。
對於現有的錄音,保留或刻意修剪原始音訊,並從轉錄稿或轉錄服務中產生字幕。考慮場景偏移、音訊導入、停頓與重疊轉場。有關轉接器、計時、快取與修訂的合約,請參考 references/pipeline.md。捆綁的可選輔助函數可用於提取內嵌圖片與驗證字幕範圍;其用法與限制請參考 references/runtime.md。
5. 使用一般的 React/TypeScript 實作
重複使用小型元件來處理常見的樣式,並允許任意 React 程式碼來處理特定主題的場景。資料可以包含文字、媒體路徑、計時、來源參考以及設計標記。只有在已知格式的重複輸出需要時,才引入範本綱要。請勿為本機影片建立通用的時間軸解譯器、外掛註冊表或編排服務。
根據影格編號驅動動畫;避免使用牆上計時器與不受控的隨機性。在本機載入所需的字型與資產。樣式可以改變排版、構圖、動畫、重點文字、節奏與音訊;僅更改色票並不等於完整的風格變更。當僅有呈現方式改變時,重用已核准的媒體與計時。
執行有針對性的型別、資產、時長與字幕檢查。僅為其記錄的時間點合約使用捆綁的 check-captions.mjs。測試應圍繞可重複使用的計時/匯入/快取邏輯,而非每個視覺決策。當代理的編碼能力有限時,優先使用現有元件與小型、經過驗證的變更。
6. 在投入時間進行最終匯出之前先進行預覽
當使用者可以存取 Remotion Studio 時,優先使用它。顯示合成畫面,並說明需要審查的項目:原始素材忠實度、風格、文字/主體裁切、字幕可讀性、動畫與音訊。在支援的情況下,自行檢查代表性的場景、邊界與結尾。當使用者要求先審查再匯出時,請提供預覽並等待該審查完成後再進行最終匯出。既有核准或明確要求渲染的請求可授權繼續進行;請勿新增無條件的確認關卡。
如果無法使用互動式 Studio,則產生代表性的靜止畫面,並在需要審查動畫/音訊時,產生一段簡短的低解析度草稿。遠端環境的 localhost URL 可能無法被使用者存取;請提供可存取的預覽或本機成果。靜止畫面無法確認動畫或音訊品質。套用 references/runtime.md 中的人工審查備援方案,並準確報告哪些項目已經過審查、哪些尚未審查。
7. 匯出、驗證與交付
在請求的審查完成後,使用專案已安裝的 Remotion CLI 進行例行匯出。npx 指令請參考 references/runtime.md。僅在需要程式化整合或批次處理時,才使用渲染器 API。保留使用者的編輯,並在修改時僅重新生成受影響的媒體。
檢查匯出檔案的尺寸、影格率、時長、音訊存在與否、第一個/最後一個影格、字幕變更以及場景邊界。當感知審查可用時,播放完整結果;否則,標明需要進行的剩餘人工審查。成功的渲染或音訊解碼並不代表編輯品質、正確的發音或令人滿意的混音。預覽審查與最終檔案驗證是兩種不同的證據。
交付可編輯的專案、預覽/匯出位置、重現指令以及簡潔的狀態:已實作、已檢查預覽、使用者已審查、已匯出、已檢查最終檔案。僅宣稱已完成的階段。將生產紀錄與生產成果一同保留。
保持可重複使用的指引獨立於生產過程
技能與可發佈的範例必須是自包含且主題中立的。將私有的原始文字、圖片、音訊、名稱、連結、識別碼、檔案路徑以及特定於生產的指令保留在生產專案中。請勿將它們包含在可重複使用的技能、其中繼資料、參考資料、測試資料或資產中。如果確實需要範例,請使用新創建的範例。
記錄從生產過程中學到的方法與決策標準,但不要將其主題內容編碼為通用要求。在分享或安裝技能之前,請先驗證實際的技能套件內容。