Communitygithub.com

craft-2d-animation

指導AI代理如何規劃、建構或剪輯「2D動畫製作」,使最終輸出為代理能逐鏡頭辯護的動態影像。此流程涵蓋EffectCraft與FilmCraft中的Craft 2D Animation,包含視覺方向與場景可讀性、取景與視覺語法。當新任務需要此工藝時使用。

craft-2d-animation 是什麼?

此技能定義了一套完整且可重複使用的通用方法,用於在EffectCraft(搭配FilmCraft選擇性進行剪輯與輸出)中設計、動畫化與組裝2D動畫,適用於介紹、產品展示、短場景或短片創作,無論是否有音樂音軌。它詳細說明了視覺方向(如透過色彩辨識場景、使用填滿幾何形狀的角色剪影、以及為攝影機運動預留超大的背景尺寸)與取景技巧(從寬景建立鏡頭到特寫鏡頭的角色與應用)。核心動畫原理包括預備動作、動作、跟隨/停頓的節奏,以及透過姿勢變化與靜止鏡頭來清晰傳達故事。技術層面則著重於EffectCraft的關鍵實踐,例如正確的Null物件與攝影機定位、嚴格的父子層級規則(避免肢體錯位),以及圖層疊加順序(從後到前)。此外,技能還涵蓋文字可讀性規範:將標題置於場景的負空間(V2分層),並將其與場景內文字(V1)區分開來,確保輸出版本靈活性。最後,它提供了資源檢查與低負載批次渲染的策略,以避免在記憶體有限的系統上當機,並引導使用者使用位於~/.t3/shared/craft-video/的共享工具(如ec_runtime.py、批次渲染腳本與組合輸出腳本)。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/NelaBDV/craft-video-kit/tree/HEAD/skills/craft-2d-animation

在你喜歡的 AI 中提問

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

說明文件

Craft 2D Animation (EffectCraft + FilmCraft)

通用且可重複使用的方法,用於在 EffectCraft 中設計、動畫化與組裝片頭、產品展示、短場景或 2D 短片(可在 FilmCraft 中選擇性剪輯/輸出),無論是否有音樂音軌。

參考 CLI/MCP 與共用的 Flatpak 權限:../craft-music-video/references/mcp-and-commands.md


1. 視覺方向與場景可讀性

  1. 可透過顏色辨識的場景:將短場景限制在最多 2 或 3 個場景,每個場景有其主色調照明與專屬色板(例如:暖色走廊/夜晚、被螢幕照亮的辦公桌、僅以單一強調色保留給錯誤或警報的明亮房間)。
  2. 實心剪影而非中空輪廓:使用填滿的幾何形狀(貝茲曲線或圓角矩形)來建構角色與場景元素,搭配極簡的臉部(簡單的眼睛、眉毛、嘴巴),並在光源側添加微弱的邊緣光(rim light)。
  3. 剪影對比:從縮圖階段就需區分每個角色(例如:圓潤、矮胖的剪影 vs. 方形肩膀、動作俐落的直立剪影)。
  4. 為攝影機運動預留的超大場景:繪製比畫面更寬的背景/牆壁(2200–2400 px 用於 1920×1080 的縮放/晃動,或 3600+ px 用於全景平移),以避免畫面邊緣出現 10–20 px 的黑色邊框。

2. 取景與視覺語法

變換鏡頭景別以無需多餘文字即可敘述動作:

景別敘事角色技術最佳實踐
廣角鏡頭 (Establishing)展示場景、燈光與元素的相對位置在返回同一場景時,保持固定的空間參考點(辦公桌、螢幕、標誌、門)
過肩鏡頭 (OTS)顯示角色的目標及其對介面或物體的視角在首次嘗試與最終成功之間重複使用完全相同的 OTS 取景,以建立即時的視覺回顧提示
中景 / 側面追蹤姿態、移動與場景的物理變化非常適合展示逐漸畏縮、椅子後退或大幅度動作
特寫 (Close-up)聚焦於意圖、介面細節、按鍵上的手、表情或笑點保持動作簡短清晰;利用特寫來創造乾淨的負空間區域

攝影機取景計算 (cam_focus)

