Communitygithub.com

3D 動畫短劇製作

製作一部約 60 秒的垂直喜劇短片,為日常生活中的發明編造一個虛構的起源故事(「為什麼司機開始拍攝道路」→「就是這樣發明了行車記錄器」)。陰謀家利用漏洞、逐步升級,最終被沉默的受害者用該發明製伏。扁平卡通角色在光澤 3D 世界中演出,三個色調的幕次,1–2 字字幕,以程式碼渲染;使用者根據標記腳本在 Cartesia 中製作配音。

3D 動畫短劇製作 是什麼?

3D 動畫短劇製作是一個 AI 代理技能,用於製作約 60 秒的垂直喜劇短片,為日常發明編造虛構的起源故事(例如「為什麼司機開始拍攝道路」→「就是這樣發明了行車記錄器」)。該技能採用嚴格的逐步流程,包括主題選擇、腳本編寫、視覺聖經、外觀設計、故事板、配音錄製以及逐幕建構,並在每個關卡設置閘門供使用者審閱。它使用 Node.js、Three.js、Playwright、Python 與 Parakeet 語音計時模型,在程式碼中渲染 3D 場景。角色為扁平卡通風格,具有光澤表面、豐富細節與自然光效;故事遵循三個色調的幕次結構,使用 1–2 字字幕,並要求使用者在 Cartesia 中錄製配音。該技能支援從現有影片中學習參照設定,並針對每個方面(外觀、動畫、轉場、節奏)進行自動化品質檢查。最適合在 Claude Code、Cursor 或 Codex 等開發者工具中使用,使用者可輸入如「/3d-video-studio」或要求製作「為什麼 X 被發明」類型的短片。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/codewithsiddique-04/3d-video-studio/tree/HEAD

在你喜歡的 AI 中提問

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

說明文件

/3d-video-studio

┌──────────────────────┐
│  "Why Drivers Started│  標題詢問行為,從不提及發明名稱
│   Filming The Road"  │
│   ◕‿◕  ▶ 💥           │  鉤子:陰謀家的惡行,4 秒內揭示
│   loophole → greed   │  升級,面無表情的反擊,兩個「但是」轉折
│   quiet guy points ▣ │  透過發明本身的視角揭示
│ "that's how the ___  │  標籤回答標題,最後一鏡頭循環至第一鏡
│   was invented."     │
└──────────────────────┘

按順序執行步驟。⏸ 表示閘門:停下來,顯示結果,等待使用者的回覆。 在每個閘門,告知下一步驟。僅讀取當前步驟列出的檔案。

SKILL_DIR="<技能的基礎目錄>"; ENGINE="$SKILL_DIR/engine"
KIT="$SKILL_DIR/kit"; [ -d "$KIT/node_modules/playwright" ] || KIT="$HOME/.claude/kit"
PY="$KIT/.venv/Scripts/python.exe"; [ -x "$PY" ] || PY="$KIT/.venv/bin/python"
[ -d "$ENGINE/node_modules/three" ] && [ -x "$PY" ] || bash "$SKILL_DIR/setup.sh"

需要 Node 18+、ffmpeg 和 Python 3.9+。bash "$SKILL_DIR/setup.sh" 一次性安裝其餘部分(three.js、Playwright + Chromium、附帶 Parakeet 語音計時模型的 Python 虛擬環境)。使用 "$PY" 執行以下每個 Python 工具。

參照設定檔是每個閘門的衡量標準。

  • PROFILE="$SKILL_DIR/story/examples/dashcam" 包含量測數據(profile.json)、每個設定的影格(frames/)以及每個轉場的所有影格(transitions/)。
  • 如果使用者帶來新的參照,首先建構其設定檔(見下方「從新參照學習」),並將 PROFILE 指向該設定檔。
  • 影格不包含在公開儲存庫中。 story/examples/dashcam/ 和 story/examples/cashier/ 包含量測數據(profile.json)和書面節拍表,但不包含參照的影格(這些屬於原始頻道)。如果 $PROFILE/frames 遺失,請求使用者提供參照影片(任何符合此格式的短片皆可),並在步驟 4 之前,使用 $PROFILE 作為輸出資料夾執行「從新參照學習」的步驟 2。如果使用者沒有參照影片,僅根據 profile.json 和書面範例進行判斷,並在每個閘門告知此情況。
  • 絕不要僅以我們的影格進行判斷:每份審閱表都將參照放在我們的旁邊。

