Communitygithub.com

cinematicanimation

指導 AI 代理人規劃、構建或剪輯「電影動畫」,產出具備實用性的成品複本或腳本。流程依循六線視覺風格、引擎選擇(Cycles 或 EEVEE)與完整管線。適用於需要此工藝的新任務。

cinematicanimation 是什麼?

此技能專門用於指導 AI 代理人製作一部完整的「電影級」3D 動畫短片。它與同屬 Blender 生態的 `robloxmaxxing`(製作遊戲資產與明亮解說世界)形成互補,專注於有限角色、黑暗場景、單一光源與可僅憑影像理解的故事敘述。核心流程涵蓋從簡報定義、分鏡規劃、世界與角色建置、燈光設定、表演動畫,到最終算圖與後製的完整管線,並設有嚴格的品質檢查閘門(如 GATE L 亮度數值檢查)。支援 Cycles 與 EEVEE 兩種算圖引擎,並提供在 EEVEE 中重現 Cycles 視覺風格的明確規則與代價權衡。此技能深度整合於使用者的 Blender 工具集,包含獨特的 `cine_kit` Python API,用於程序化地建立場景、燈光、角色與攝影機運動。它也與使用者的其他技能(如 `scriptmaxxing` 用於配音、`robloxmaxxing` 用於道具)及自訂的 Roblox 化身系統無縫協作,使得 AI 代理人能生成從概念到交付的完整動畫短片。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aaksa/cinematicanimation/tree/HEAD

在你喜歡的 AI 中提問

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

說明文件

cinematicanimation 是做什麼的?

這是 robloxmaxxing 旁邊的高階技能。那個技能製作遊戲資產和明亮、繁忙的解說世界。這個技能則製作一部電影:少數角色、黑暗的房間、一盞燈、一個即使關掉聲音也能看懂的故事,並使用 Cycles(參考畫面效果)或 EEVEE(在短時間內達到相同效果,需遵循下方「引擎」部分的規則)算圖。

SKILL = 此資料夾。B = /Applications/Blender.app/Contents/MacOS/Blender (5.1)。BP = Blender 的 Python (/Applications/Blender.app/Contents/Resources/5.1/python/bin/python3.11),僅 beatgrid.py 需要。其他腳本:使用 python3 -I。

每次工作階段閱讀一次:references/craft.md(故事、鏡頭、剪輯、動畫、聲音)和 references/look.md(燈光、材質、鏡頭、調色、算圖時間)。references/reference-films.md 是證據:兩部電影逐鏡頭測量的數據。在反駁此檔案中的任何數字前,請先閱讀它。

六線視覺風格

  1. 玩具角色,真實世界。 方塊上有畫的臉;周圍一切都是真實、磨損且小尺寸的。
  2. 黑暗。 畫面中位亮度為全範圍的 0.10-0.26。只有一盞可見的燈是主要光源。沒有補光,沒有天空。
  3. 道具高度。 攝影機位於桌面高度,靠近主體,淺景深,且前景有一些模糊的東西。
  4. 特寫鏡頭推動故事。 手部、物體、可讀的道具。大約一半的鏡頭沒有臉。
  5. 按節拍剪輯。 鏡頭長度是音樂節拍的整數或半數。速度隨故事變化。
  6. 寂靜也是一個鏡頭。 音樂在轉折點停止一次。結尾是一個臉或物體,然後轉為黑畫面。

引擎:Cycles 或 EEVEE

K.setup(..., engine="CYCLES" | "EEVEE")。在 M4 晶片、1080x1920 解析度下測量:

引擎每幀時間一部 60 秒影片(1440 幀,兩個進程)適用時機
Cycles, 160 samples70-90 秒28-36 小時主要靜幀、封面、短預告片
Cycles, 16 samples, 40% 尺寸11 秒2 小時(較柔和:用於預覽,非最終交付)檢查剪輯
EEVEE, 64 samples, 全尺寸, 僅載入該鏡頭自身的 set6-8 秒1-1.5 小時任何長於約 15 秒的交付成果