使用錨點為 [0, 0] 的 Null 攝影機,若要將世界座標點 (tx, ty) 置中於 W × H 畫面的中央,且縮放比例為 sc %,則完全符合以下公式: pos = [W / 2 - (sc / 100) * tx, H / 2 - (sc / 100) * ty] (可直接透過 ec_runtime.py 中的 cam_focus(tx, ty, scale_pct, width, height) 函式獲得)。


3. 姿勢變化、重量感與視覺節奏

  1. 預備動作 → 動作 → 跟隨/停頓:
    • 絕不要從 A 姿勢線性地移動到 B 姿勢。
    • 在動作之前添加一個微小的反向預備動作(例如:手指抬起並猶豫後再按下按鍵;門先微開再砰然關上;身體先靠穩再後退)。
    • 以輕微的過衝(overshoot)或清晰的停頓(hold)結束,以賦予重量感(例如:角色後退一步,暫停欣賞其工作)。
  2. 漸進式的姿勢階段:在等待或張力上升期間,讓姿勢在兩個鏡頭之間透過清晰的階段性變化來演進(軀幹傾斜、頭部下垂、手臂放鬆),而非持續漂浮。
  3. 在兩個動作之間保持鏡頭靜止:讓構圖在重點之間有呼吸空間(眨眼、微慢速縮放、游標閃爍),而不是讓所有圖層持續晃動。
  4. 強制無聲測試:不開聲音觀看任何動作、片頭或展示場景(或透過 3–5 張關鍵幀 render-frame 進行)。角色的目標與場景進展必須 100% 僅透過畫面即可理解。

4. 角色錨點、攝影機與疊加順序 (EffectCraft 陷阱)

這些規則能避免 EffectCraft 中(表現與 After Effects 相容)的偏移、肢體分離或元素隱藏等錯誤:

A. Null 物件與攝影機

  • comp.layers.addNull() 預設會建立一個錨點在 [50, 50]、位置在 [960, 540] 的 Null。在定位或建立父子關係之前,務必強制將 anchorPoint.setValue([0, 0]) (這就是 ec_runtime.py 中 makeCamNull 所做的)。
  • 務必先執行 child.parent = parent,再執行 child.position.setValue(...),這樣子物件的座標才能直接在其父物件的局部座標系中解釋。

B. 關於父子關係與變換的絕對規則

  • 在父物件處於中性姿勢(rotation = 0°,scale = [100, 100])時,附加所有子物件。
  • 僅在完整建立所有子物件層級結構之後,才應用父物件的初始旋轉、攝影機縮放或關鍵幀。
  • 原因:在指定 child.parent = parent 之前修改 parent.rotation 或 parent.scale,會觸發 AE 風格的逆向補償,導致頭部/手臂從身體脫離,或將整個場景縮小到畫面的角落。

C. 關節式 2D 角色錨點層級

  • 坐姿角色:Root 在臀部(hip_pos)→ Chair,Legs,TorsoNull(腰部樞紐 [0, 0])→ BackUpperArm(肩膀)→ BackForeArm(手肘)→ TorsoBody → Head(頸部底部)→ UpperArm → ForeArm。
  • 站姿角色:Root 在雙腳之間的地面(foot_pos),以便在縮放或後退時保持鞋子固定在地面 → LegBack / LegFront(臀部樞紐)+ TorsoPivot(臀部樞紐)→ Arms,Blazer/Body,Head。
  • 頸部/領口連接:務必添加一個覆蓋上身頂部與頭部底部的實心領口/頸部形狀,以便在 25°–35° 的大幅度傾斜時,不會在下巴與肩膀之間產生空隙。

D. 疊加順序

  • 在同一個形狀圖層內(ADBE Root Vectors Group):第一個添加的群組會繪製在最上層,最後一個繪製在最下層(前 → 後順序)。
  • 在同一個合成中的不同圖層之間:每個新圖層都會插入到索引 1(最上層)。依照後 → 前的順序建構圖層(背景 → 發光 → 場景 → 角色 → 前景)。