步驟 1 · 主題 ⏸

讀取 story/topic-bank.md。使用使用者的主題或提供三個選項。執行四問測試,並指出最弱的一項檢查。 閘門: 使用者選擇主題。

步驟 2 · 標題與腳本 ⏸

讀取 story/title-formula.md、story/formula.md、story/hook-rules.md、story/script-template.md、story/script-check.md。 同時讀取 story/rig-check.md(我們的扁平角色能做與不能做的事),並在評分前執行 "$PY" "$SKILL_DIR/tools/rig_check.py" <project>/script.json;顯示任何標記及其「階段化為」註記。角色骨架無法顯示的行必須在錄製配音之前修正。 先撰寫標題,然後逐節拍撰寫腳本。進行評分(低於 9/10 則重寫)。 顯示標題、腳本(每行一句,旁註節拍標籤)、字數、以每秒 3.8 字估算的長度,以及分數。 閘門: 使用者批准或編輯。將批准的句子儲存為 <project>/script.json(使用 cp -r "$ENGINE/template" <project> 建立專案;<project> 必須不存在)。

步驟 3 · 視覺聖經 ⏸

讀取 look/style-guide.md(外觀風格:光澤漆面、所有焦點物體上的墨線、自然光、略微模糊的背景、豐富的裝飾)和 look/visual-bible.md(規則與範本)。 首先生成外觀:node "$ENGINE/cast.mjs" new <project> --chars <角色> --cars <角色>。然後撰寫 <project>/visual_bible.md,涵蓋:

  • 每個角色(體型、頭部與頭髮、以十六進位表示的服裝層次、配件、故事所需的面部表情);
  • 每個環境(佈局、表面、可見光源、每面牆 4 到 8 個裝飾物品、確切的文字笑點、深度);
  • 內部(車輛、亭子、螢幕)、道具(完整的主角發明)以及 2D 圖形;
  • 資產計劃,將每個項目標記為 library + params、library + new text 或 new。 顯示聖經與角色輸出。閘門: 使用者批准、編輯或要求重新生成。

步驟 4 · 外觀表 ⏸

在任何故事板之前,以最終細節展示在 3D 中建構的視覺設計。讀取 look/setup-types.md。

  • lookdev.html、lookdev.js 和 sets.js 隨範本提供。將故事中最繁忙的場景寫入 sets.js(heroSet() 是外觀風格的範例:替換它,保留其層次),嚴格按照聖經執行。影片稍後會匯入相同的 sets.js,因此這項工作不會被丟棄。
  • lookdev.js 已製作卡片:
    • 所有 cast.json 中的角色,每組三個並附標籤;
    • 主角的面部表情;
    • 主角場景:廣角、中等(鏡頭模糊 10)以及道具特寫(模糊 14);
    • 主角車輛。 為主道具添加卡片,以及聖經標記為 new 的任何其他場景。
  • 故事使用的每種設定類型一張卡片(interior、pov、tracking、house、twoshot、talker、device),每張在其真實場景中以真實構圖建構,並包含 look/setup-types.md 中的每個「必須有」。儀表板 POV、談話者的牆壁和裝置視圖是容易被忽略的;現在建構它們。
  • 將其與參照配對: "$PY" "$SKILL_DIR/tools/sbs_sheet.py" <project>/review/look_pairs.jpg --ours <卡片> --ref <來自 $PROFILE/frames 的相同類型>。
  • 添加一條 400 像素裁切、比例 1:1 的條帶(儀表、牆上笑點、車身、道路),以便顯示缺失的細節和模糊。
  • node "$ENGINE/film.mjs" check <project> 0 <卡片> 0.5 --page lookdev.html,修復所有 FAIL(包括 clipped-art:角色的頭髮、帽子或頭部藝術在其邊緣被平坦裁切),然後 node "$ENGINE/film.mjs" sheet <project> <project>/review/look.jpg 0.5 1.5 2.5 ... --page lookdev.html --w 360 --cols 4。
  • 在程式碼中評分:node "$ENGINE/film.mjs" lookcheck <project> <project>/review/lookcheck 0.5 1.5 ... --page lookdev.html(光澤、輪廓、光線、深度、密度、色彩、面部表情;以 0 到 10 分對比 look/targets.json)。修復所有 LOW,然後用肉眼檢視一次表單,檢查數字無法判斷的項目(故事道具、吸引力)。顯示分數與表單。在步驟 8 中,也對每個幕次的影格執行 lookcheck。 交件 review/look.jpg 和 review/look_pairs.jpg。閘門: 使用者批准角色、世界和每種設定類型的外觀,或列出修正。影片中的每個場景都以此細節水準建構。