若遵守以下規則,EEVEE 可保留視覺風格(霧氣、散景、背光塑料、AgX)。每個規則都來自 Negara Angin 專案的實際代價:

  • 場景建置後,請呼叫 K.eevee_lights(keep=(...))。 僅有大型、有動機的光源才投射陰影;過多的小陰影燈會溢出陰影池,導致各幀之間閃爍。
  • 窗格使用 Alpha,而非玻璃。 EEVEE 中的透明玻璃會折射螢幕空間(其後的東西會模糊),且混合透明度會渲染成黑色。請使用 Principled 材質 alpha ~0.14、surface_render_method = "BLENDED",並從反射和凹凸中減少設置。
  • EEVEE 無法對焦穿透窗格。 景深效果讀取最近表面的深度,因此玻璃後的所有物體都會像在玻璃上一樣模糊。僅當窗格是主題時才顯示它(K.visible),一旦焦點移動到其後,就隱藏它。
  • 玻璃不投射陰影(eevee_lights 會處理):EEVEE 將其視為不透明,因此透過窗戶或罐子的光線會中斷。
  • 僅載入該鏡頭自身的 set 來渲染每個鏡頭(--sets):每個載入的 set 都會在每幀被評估(例如實例欄位、雨)。在 Negara Angin 專案中,這將時間減半。兩個 worker 可以同時處理同一個任務列表;render_range 使用鎖定檔案來搶佔幀。
  • 動態模糊和體積圖塊大小影響不大;超過 64 的採樣在顆粒過濾後不會帶來更多好處。
  • Cycles 關閉焦散:窗戶玻璃後的光線永遠無法到達房間。請將「窗戶光」放在窗格內部。

管線

階段動作檢查閘門
0. 簡報一句話紀錄、循環或鏈條結構、關鍵物品、每個場景的色板、音樂曲目及其 BPM (beatgrid.py)GATE B:簡報的每一行都是可觀察的事實
1. 分鏡計畫鏡頭作為行數:景別、鏡頭焦段、移動內容、節拍長度;每場景一個主鏡頭GATE S:craft.md 中的規則在紙面上成立
2. 世界 + 角色cine_kit:房間/街道、道具、燈具、霧氣;K.Char 角色主鏡頭的靜幀,每個用一句話描述
3. 燈光從可見燈具出發的主光、輔助光、邊緣光;以預覽尺寸對每個攝影機執行 stillGATE L 應用於每個鏡頭的靜幀 (look_gate.py)
4. 表演在節拍上擺姿勢 (hit, pose, face, talk)、攝影機運動、life()一份連拍表無需聲音即可講述故事
5. 算圖使用 2-3 個進程執行 render_range,16-bit PNG,跳過已存在的幀幀數 = 影片長度
6. 完成finish.py(光暈、調色、柔化、暗角、顆粒)+ 混音GATE L 應用於完整影片、GATE E (shotlist.py --bpm)、-14 LUFS

檢查閘門失敗時必須在該階段修復:一幀過亮是燈光問題,絕非調色問題。

GATE B - 簡報(建置腳本頂部的 docstring)

  • 一句話紀錄:一個句子,包含一個慾望和一個代價。
  • 結構:一個逐漸縮短的循環(規則出現一次,然後加速重複)或一個鏈條(每個場景的結束物件,成為下個場景的開始物件)。
  • 關鍵物品:一個小型、帶有臉或數字在上面的物品(照片、帳單、票據)。攝影機會推近拍攝它。
  • 每個場景的色板:一種主光色、一種陰影色、一種強調色。每個場景都不同。
  • 聲音:音樂曲目、其 BPM、音樂何時淡入、中斷的 3-8 秒時間段。
  • 結尾:最後一個影像(一個臉或物體)以及之後黑畫面上的一或兩個詞。
  • 排除事項:這部電影絕對不能看起來像什麼。

GATE L - 視覺風格(數值來自參考資料;scripts/look_gate.py)

測量值(全範圍 0-1)通過條件參考值
畫面中位亮度0.10-0.260.20, 0.17
陰影層級(第 10 百分位像素)低於 0.090.06, 0.04
亮部層級(第 90 百分位像素)0.22-0.560.46, 0.36
峰值(最亮像素)高於 0.850.91, 0.98
黑色基準值低於 0.050.02, 0.02
飽和度琥珀色 0.10-0.30,黑色電影 0.03-0.140.18, 0.07

對每個鏡頭的完成靜幀執行此檢查,然後對整部影片執行。單一明亮的特寫鏡頭可能產生 WARN;FAIL 則必須修正。「峰值低於 0.85」表示畫面中沒有真正的高光:請在鏡頭可見範圍內放置一盞燈、一個閃光或一根霓虹燈管。

GATE E - 剪輯(scripts/shotlist.py film.mp4 --bpm N)

每個鏡頭的長度都是節拍的整數或半數。平均鏡頭長度 1-3.5 秒。前兩個鏡頭是該場景中最長的。沒有兩個連續鏡頭使用相同的景別和角度。有一段 3-8 秒的時間沒有音樂。影片在轉為黑畫面後一秒內結束。

