Remotion 影片超能力

Remotion 影片超能力 是做什麼的？

使用此技能，以規範的「規格 -> 計劃 -> 執行 -> 驗證」工作流程來執行 Remotion 影片製作。對於非簡單的影片，請勿直接跳入動畫實作。

工作流程

1. 在實作前，建立或更新影片規格。

   • 閱讀 references/writing-video-specs.md。
   • 實際可行時，將規格儲存在專案中的 docs/video/specs/YYYY-MM-DD-project-name.md。
   • 擷取目標、非目標、觀眾、視覺方向、素材、旁白需求、限制條件以及驗收標準。

2. 建立或更新製作計劃。

   • 閱讀 references/writing-video-plans.md。
   • 實際可行時，將計劃儲存在專案中的 docs/video/plans/YYYY-MM-DD-project-name.md。
   • 使用勾選框任務。每個任務都必須列出檔案、步驟、驗證方式和停止條件。

3. 在開始動畫實作前，完成素材的來源蒐集。

   • 閱讀 references/asset-sourcing.md。
   • 收集並記錄產品素材、品牌素材、UI 參考資料、螢幕截圖、3D 模型、地圖/地理空間資源、服務標記/環境變數名稱、音訊參考資料、授權、歸屬、本機路徑和備用方案。
   • 在所需的素材於本機可用，或明確記錄了備用方案之前，請勿開始場景動畫。

4. 逐一執行計劃中的任務。

   • 在編輯 Remotion 程式碼前，閱讀 references/remotion-scene-execution.md。
   • 當影片包含網頁 UI、產品介面、儀表板、前端風格的動畫、Three.js、Anime.js 或複雜的動畫編排時，閱讀 references/frontend-animation-system.md。
   • 當影片需要地圖、路線、城市、地形、建築物、地標、數位孿生、設備、太空船、真實世界的 3D 物體，或需要由令牌驅動的服務（如 Mapbox/Cesium ion）時，閱讀 references/3d-map-and-model-resources.md。
   • 使用 useCurrentFrame() 和 interpolate() 來實現可安全搜尋的動畫。
   • 避免使用 CSS 過渡和非確定性的執行階段動畫。
   • 保持場景文字簡短；將解說移至旁白中。
   • 在最終渲染前，在場景的開始、高峰和轉場處渲染靜止畫面。

5. 將旁白視為第一順位的時間軸來源。

   • 在編寫 ElevenLabs v3 腳本前，閱讀 references/elevenlabs-v3-scripting.md。
   • 在匯入、同步或混合音訊前，閱讀 references/audio-sync-and-muxing.md。
   • 透過此技能的 scripts/inspect-audio.sh 腳本檢查實際的音訊長度。
   • 優先選擇延長場景時間以配合最終的旁白，而不是剪輯音訊。

6. 在交付前執行最終的 QA。

   • 閱讀 references/qa-checkpoints.md。
   • 若可用，執行專案的 lint/型別檢查。
   • 使用此技能的 scripts/render-checkpoints.sh 腳本或明確的 npx remotion still 命令來渲染檢查點靜止畫面。
   • 渲染最終的 MP4 檔案。
   • 當音訊可靠性至關重要時，使用此技能的 scripts/mux-voiceover.sh 腳本混合旁白。
   • 使用 ffprobe/ffmpeg 驗證持續時間、音訊流和音量。

超能力規則

• 將規格視為唯一真理。如果實作與規格衝突，更新規格或停下來詢問。
• 將計劃視為可執行。在驗證通過之前，請勿將任務標記為完成。
• 若影響最終影片品質的驗證失敗則停止：損壞的 lint、無法閱讀的文字、重疊的場景、缺少音訊、持續時間不符或關鍵視覺元件為空白。
• 對於修訂，先識別受影響的場景和影格範圍，渲染前後靜止畫面對比，然後僅修補必要的程式碼。
• 保留使用者提供的媒體。刻意複製或引用它；請勿覆寫來源下載檔案。
• 除非使用者明確要求螢幕導覽，否則請勿將螢幕截圖用作宣傳片的主要視覺語言。將產品概念轉化為動態隱喻，並將螢幕截圖用作證據、轉場或簡短的產品證明。

參考文件導航

• 需要設計影片：閱讀 writing-video-specs.md。
• 需要規劃實作：閱讀 writing-video-plans.md。
• 需要收集產品素材、模型素材、螢幕截圖、令牌、授權或參考資料：閱讀 asset-sourcing.md。
• 需要編寫 Remotion 場景或轉場：閱讀 remotion-scene-execution.md。
• 需要設計豐富的前端風格動畫：閱讀 frontend-animation-system.md。
• 需要地圖、3D 城市/地形、路線或外部 3D 模型：閱讀 3d-map-and-model-resources.md。
• 需要旁白腳本，尤其是 ElevenLabs v3：閱讀 elevenlabs-v3-scripting.md。
• 需要對齊 MP3/WAV 音訊或修復「無聲音」問題：閱讀 audio-sync-and-muxing.md。
• 需要檢查最終品質：閱讀 qa-checkpoints.md。

從專案目錄執行捆綁腳本時，除非專案本地存在對應的腳本，否則請使用此技能 scripts/ 目錄的絕對路徑。