步驟 5 · 故事板 + 配音腳本 ⏸

一次完成兩個文件:

  1. 故事板 <project>/storyboard.md:每個攝影機設定一行(18 到 21 行): # | 句子 | 節拍 | 設定類型 | 攝影機移動 | 動作與面部表情 | 道具笑點 | 轉場(影格數) | 幕/情緒。 規則來自 story/formula.md(「畫面與剪輯」);story/examples/dashcam.md 顯示完整範例。
    • 設定類型是 look/setup-types.md 中的名稱之一;它會在程式碼中成為鏡頭的 type。
    • 動作與面部表情為每個動作命名引擎姿勢(stand、walk、sitOn、point、lean、armTo…)或道具;其他任何內容都會使 story/rig-check.md 失敗,並在建構前重寫。
    • 攝影機移動: 每行命名其移動和速度(例如「推進 6%/秒」、「拉遠至廣角」、「環繞 120°」);僅裝置視圖可以說「鎖定」。
    • 轉場: 溶解為 7 到 10 影格(揭示可達 16 影格),或命名世界內轉場。 場景、角色和道具來自批准的視覺聖經:按照聖經中的名稱命名。在表格下方,複製聖經的資產計劃,並加上故事板新增的任何項目。
    • 連續性表(在故事板下方):每個改變位置或狀態的道具或角色佔一行, 東西:狀態 → 狀態 → 狀態,並附上每次變更的設定編號(例如 鑰匙:口袋 (1) → 地板 (3) → 狗嘴 (5))。
      • 每次變更在畫面上發生於已命名的設定中,或透過觀眾可讀懂的畫面動作顯示(它被拋出、落地、被遞交)。
      • 沒有設定可以從觀眾從未見過的狀態開始。依賴於未見變更的後續動作(尋找沒人看到掉落的東西)是故事板失敗:將該動作加入某個設定,或增加一個設定。在敘述的時間跳躍中,允許一般的螢幕外步驟(從隱藏處取出票據)。
      • 將每個道具標記為故事物件(隨情節移動)或笑點道具(隱藏處、容器或笑話物件,停留在其自身的節拍中)。除非敘述在該位置提到它,否則笑點道具在新位置是失敗的。
      • 在表格下方,每個地點一條攜帶線:誰在那裡,每個人攜帶什麼以及原因。
    • 現實檢查(story/rig-check.md,最後一節):每個動作和攜帶物品都有現實中的人在那一刻會有的理由。如果唯一理由是連續性,重寫該行。
  2. 配音腳本 <project>/voice/cartesia.md:讀取 story/voice-cartesia.md 並撰寫標記區塊(每個區塊的情緒、速度建議,僅在「但是」轉折和標籤之前加入停頓)。

顯示兩者。閘門: 使用者批准故事板。然後請求配音:「在 Cartesia 中生成 voice/cartesia.md 中的區塊,並將檔案放入 <project>/audio/(vo_01.wav、vo_02.wav... 或一個 vo.wav)。與此同時,我將建構 5 秒預覽。」不要等待音訊,繼續步驟 6。

步驟 6 · 5 秒預覽 ⏸