建置一個場景

"$B" -b --factory-startup -P build.py -- --out out --stills        # 每個鏡頭一張半尺寸靜幀,每張約 10 秒
python3 -I "$SKILL/scripts/finish.py" out/still_master.png --out out/fin_master.jpg --look amber
python3 -I "$SKILL/scripts/look_gate.py" out/fin_master.jpg --look amber
"$B" -b --factory-startup -P build.py -- --out out --frames --final &   # 啟動 2-3 次:已存在的幀會跳過
python3 -I "$SKILL/scripts/finish.py" out/frames --out out/film.mp4 --look amber --audio mix.wav
import sys; sys.path.insert(0, SKILL + "/blender"); import cine_kit as K
K.setup(aspect="16:9", height=1080, preview=True)            # "9:16" 用於短影片;preview=False 用於最終交付
K.room(26, 22, 10); K.round_table("Table", 3.2, 2.9); K.pendant("Lamp", (0, 0, 6.5), power=2600, spot=125)
K.neon("Ring", (0, 10.8, 5.6), radius=1.7, color="#FFB020"); K.bokeh_lights("Shelf", ((-11, 10.2, 2.5), (11, 10.6, 8)))
K.light("TableBounce", "AREA", (0, 0, 3.05), 260, 2300, target=(0, 0, 9), size=4); K.haze((26, 22, 10), (0, 0, 5), 0.006)
hero = K.Char("Hero", skin="#F2C230", shirt="#20242C", hat="hair", at=(-4.5, 0, 0), yaw=90); hero.sit(1)
master = K.Cam("Master", (-2.2, -9.6, 3.1), (0.2, 0, 4.3), lens=28, stop=5.6)
cu = K.Cam("HeroCU", (-1.6, -6.2, 4.1), (-4.4, 0, 4.4), lens=50, stop=4, focus=hero.head)
S = K.cut_list([("master", master, 4), ("hero", cu, 2.5)], bpm=100); B = K.beats(100)
hero.hit(B(4.5), 3, head=(2, -60, -5)).face(B(4.5), "smirk"); cu.push(*S["hero"], 0.06).handheld(0.3); hero.life()

examples/standoff/build.py 是完整且經過測試的版本(4 個鏡頭,7.2 秒):將其複製作為新電影的起點。

cine_kit 一覽表

需求呼叫方式
場景setup(aspect, height, samples, preview),world(),room(),haze(size, loc, density)
表面plastic(玩具表皮,背光時發光)、cloth(kind=weave/knit/leather)、wood(planks=)、brick、asphalt(wet=)、flat(氈、石膏、金屬)、glass、emit(霓虹燈、燈泡、螢幕)
形狀box(總是帶導角)、cyl、torus(arc=)、text(3D 字母、霓虹字)、paper(海報/帳單/卡片,含可讀線條)、round_table、chair
燈具pendant(可見燈罩+燈泡+聚光)、neon(燈管+匹配的補光)、bokeh_lights、light(kind, loc, power, color=kelvin 或 hex, target, size)
角色Char(name, skin, shirt, pants, hat=hair/cap/fedora/beanie):.pose(frame, arm_l=(fwd, out, twist), head=(nod, turn, tilt), torso, leg_l, at, yaw)、.hit(frame, dur, ...)(瞬停+保持)、.face(frame, expr)、.talk(f0, f1)、.sit、.walk、.life()
已提供角色Rigged("bugis_man" / "bugis_woman" / path.blend, at, yaw):來自檔案的模型角色,與 Char 相同高度,具有與 Char 相同的姿勢通道(arm_l、head、torso、leg_l、.hit、.sit、.walk、.life、.head)。繪製的臉:無表情切換,因此情感來自頭部、手臂和剪輯。新的單件模型使用 scripts/rig_block.py 進行一次綁定(先從切片測量頸部、臀部和手臂邊界)並添加到 K.CAST;綁定是剛性的,除了頸部是使用 neck_blend.py 柔化的(請參閱「頸部接縫」)
使用者的化身Avatar(at, yaw, pose):Aksa 的綁定 Roblox 角色(Roblox/blender/hero_face.blend),與 Char 相同高度。.pose(frame, "table" / "stand" / "relax" / "reach" / "chin" / "hips", head=(nod, tilt, turn), arm_L=...)、.hit、.sit、.life()、.head(攝影機目標)、.face.expr(f, eyes, brows, mouth) / .face.lipsync(words, vo_frame, fps=24) / .face.blink,然後執行一次 .finish()。使用者是自己的電影中的英雄:除非使用者另有指定,否則主要角色使用 Avatar,其他角色使用 Char
臉部表情K.EXPRESSIONS:neutral、smirk、grin、angry、shout、shock、sad、shut、talk_a、talk_o、talk_m、side。僅切換,從不變形
在繪製臉上的歌唱一次:Blender -b cast/x.blend -P scripts/prep_mouth.py -- cast/x_sing.blend(在正交前視圖算圖上找到繪製的嘴巴,在其自身的皮膚上以其顏色繪製一個 10 形狀的嘴巴圖集,然後將一個板片放置在臉部並綁定到頭骨;單元格 0 = 原始繪畫,因此靜止時不可見;然後重新混合頸部,使板片下的所有東西都跟隨頭部運動)。在場景中:K.Rigged(".../x_sing.blend").sing(words, f0, f1) 搭配 words = [{"word","start","end"}](來自音樂曲目的轉錄文字,使用更快-whisper 單詞時間)。唱歌時將頭轉向鏡頭:側面會隱藏嘴巴
攝影機Cam(name, loc, target, lens, stop, focus, roll):.at(frame, loc, target, focus, roll)、.push(f0, f1, 0.06)、.handheld(amount);Cam.distance_for(lens, height) = 站立多遠才能用指定高度的主體填滿畫面(根據景別放置近距離攝影機,切勿猜測);.clip_follow(f0, f1, subject) = 關鍵幀設置近剪裁,以便從頭上俯衝到他們手中的手機
可見性K.visible(ob, [(f0, f1), ...]):僅在這些範圍內算圖可見;僅影響隱藏曲線(切勿將物件的所有曲線都設為 CONSTANT:其動作會變成階梯狀)
剪輯beats(bpm) -> 第 n 個節拍的幀數;cut_list([(name, cam, beats), ...], bpm) 將攝影機綁定到標記並返回每個鏡頭的幀範圍
輸出still(path, frame)、render_range(dir, f0, f1)

