Communitygithub.com

yazzang-homelab/motion-studio

規劃長片或隔夜影片:導演簡報(先計畫或直接執行、預算、完成定義)、動畫指南 + 分鏡腳本、章節子代理、關卡、分段渲染。用於「隔夜影片」、「音樂錄影帶」、「2 分鐘短片」。

motion-studio 是什麼?

此技能專為需要長時間創作(例如「隔夜影片」、「音樂錄影帶」或「2 分鐘短片」)的 AI 代理設計,將其轉變為結構化的製作流程。它會先產生一份完整的「導演簡報」,涵蓋故事大綱、參考資料、預算和「完成定義」,然後逐步引導影片通過多個關卡(從規劃、動畫指南、章節動畫、靜態幀審查、動態腳本到最終渲染)。此技能支援多種平台(如 Claude Code)和渲染途徑(包括 A 預設、B Remotion/HyperFrames、C 生成後描繪),並能處理長達數小時的複雜渲染任務,透過分段渲染和背景執行來避免工作階段阻塞。其主要優勢在於將耗時的人工規劃自動化,將錯誤成本降至最低,並確保最終成果符合預先定義的品質標準(如響度、同步性和交付物完整性),非常適合需要高品質、長時間動態影像內容的進階使用者。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/yazzang-homelab/motion-studio/tree/HEAD/skills/director-brief

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

導演簡報(課程步驟 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

  1. 如果沒有 studio.json,請先執行 /motion-studio:studio-init(設定 --duration、--bpm、--formats)。
  2. 將 ${CLAUDE_SKILL_DIR}/assets/brief-template.md 複製到 docs/brief.md。用使用者的答案填寫 A 部分;保持 B 部分不變。
  3. 更新 studio.json 以保持一致(標題、時長、fps、bpm、格式、品牌、loop)。
  4. 先計畫:顯示填寫好的簡報並停止,直到使用者批准。直接執行:將你為使用者做的每個決定記錄在 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:裝備與指南

  1. 在任何章節動畫師開始之前,從專案的 docs/ 中的範本寫入 docs/ANIMATION_GUIDE.md,以便每個章節以相同的風格進行編碼:章節如何運作、所有權、佈局和預留區域、共享 API、共享元素、具有繪製時間預算的風格規則,以及確切的檢查命令。
  2. 自行在 film/scenes/shared_<name>.js 中構建共享元素(主角、UI 套件、調色盤輔助函式)。章節動畫師匯入它們並且從不編輯它們。在每種狀態下渲染每個元素的靜態圖。
  3. 為每個章節建立樁,以便在章節進行中時影片可以從頭到尾渲染:
// 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: [] });   // 無鏡頭 = 佔位卡片
}
  1. 一次性接好 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/checknode 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)和預算時使用。影片模型提供難以手動編碼的物理、時間和臉部;程式碼層提供使用者擁有的統一外觀。觀眾看到的是程式碼層。

  1. 使用使用者選擇的服務生成角色表和基礎鏡頭,遵循其自身文件。將每個結果保存在 refs/base/ 下,並帶有清單行(服務、模型、提示、種子、成本、授權)。在達到預算時停止。
  2. 提取影格進行研究:node tools/refs.mjs extract refs/base/shot01.mp4 --every 0.1 --out refs/base/shot01。
  3. 在該時間基礎上,用程式碼重新繪製每個鏡頭(查看影格,使用彈簧和軌跡重建運動)。基礎素材在渲染時絕不從網路載入;如果一個鏡頭合成了一個基礎影格,請在 setup() 中從本地檔案載入它。
  4. 驗證同步:相同時間點上的程式碼層與基礎影格的靜態圖,以及網格上的音訊提示點。對任何不同步的鏡頭重新執行該步驟。

金鑰:絕不列印、回顯、記錄或貼上它們。工具會自行讀取 .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 以交付。

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

yazzang-homelab/motion-studio

Make Claude watch its own frames: critique.mjs evidence, harsh 7-axis scores, timestamped P0/P1/P2 problems in docs/review_log.md, fix the 3 worst, re-check, pass the gate. Use for 'critique it', 'review the frames', 'is it good'.

yazzang-homelab/motion-studio

Make a launch video, app or product reel, explainer or motion ad from code, end to end: brand assets from a URL, beat-grid shot list, synced sound, critique loop, all formats. Default for new video requests; not footage edits.

yazzang-homelab/motion-studio

Brand-asset stage of a product film (motion-reel runs the whole film): capture real screenshots, logo, colors and fonts from a URL, never redraw UI; brand story beats; voice + mascot. Use to grab or fix a brand's assets.

yazzang-homelab/motion-studio

Turn a reference (a frame, a video or an image library) into docs/style_guide.md and a beat-grid shot list: measure cuts, palette and pace, take grammar not content, wait for OK. Use when the user supplies or names a look.

yazzang-homelab/motion-studio

Build, debug or speed up the seek(t) render engine: render contract, canvas vs page capture, workers/subframes/chunks, determinism fixes, Remotion or HyperFrames handoff. Use for 'render is slow', 'frames differ', 'use Remotion'.

yazzang-homelab/motion-studio

Ship every format from one timeline, then package it: layout() reframing (never crop), render all formats, per-format checks, deliver.mjs, a brand skill, a service offer. Use for 'export 9:16 and 16:9', 'deliver', 'make a skill'.

yazzang-homelab/motion-studio

The viral one-line 'showreel for a résumé' prompt: why it works (anatomy), the credited quote, and seeded variants that avoid look-alike reels; runs it as an engine test. Use for that prompt, its variations, or a showreel.

yazzang-homelab/motion-studio

Score a film to its beat grid: measure a track (beats.mjs) or synthesize one (score.mjs), cue SFX from the film, add voice, mix to -14 LUFS / -1 dBTP at exact length. Use for 'add music', 'sync to the beat', 'SFX', 'loudness'.

yazzang-homelab/motion-studio

Make motion feel physical with closed-form springs from lib/motion.js: presets, springFromFeel, track() for multi-target values, loopTrack loops, indicators, text swaps. Use for 'feels linear', 'add bounce', 'easing to springs'.

yazzang-homelab/motion-studio

Scaffold a motion-studio film project (seek(t) renderer, springs, beat grid, synthesized sound, critique tools), install it, set up the browser, run doctor. Use for 'set up the motion studio', 'new film project', 'init studio'.

yazzang-homelab/motion-studio

Write a six-part XML state spec for a one-shape UI morph film (inputs, direction, structure, build, gotchas, start): states on downbeats, cursor-driven changes, seamless loop, approval gate. Use for 'UI morph', 'state list'.

相關技能