僅建構鉤子(前 5 秒,通常是設定 1 到 3),以便使用者在長時間建構前判斷外觀。 讀取 engine/API.md;從 engine/template/video.js 複製區塊(從不開啟 engine/src)。從 cast.json 建構每個角色和車輛(makeChar(CAST.characters.x)、buildCar(CAST.cars.x)),並使用 stand / sit 姿勢。

  • 時間設定:sentenceStarts / captionsFromWords 搭配估算(estimateWords),或如果音訊已到達(步驟 7)則使用真實詞語檔案。
  • 從 ./sets.js 匯入場景,並使用 makeStage({ mood: withLook(mood, 'indoor' | 'outdoor') })。
  • 要判斷的外觀是已批准的外觀表:乾淨的 3D、光澤表面、所有焦點物體上的墨線、自然光、略微模糊的背景,以及每個影格邊緣到邊緣填充。如果面部空白或顯示後腦勺,則攝影機是在姿勢之後放置的(參見 engine/API.md、chars.js)。
  • 給每個面部一個 mark,每個鏡頭一個 type。執行 node "$ENGINE/film.mjs" check <project> 0 5 0.25;如果遇到任何 FAIL 則退出碼為 1,因此全部修復。
  • 一張表單:node "$ENGINE/film.mjs" sheet <project> <project>/review/preview.jpg 0.2 0.8 1.6 2.6 3.6 4.6 --w 180 --cols 6。檢視一次;修復明顯錯誤。
  • 渲染:node "$ENGINE/film.mjs" render <project> <project>/review/preview.mp4 0 5(約 1 分鐘)。 如果配音已到達,添加其前 5 秒:ffmpeg -i review/preview.mp4 -i audio/vo.wav -map 0:v -map 1:a -c:v copy -t 5 review/preview_vo.mp4。
  • 將鉤子與參照的鉤子進行比較:
    • "$PY" "$SKILL_DIR/tools/compare_video.py" <project>/review/preview.mp4 "$PROFILE" <project>/review/cmp_preview --range 0 5;
    • 將我們的飛出條帶放在 $PROFILE/transitions/ 旁邊(飛出物件在大約 4 個影格內通過玻璃,並落在廣角鏡頭上)。 在顯示預覽之前,修復動作、銳利度和細節方面的 FAIL。 交件 mp4 路徑和配對表。閘門: 使用者批准外觀(角色、顏色、攝影機、字幕)或要求更改。在此處更改角色或風格成本低廉,但在之後昂貴。

步驟 7 · 配音進入

當使用者說音訊已在 <project>/audio/:按照 story/voice-cartesia.md 中的「當音訊到達」操作(合併區塊、words.py、檢查長度和節奏)。

  • 節奏是嚴格閘門: 如果在每秒 3.5 到 4.1 字之外(film.mjs check 會使其失敗),要求以其他速度重新錄製,不要在慢速版本上建構。上次影片以 3.4 進行,結果為 71 秒,而參照為 62 秒。
  • 否則繼續:剪輯是基於句子編號建構的,因此它會自行重新計時。 如果在步驟 8 結束時配音尚未到達,再次詢問;沒有配音不要渲染最終版本。

步驟 8 · 逐幕建構其餘部分

對於每個幕次(1 白天、2 黃昏/夜晚、3 雨天),按順序:

  1. 首先在 sets.js 中建立新的場景和道具,達到已批准的外觀表和聖經的細節水準(參見 engine/API.md 中的「尚未建構」)。
  2. 幕中每個設定的鏡頭區塊,每個區塊有其 type,轉場依故事板所述(dissolve 7 到 10 影格、使用 cashBurst() / paperBurst() 的 burst、擦拭,或硬切)。
  3. 該幕時間範圍的 film.mjs check 必須退出碼為 0(無 FAIL)。最重要的 FAIL:
    • 攝影機移動慢於 slow-camera 限制(推進應每秒縮放 6 到 10%);
    • 主角面部超出其類型的大小範圍;
    • 溶解超出 5 到 12 影格;
    • 標籤懸掛在其所附著的物件之外(decal-overhang):使用 on: <表面> 註冊貼紙和標籤;
    • 關鍵文字被影格邊緣裁切、被頭部遮擋或隱藏(text-cut)。在建構場景或鏡頭時,使用 readable(mesh, label, { key: true }) 註冊笑點所依賴的每個數字、價格、螢幕和標籤。
  4. 配對表:我們的設定中間在底部行,相同節拍的參照設定在頂部(tools/sbs_sheet.py,影格來自 $PROFILE/frames)。從幕次中添加一條 400 像素裁切、比例 1:1 的條帶。
  5. 轉場審閱: 將幕中的每個轉場渲染為短片(film.mjs render 大約圍繞其前後 1 秒)。製作逐影格條帶,並將其放在 $PROFILE/transitions/ 中相同類型的參照轉場旁邊。檢查:
    • 切換在一個乾淨的影格中改變;
    • 溶解遵循緩和曲線,同時兩個鏡頭保持移動;
    • 爆發從不覆蓋超過大約三分之二的影格,且下一個鏡頭在其下方淡入;
    • 擦拭揭示

...

[因翻譯需求而截斷]

相關技能