stop 是光圈值,如同角色是一個 40 公分的收藏品:2-2.8 用於特寫、4 用於臉部、5.6-8 用於主鏡頭。數值越小 = 越模糊。

與使用者其他技能的搭配

  • 腳本: 使用 scriptmaxxing 處理任何印尼語旁白。保持簡短;擁有 1370 萬觀看次數的參考影片沒有任何旁白。
  • 音樂和效果: ~/Ngonten/Maxxing/audio-lib (CC0)。在規劃鏡頭前,對音樂曲目執行 beatgrid.py。
  • 使用者自己的化身: K.Avatar() 載入帶有臉部綁定的化身(眨眼、眉毛、字詞準確的印尼語口型同步,來自 Roblox/blender/face/face_rig.py)。K.Char.talk() 僅為其他說話者提供有限的動畫。試試看:build.py -- --avatar --stills。
  • 道具和場景: robloxmaxxing/blender/rbx_kit.py 以相同的 stud 比例建置;使用 Poly Haven(Blender MCP search_assets,或 3d-assets MCP)取得 CC0 PBR 紋理和真實世界道具;使用 Meshy 處理一個英雄道具。逼真的道具是重點。
  • 垂直短片: --aspect 9:16。這裡的一切都適用;主鏡頭使用 24-28 mm 焦段,深度沿鏡頭軸線堆疊。

近距離工作的硬派規則(Negara Angin,2026-11-21)

  • 先測量,再構圖。 先列印出在鏡頭幀數下頭部、手部和道具的評估位置,然後使用 Cam.distance_for 放置攝影機。目測放置的微距攝影機最終距離只需 0.5 studs 的物體卻需要 2 studs。
  • Roblox 的手是大方塊。 握在「手中」的手機會被埋住;請將道具沿著螢幕法線方向握在手的前方。
  • 不要將道具設置為骨骼父級然後再設定其世界矩陣(它會落在原點)。在姿勢保持期間,保持道具世界固定,或使用運算子進行父級綁定。
  • 靜幀會忽略剪輯標記。 綁定到攝影機的標記會覆蓋該幀的 scene.camera:請為靜幀清除它們。
  • 鉤子是一個影像和一個事件。 第 1 幀必須已經很美(Negara Angin:一滴雨滴以極致微距滑落窗戶,房間的燈光在其中折射),而第一個節拍必須改變它(鼓點將焦點穿過雨滴拉動)。
  • 轉場是設計出來的,而非事後添加: 讓攝影機穿過一個螢幕進入它所顯示的世界(將下一個鏡頭的第一幀作為螢幕影像渲染),從一個鏡頭甩出並進入下一個鏡頭。

...

相關技能