模組化多代理影片與照片編輯技能
當使用者想要分析影片和照片資料夾、訪談/釐清故事偏好、執行多代理 Vlog 與家庭旅行編輯流程、新增自訂編輯子代理角色（例如 VFX 或調色），或渲染 4K 10-bit HLG HDR 影片時，請使用此技能。
1. 子代理角色參考檔案（漸進式揭露）
每個代理角色在 references/ 目錄中都有其專屬的參考規格（可供 Antigravity 的 define_subagent / invoke_subagent 工具以及 Python BaseEditingAgent 類別使用）：
- 第 0 階段 — 客戶訪談與簡報製作 (
client_intake)：references/00_client_intake_agent.md → 輸出creative_brief.json - 第 10 階段 — 素材管理與篩選 (
culler)：references/01_culler_agent.md → 輸出media_index.json - 第 10 階段 — 聲音與氛圍設計 (
audio_vibe)：references/04_audio_vibe_agent.md → 輸出beat_grid.json - 第 20 階段 — 故事製作人 (
story_producer)：references/02_story_producer_agent.md → 輸出paper_edit.json - 第 30 階段 — 雙畫面編輯器 (
dialogue_editor+montage_editor)：references/03_picture_editors.md → 輸出草稿多軌timeline.yaml - 第 40 階段 — 可插拔的後期/VFX/調色插槽 (
vfx_designer)：references/06_vfx_agent.md → 豐富timeline.yaml（effects_track）並輸出vfx_manifest.json - 第 50 階段 — 總導演與節奏評論 (
showrunner)：references/05_showrunner_agent.md → 根據creative_brief.json進行審計、協調修改，並輸出pacing_audit.json+ 草稿timeline.yaml+storyboard.md - 第 60 階段與跨階段監督 — 執行電影製作導演 (
production_director)：references/07_production_director_agent.md → 在每個階段關卡監督所有子代理，指導子代理修正/改善涵蓋範圍、動作多樣性以及音訊/標題連貫性，並輸出director_review.json+ 最終簽核的timeline.yaml與storyboard.md
2. 執行多代理流程
選項 A：原生 Antigravity 子代理 + CLI 協調器
- 訪談客戶（第 0 階段）：
使用
ask_question（依循 references/00_client_intake_agent.md）來釐清敘事風格、必備時刻、目標長度以及照片構圖，或直接執行：python -m video_editing_ai.cli agents-run "<media_dir>" -o "<project_dir>" --prompt "<user_story_idea>" --bgm "<optional_bgm.mp3>" - 生成專門子代理（
define_subagent/invoke_subagent）： 您可以使用define_subagent並載入其對應references/*.md檔案中的系統提示，在任何隔離的上下文視窗中生成任何角色。每個角色將檢查並豐富其在磁碟上的 JSON 合約（creative_brief.json→media_index.json&beat_grid.json→paper_edit.json→timeline.yaml→pacing_audit.json）。 - 渲染 4K 10-bit HLG HDR 影片與 NLE 匯出：
python -m video_editing_ai.cli render "<project_dir>/timeline.yaml" -o "<project_dir>/final_story.mp4"
選項 B：列出或切換可插拔子代理
# 列出所有已註冊的核心與可選外掛代理
python -m video_editing_ai.cli agents-list
# 啟用可選的第 40 階段 VFX 設計師外掛來執行流程
python -m video_editing_ai.cli agents-run "<media_dir>" -o "<project_dir>" --prompt "<idea>" --enable-agent vfx_designer
選項 C：本地 Web Studio
python -m video_editing_ai.cli serve --port 8000