導演簡報(課程步驟 10)
長片就是製作。課程中隔夜影片背後的簡報並不描述一段影片;它們是雇用一個團隊:一個用來檢查每個決策的故事大綱、參考資料、工具和預算、角色聖經、情節表、螢幕文字規則、關卡、批評循環和交付物。此技能將使用者的想法轉化為那份簡報,並引導製作通過其關卡。對於長度約 45 秒以下、不包含章節的短片,請改用 /motion-studio:motion-reel(此技能用來將較長影片移交給此技能的相同門檻)。
參數,只顯示一次:
此技能的檔案位於 ${CLAUDE_SKILL_DIR}(簡報範本為 ${CLAUDE_SKILL_DIR}/assets/brief-template.md,assets/brief-template.md)。
此技能的成本
它以 max 的運算量執行:這是 motion-studio 技能中最深層的推理和最高的 token 使用量。規劃錯誤會在數小時的自動工作中疊加放大,因此規劃正是值得花費這些資源的地方。在開始之前要先讓使用者了解預期成本。來自課程的資料點報告:一部隔夜音樂錄影帶大約花費 12 小時,並使用了 Max 方案約 80% 的使用量,外加 75 美元的圖片/影片 API 額度;一部 45 秒的手繪短片花費了 163 次模型呼叫、6270 萬個 token(96% 快取讀取),按 API 標價計算約 34 美元,並耗時約 6.75 小時。讓其餘部分保持較低成本:章節動畫師以它們自己的努力程度運行(高),而修正和重新渲染是中等努力程度的工作。如果預算很重要,請告知使用者在規劃獲得批准後使用 /model 降低工作階段的運算量。
1. 收集輸入
只有主工作階段可以向使用者提問(子代理不行)。如果使用者口述了一個長篇簡報,請解析它而不是重新詢問。否則,在一則訊息中一次性詢問缺少哪些資訊:
| 輸入 | 原因 |
|---|---|
| 故事大綱,以及觀眾在結尾時應感受到什麼 | 每個決策都會與其進行比對 |
| 時長、格式、發佈平台 | 章節數量、渲染時間、安全區域 |
| 參考資料(影片、影格、圖片庫、先前的儲存庫) | 要學習的語法、要避免的內容 |
| 音樂:一首曲目(及其授權)或「合成」 | 所有內容鎖定的節拍網格 |
| 路線(A 預設;僅當使用者指定 Remotion/HyperFrames 時為 B;C 生成後描繪)以及按變數名稱的 API 金鑰 | 工具和花費 |
| 預算:模型使用量、付費 API、實際時間 | 何時停止生成 |
| 模式:先計畫或直接執行 | 是否在規劃後停止 |
2. 撰寫 docs/brief.md
- 如果沒有
studio.json,請先執行/motion-studio:studio-init(設定--duration、--bpm、--formats)。 - 將
${CLAUDE_SKILL_DIR}/assets/brief-template.md複製到docs/brief.md。用使用者的答案填寫 A 部分;保持 B 部分不變。 - 更新
studio.json以保持一致(標題、時長、fps、bpm、格式、品牌、loop)。 - 先計畫:顯示填寫好的簡報並停止,直到使用者批准。直接執行:將你為使用者做的每個決定記錄在
docs/decisions.md中,然後繼續。
3. 關卡 1:規劃文件
| 文件 | 內容 | 撰寫者 |
|---|---|---|
docs/style_guide.md | 調色盤、字體、節奏、轉場、紋理、禁止的外觀 | 來自參考資料的 style-analyst 子代理(/motion-studio:reference-style),或由你撰寫 |
docs/STORYBOARD.md | 概念、角色、串聯整個故事的元素、帶有時間軸和轉場的章節 | motion-director 子代理,或由你撰寫 |
docs/shotlist.md | 節拍網格上的每個鏡頭(小節數)、攝影機、文字、特效 | motion-director |
| 章節規劃(在 STORYBOARD 中) | 在強拍上的章節邊界、每個章節的負責人 | 由你撰寫 |
在設定任何時間之前先測量或合成音樂(/motion-studio:sound-design):章節和鏡頭時間是 grid.bar(n) 的值,而不是猜測。將章節保持在 8 到 30 秒,以便一個子代理可以在一個工作階段內完成並檢查一個章節。motion-director 只寫入 docs/**(角色守護鉤子會強制執行此規則)。
4. 關卡 2:裝備與指南
- 在任何章節動畫師開始之前,從專案的
docs/中的範本寫入docs/ANIMATION_GUIDE.md,以便每個章節以相同的風格進行編碼:章節如何運作、所有權、佈局和預留區域、共享 API、共享元素、具有繪製時間預算的風格規則,以及確切的檢查命令。 - 自行在
film/scenes/shared_<name>.js中構建共享元素(主角、UI 套件、調色盤輔助函式)。章節動畫師匯入它們並且從不編輯它們。在每種狀態下渲染每個元素的靜態圖。 - 為每個章節建立樁,以便在章節進行中時影片可以從頭到尾渲染:
// film/scenes/ch03_build.js (由主工作階段寫入的樁;章節動畫師將取代鏡頭)
import { chapter } from '../../lib/timeline.js';
export const BARS = [12, 20]; // 來自 docs/STORYBOARD.md 的小節數範圍(null = 到結束)
export default function ch03(ctx) {
const FROM = BARS[0] === 0 ? 0 : ctx.grid.bar(BARS[0]);
const TO = BARS[1] == null ? ctx.dur : ctx.grid.bar(BARS[1]);
return chapter({ name: 'ch03_build', from: FROM, to: TO, shots: [], cues: [] }); // 無鏡頭 = 佔位卡片
}
- 一次性接好
film/film.js。buildFilm接受scenes內的chapter()結果,將其場景展平並合併其提示點。全影片層(字幕、接縫轉場)放在工廠的overlays: Scene[]中:它們在每個場景之後繪製,按陣列順序,遵循相同的from <= t < to規則(在影片的最後一個影格包含結束點),並且從不計為鏡頭,因此靜態圖標籤、批評鏡頭邊界和預覽條清單只列出章節鏡頭。章節程式碼保持不變;不要包裝或修補章節覆寫的draw函式。overlays中也接受巢狀陣列、null和chapter()結果,因此章節可以自帶其自己的疊加場景。若要堆疊普通場景,請為場景指定一個layer編號(預設為 0):場景按(layer, from)繪製。
import { defineFilm, scene } from '../lib/timeline.js';
import ch01 from './scenes/ch01_hook.js';
import ch02 from './scenes/ch02_problem.js';
import ch03 from './scenes/ch03_build.js';
const CHAPTERS = [ch01, ch02, ch03];
export default defineFilm((ctx) => ({
scenes: CHAPTERS.map((make) => make(ctx)),
overlays: [
scene(0, ctx.dur, 'captions', (g, lt, c) => { /* 全影片字幕:從影片時間 c.t 繪製 */ }),
// 每個需要轉場的章節接縫處的一個短場景,時間從網格計算
scene(ctx.grid.bar(12) - 0.2, ctx.grid.bar(12) + 0.2, 'seam-ch02-ch03', (g, lt, c) => { /* 擦除或閃爍 */ }),
],
cues: (grid) => [{ t: grid.bar(0), type: 'hit' }], // 影片層級的提示點;章節提示點會自動合併
}));
5. 分散章節
為每個章節生成一個 chapter-animator 子代理(motion-studio:chapter-animator),可以同時執行數個。為每個子代理提供簡報內容:其檔案(film/scenes/chNN_<name>.js)、其範圍(其樁中的 BARS 匯出,以及用於檢查命令的相同範圍(以秒為單位))、其 STORYBOARD 章節,以及「遵循 docs/ANIMATION_GUIDE.md」。角色守護鉤子允許章節動畫師僅寫入 film/scenes/**(film/scenes/shared_* 除外,這些檔案對章節動畫師保持唯讀,章節動畫師應回報共享檔案中的錯誤)和 out/check/**。每個子代理回傳一份報告:它構建了什麼、檢查靜態圖、已知問題,以及在共享檔案中發現的錯誤。你修復共享檔案,重新執行全片檢查,並在報告顯示問題時重新向章節動畫師提供簡報。
章節範圍是小節數,在章節的工廠內部使用 ctx.grid 計算,因此連續的章節總是相接並遵循測量好的軌跡。鏡頭時間是從網格取得的絕對影片秒數(shots: [{ at: grid.bar(13), name: 'assemble', draw }, ...]);每個鏡頭執行到下一個鏡頭的 at 時間,且其 draw(g, lt, c) 從鏡頭開始處接收 lt。位於其章節範圍之外的鏡頭會導致 chapter() 拋出異常,影片停止載入(例如,字面上的 TO = 4 會拒絕一個位於 grid.bar(1) = 4.003 秒的鏡頭,因為測量軌跡將第一個強拍置於 2.0 秒)。
6. 關卡 3 到 8
| 關卡 | 執行 | 檢查 |
|---|---|---|
| 3 靜態圖 | node tools/stills.mjs --shots(每個鏡頭一張靜態圖) | 批評回合(/motion-studio:critique-loop) |
| 4 動態腳本 | npm run animatic(半解析度,30 fps,無模糊)搭配真實或佔位音軌 | 節奏:每次閱讀都在下一個節拍之前完成 |
| 5 最困難的樣本 | 在最困難的 2 到 4 秒上執行 node tools/render.mjs --from A --to B --out out/check | node tools/critique.mjs --strip-at <t>;確定性;同步 |
| 6 完整遍歷 | 無任何剩餘的佔位符(node tools/stills.mjs --shots 中的鏡頭標籤結尾無 /placeholder) | 對整部影片進行批評回合 |
| 7 拋光與音效 | /motion-studio:sound-design:配樂或節拍、提示點、音效、人聲 | 同步指標、音訊軸線 |
| 8 最終 | npm run build | 簡報 B6 中的完成定義 |
長片以可續傳的區段進行渲染:node tools/render.mjs --format all --final --chunk 10 會寫入 out/<fmt>/.parts/seg_<a>_<b>.mp4,並在因中斷而重新執行時跳過已完成的區段。在背景執行長時間渲染(使用 Bash 工具的 run_in_background,或定期輪詢的日誌檔案),而不是阻塞工作階段,並且永遠不要在前台等待超過約 2 分鐘。對於三種格式、60 fps 和 4 個子影格,預計每秒影片大約需要 20 秒的實際時間(一部 2 分鐘的影片大約需要 40 分鐘的渲染時間);/motion-studio:motion-reel 的管線運行手冊包含此模式和其他每個命令的預期時間。章節動畫師或任何其他子代理在其啟動的命令仍在運行時不得回傳。
7. 路線 C:生成後描繪(選擇性)
僅當簡報選擇路線 C 並列出金鑰(按變數名稱:.env 中的 FAL_KEY、ELEVENLABS_API_KEY)和預算時使用。影片模型提供難以手動編碼的物理、時間和臉部;程式碼層提供使用者擁有的統一外觀。觀眾看到的是程式碼層。
- 使用使用者選擇的服務生成角色表和基礎鏡頭,遵循其自身文件。將每個結果保存在
refs/base/下,並帶有清單行(服務、模型、提示、種子、成本、授權)。在達到預算時停止。 - 提取影格進行研究:
node tools/refs.mjs extract refs/base/shot01.mp4 --every 0.1 --out refs/base/shot01。 - 在該時間基礎上,用程式碼重新繪製每個鏡頭(查看影格,使用彈簧和軌跡重建運動)。基礎素材在渲染時絕不從網路載入;如果一個鏡頭合成了一個基礎影格,請在
setup()中從本地檔案載入它。 - 驗證同步:相同時間點上的程式碼層與基礎影格的靜態圖,以及網格上的音訊提示點。對任何不同步的鏡頭重新執行該步驟。
金鑰:絕不列印、回顯、記錄或貼上它們。工具會自行讀取 .env;在提示和文件中使用變數名稱。
8. 完成定義與報告
簡報中的 B6 是合約:交付的 MP4 響度 -14 LUFS +-0.5 且 <= -1 dBTP,至少 3 輪批評,每個軸線 >= 8 且無 P0(npm run gate),重新渲染給出相同的影格(批評確定性檢查加上兩個 --hash 渲染產生的 framesDigest 值相同),每種格式的時長和影格數完全一致,並且所有交付物都存在(npm run deliver 檢查了大部分內容並寫入 docs/production.json)。以 B7 報告結束:交付物、每輪分數、實際花費、已知缺陷、下次會改進什麼。
鳴謝:簡報骨架遵循課程步驟 10;填寫/保持不變的劃分、先計畫 vs 直接執行以及完成定義遵循 @pradeepXkapoor 的公開範本模式(已改寫);驗收關卡改編自 athemeroy/awesome-opus-5-5-videos 的 docs/production-brief.md(CC BY 4.0);指南加分鏡腳本子代理模式參考自 JohnHeibel/PDoomVideo(僅概念,未重用文字)。
下一步:從關卡 3 開始,在每個關卡之後執行 /motion-studio:critique-loop,然後執行 /motion-studio:ship-formats 以交付。