5. 文字可讀性與故事內/疊加層分離

  1. 無永久黑色橫幅:將標題、副標題或圖說放置在每個鏡頭的自由負空間中(螢幕上方、牆壁的暗角、地平線下方),絕不遮擋臉部、螢幕邊框或場景中的標誌。
  2. 對比與安全邊距:
    • 套用柔和的投影效果(ADBE Drop Shadow,透明度 190–230,距離 4–6 px,模糊 14–18 px),以確保在淺色與深色背景上均可閱讀。
    • 遵守水平安全邊距(1920×1080 中 >= 70 px)與清晰的可視停留時間(動作或最後一個詞結束後 >= 0.35 s,即使跨越鏡頭剪輯點也是如此)。
  3. 嚴格區分故事內文字(V1)與疊加文字(V2):
    • 場景內建文字(V1):招牌、螢幕介面、紙張、黑板、按鍵標籤。它們是動畫世界的一部分,並保留在所有輸出中。
    • 疊加文字(V2,ProRes 4444 RGBA):標題、卡片、字幕、歌詞或 UI 註解。將其放置於單獨的透明合成中,可一鍵輸出一個有標題的版本和一個乾淨版,且剪輯完全一致。

6. 視覺檢查與節省資源的渲染

  1. 在任何影片渲染前使用關鍵影格進行檢查:對每個鏡頭的 1 到 2 個關鍵時刻使用 effectcraft-cli render-frame --max-side 960(並對 V2 疊加層使用 --transparent),以在幾秒鐘內驗證取景、關節連接與文字可讀性。
  2. 安全的序列化渲染(8 GB RAM / 普通 CPU 機台):
    • 一次只渲染一個合成(切勿在 8 GB RAM 上並行渲染 ProRes 4444 RGBA)。
    • 限制執行緒數(RAYON_NUM_THREADS=2,OMP_NUM_THREADS=2),以低優先級執行(nice -n 15 ionice -c 3),如果 VRAM 與系統 RAM 共享則避免使用 --gpu,並在兩次渲染之間留出 2 秒鐘以釋放記憶體。

7. T3 Code 共用工具與相依性

可重複使用的腳本位於 ~/.t3/shared/craft-video/:

工具路徑在 2D 動畫中的用途
EffectCraft Runtime JSX~/.t3/shared/craft-video/ec_runtime.py匯入 JsxBuilder、cam_focus、hex_to_rgba、run_effectcraft_script 以正確生成 .ecproj(錨點 [0,0]、貝茲曲線、發光效果、平滑/保持關鍵幀)
序列化批次渲染~/.t3/shared/craft-video/render_ec_batch.sh以低負載渲染 V* 場景(ProRes HQ RGB)與 L*/T* 疊加層(ProRes 4444 RGBA),並透過 ffprobe 自動續傳
FilmCraft 組合與輸出~/.t3/shared/craft-video/assemble_filmcraft.py將 V1(+ 可選的 V2 alpha 與 A1 音訊)組合成 Rec.709 的 .fcproj,並輸出 Master + Clean 版本

必要相依性

  • Python 3.9+(僅標準函式庫)
  • ffmpeg 與 ffprobe
  • EffectCraft CLI(effectcraft-cli 或 Flatpak ai.storyteller.effectcraft,需具備 --filesystem 存取權限)
  • FilmCraft CLI(filmcraft-cli 或 Flatpak ai.storyteller.filmcraft),用於多軌組合/輸出
  • 選擇性 Linux 工具:nice、ionice、taskset

指令範例

# 檢查可用相依性(不進行渲染)
python3 ~/.t3/shared/craft-video/ec_runtime.py --check-env

# 預覽低負載序列化渲染計畫(場景 + Alpha 標題)
~/.t3/shared/craft-video/render_ec_batch.sh \
  --project ./projects/demo_2d.ecproj \
  --out-dir ./renders_vfx \
  --rgb V01_Intro,V02_Demo \
  --rgba T01_Intro,T02_Demo \
  --threads 2 --cores 0-3 --dry-run

# 預覽 FilmCraft 組合(無音樂,靜默介紹/展示,Master + Clean)
python3 ~/.t3/shared/craft-video/assemble_filmcraft.py \
  --out-fcproj ./projects/demo_2d.fcproj \
  --v1-clips ./renders_vfx/V01_Intro.mov,./renders_vfx/V02_Demo.mov \
  --v2-clips ./renders_vfx/T01_Intro.mov,./renders_vfx/T02_Demo.mov \
  --export-master ./exports/demo_2d_titles.mp4 \
  --export-clean ./exports/demo_2d_clean.mp4 \
  --dry-run

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相關技能