電影感影片剪輯
在其他 AI agent 使用、安裝或封裝本技能時，先讀 agent-compatibility.md，依目標平台處理技能目錄與本機設定。
把使用者的影音素材製作成可觀看、可修改的影片。自動處理使用 FFmpeg、Remotion、faster-whisper 與 OpenCC；精修依 local-environment.json 的 preferred_editor 選擇已安裝的 DaVinci Resolve 或 Shotcut。不依賴 MCP、付費 API、雲端算圖或付費效果。沿用使用者指定的剪輯器、風格與交付格式。
本機環境
首次使用先將 local-environment.example.json 複製成 references/local-environment.json，填入實際工具位置；範例路徑不代表工具已安裝。
先讀 references/local-environment.json 確認工具的絕對路徑。Python 依賴放在專用 venv；用其中的 python，不要用系統 Python 執行語音辨識。用 scripts/project.py doctor 檢查環境。專案建立、預覽與輸出命令見 project-commands.md。scripts/ 與 assets/ 都相對於本 Skill 資料夾；命令請用絕對路徑與參數陣列，正確處理中文與空白路徑。
開始工作
需要搬移或重建工具環境時才讀 environment-notes.md，按已測試的版本鎖檔重建。
- 根據需求與素材推定做法，只有缺少會影響成品的資訊才詢問。確認片長、畫幅、重要內容與風格；未指定時可先做 16:9、1080p、30fps 預覽。
- 素材路徑不明時，先盤點目前工作目錄，不把空資料夾誤當成已有素材。保留原始檔，派生檔存於新的工作資料夾。
- 用
media.py inventory建立含長度、畫幅、音訊資訊與縮圖的清單。需要時才產生 proxy 或用media.py scenes找切鏡點。讀 media-commands.md 取得實際命令。 - 看代表畫面，聽人聲、讀逐字稿再挑素材；切鏡偵測只代表畫面變化，抽幀也可能漏動作。不得把推測的畫面、人名或活動事實當成已確認內容。
剪輯與動態設計
- 建立段落與素材起訖清單。學校落成影片可採片頭、校園與歷史、活動與訪談、願景、感謝片尾；依素材調整。
- 用
scripts/project.py init <新專案目錄>複製已備妥的 Remotion 模板。把選定素材複製到該專案的public/media/，避免修改原片。 - 編輯
public/project.json的場景、入點、長度、轉場、字幕與姓名條。讀 motion-template.md 的資料規格；影片素材先 ffprobe 確認裁切範圍。模板支援片頭、章節、照片推近、影片、引言、感謝片尾，以及 fade/wipe/slide。 - 先做小段預覽，再製作整片。用
project.py still看指定時間，用project.py render --scale 0.5快速預覽；正式交付才用原尺寸。
維持一致的字體、配色、安全邊界與動畫節奏。可用字距展開、線條揭示、遮罩與緩入緩出提升質感。把人名、職稱、日期、片名與配色放在可修改資料中。長文字改行或縮短，不用超小字硬塞。
進一步效果可在模板原始碼加入自訂動畫。必要時讀已安裝的官方 remotion-best-practices、remotion-captions、remotion-render Skills 或官方文件；基本模板可獨立執行。只採用免費且相容的效果。3D 場景有實際需求時再使用 Blender，不自動加裝大型選配工具。
繁體字幕與聲音
- 用
scripts/transcribe.py與已準備的本機 small 模型產生 SRT 和含詞時間的 captions.json；CPU/int8 可用，無須 CUDA。GPU 加速須先確認相依套件。 - OpenCC 只轉換字詞；仍須校對校名、人名、職稱、日期、同音字與臺語。辨識不清處保留待確認標記，不編造。
- 對剪輯後的對白音軌辨識，或依每段素材裁切及轉場重疊換算到最終時間軸。不要把原素材字幕時間直接貼到剪過的影片。
captions.json的captions陣列可移入 project.json；起訖是最終影片秒數。逐字高亮須有可靠詞時間；只有整句時間時顯示整句。- 字幕與姓名條保持可讀且不互相遮擋。原音轉場會同時播放重疊片段，訪談盡量切在語句邊界；需要時獨立處理聲音。配樂保留人聲清晰，採適合素材的音量與淡入淡出。
交付與檢查
- 用
media.py check檢查解碼、黑畫面與靜音；黑場、靜音可能是設計，人工判讀。抽看開頭、轉場中間、字幕最長處、姓名條與結尾，並聽查人聲和配樂。 - 保留原始碼、project.json、使用素材與 SRT，交付 MP4、縮圖和修改方式。不可無聲覆寫成品，輸出新版本或明確使用
--overwrite。 project.py shotcut可建立含渲染結果的 Shotcut 精修起點。文字不會變成 Shotcut 原生文字層；改字、改動畫要回 Remotion 專案重出。不得宣稱已渲染特效仍可逐字原生編輯。- 透明動畫須建立專用透明 Composition，輸出並實測 RGBA PNG 序列或相容 alpha 編碼；一般 H.264 MP4 不保留透明度。
- 使用 Resolve 精修或要求直接控制時讀 resolve-guide.md。Resolve 控制依目標電腦實測；可使用內建 Lua Console 建立專案、匯入素材、建立時間軸及輸出 DRP／MP4。GUI 操作使用可用的 computer-use Skill。不要假設免費版外部 scripting 連線可用。
scripts/resolve_verify.lua僅供最長 9.8 秒的控制驗證；正式剪輯依需求使用官方 API 與畫面操作，逐步驗證結果。需要原生可改字效果時建立 Fusion 模板並實際驗證，不把 Remotion 成片當成原生節點。
完成時說明成片與可修改專案位置、已驗證功能及待校對內容。安裝狀態以 doctor 和實際執行為準；剪輯引擎本機免費，AI agent 帳號額度另計。