Communitygithub.com

ido6/ai-video-skills

在 Blender 中建立 Pawn 風格(盒狀軀幹 + 球體頭部角色,搭配純色原始場景)的前期預覽/區塊場景,並匯出為 AI 影片(Seedance、idoGen、Kling)的動作/結構參考。

ai-video-skills 是什麼?

這個技能讓開發者可以在 Blender 中快速建立「Pawn 風格」的 3D 場景作為 AI 影片的前期預覽。所謂 Pawn 風格,就是角色只由一個方塊軀幹和一個球體頭部組成,沒有四肢和五官,場景則是用純色的簡單幾何形狀構成。它支援兩種視覺風格:「previs」是柔和粉彩搭配無陰影的棚燈;「toy」則是飽和鮮豔的團隊色彩,並帶有柔和陰影。 這個技能的核心價值在於,它能將 Blender 場景完整匯出成 AI 影片模型可以直接使用的參考資料:一個 MP4 影片、第一幀和最後一幀的靜態圖片、每秒一張的關鍵幀截圖,以及原始的 .blend 檔。它特別適合與 Seedance、idoGen、Kling 等 AI 影片工具搭配使用,作為影片到影片、動作控制或參考影片輸入。 技能可以透過後台指令列批次執行(Blender 不需要開著),或在 Blender 內即時操作(搭配 MCP 附加元件),讓使用者可以邊看邊調整鏡位。內建完整的 Python API,提供 new_scene()、character()、move()、export_for_ai() 等函式,讓 AI agent 可以全自動建構場景、設定鏡頭、規劃角色動作,並產出供 AI 影片模型參考的素材包。對於追求真實感的專案,它還有「寫實 AI 影片移交規則」,規範了材質、色彩、鏡頭與檔案規格,確保區塊模型能乾淨地轉譯為寫實畫面。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ido6/ai-video-skills/tree/HEAD/skills/blender-blockout-pawns

在你喜歡的 AI 中提問

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

說明文件

Blender 區塊模型 Pawns → AI 影片前期預覽

這個技能做兩件事:

  • 在 Blender 中重現 Ido 的參考前期預覽外觀:純粹的 pawn 角色(一個方塊軀幹和一個球體頭部,沒有四肢、沒有臉、沒有其他裝飾)放在純色原始場景中。
  • 將每個場景匯出為 AI 影片的參考套件:一個 MP4、第一幀和最後一幀、關鍵幀截圖以及 .blend 檔。

渲染使用 Workbench(視埠風格),因此速度足夠快,適合製作動態腳本。

設定(請根據您的機器調整路徑)

  • Blender 5.2 位於 <BLENDER_EXE>。使用者環境變數 BLENDER_PATH 指向它。
  • 工具包檔案位於 <BLOCKOUTS_DIR>\_kit\blockout_kit.py。它包含與下方 KIT 部分相同的程式碼。如果遺失或過時,請將 KIT 部分寫回該路徑。
  • 輸出根目錄為 <BLOCKOUTS_DIR>\<SceneName>\。資料夾 <BLOCKOUTS_DIR> 必須連線到工作階段。如果尚未連線,請使用 device_request_folder_access 要求存取。
  • 場景腳本放在 <BLOCKOUTS_DIR>\_scripts\<SceneName>.py。

執行模式 — 預設使用 A

A. 背景執行(已驗證可行;Blender 不需要開啟)

  1. 將場景腳本寫入容器。它應以以下內容開頭:
    import math
    exec(open(r'<BLOCKOUTS_DIR>\_kit\blockout_kit.py', encoding='utf-8').read())
    
    然後加入建構呼叫,接著是 r = export_for_ai() 或 render_still(),最後是 print("RESULT", r)。
  2. 將腳本複製到 _scripts\<SceneName>.py。將其暫存到 /mnt/user-data/outputs/,然後使用 device_commit_files。
  3. 透過 PC 上的 Desktop Commander shell 執行它: & '<BLENDER_EXE>' --background --factory-startup --python '<BLOCKOUTS_DIR>\_scripts\<SceneName>.py' 2>&1 | Select-String 'RESULT|Error|Traceback' 使用約 300 秒的超時時間。一個 5 秒的 720p 鏡頭渲染時間遠低於一分鐘。
  4. 使用 device_stage_files 拉回 preview.png 或 first.png/last.png,並使用 Read 查看它們。然後迭代。

Blender 連接器的 execute_blender_code_for_cli 會讀取 BLENDER_PATH。它只有在 Claude 桌面應用程式在設定該變數後重新啟動才能運作。如果顯示找不到可執行檔,請使用上面的 shell 途徑。

B. 即時執行,在已開啟的 Blender 內部(連接器的 execute_blender_code,搭配 MCP 附加元件伺服器執行)。當 Ido 想要在視埠中觀看或調整時使用此模式。

  • 在第一次呼叫中,執行 exec(open(r'<BLOCKOUTS_DIR>\_kit\blockout_kit.py', encoding='utf-8').read()),然後執行建構呼叫。
  • new_scene() 總是建立一個新場景,因此 Ido 自己的場景永遠不會被觸及。
  • 如果後續呼叫引發 NameError,請再次執行 exec 行。

兩種外觀

look="previs"(預設)look="toy"
感覺柔和灰濛的粉彩色。每個物體都是不同的顏色飽和的團隊色彩,像棋盤遊戲棋子
頭部光滑的球體,浮在軀幹上方約 6 公分處低多邊形球體(16×10),放在 / 略微沉入軀幹
顏色頭部顏色與軀幹顏色不同頭部和軀幹共用一種團隊顏色(白色/黑色/紅色/藍色/黃色/橙色/綠色)
燈光棚燈,無陰影,柔和的世界環境凹陷棚燈加上柔和投影,無環境凹陷(環境凹陷會在低多邊形頭部畫出網格線)
典型場景房間,帶有深李子色天花板、床、書桌和門;底座上的模型大廳、圓形毛氈桌、椅子、欄杆;按角色區分顏色的人群
曝光值+0.45+0.75

Pawn 身體為 0.48 寬 × 0.40 深 公尺,含頭部的標準高度為 1.86 公尺。小孩約 1.2 公尺,巨人約 3 公尺。seated=True 會給予較矮的軀幹並抬高到坐姿高度,以搭配 chair()。Ido 的規則:保持 pawn 純粹。 只能改變顏色、height= 和 seated=True。永遠不要添加鼻子、四肢、帽子或附加的道具。

當 Ido 沒有特別說明時,使用 previs。當他提到團隊、賭場、遊戲、人群或強烈顏色時,使用 toy。

建立一個鏡頭

  1. 呼叫 new_scene(name, look, aspect="16:9")。長寬比選項:16:9=1280×720,9:16=720×1280(Reels/TikTok),1:1,4:5,21:9。請與您正在製作的 AI 影片長寬比相符。
  2. 使用 room() 建構場景,然後使用 block()、bed()、table()、chair() 和 cylinder() 放置家具。使用 10–40 個物體;這種外觀只需要很少的細節。使用 open_walls=(1,) 以便相機可以放置在房間內部。
  3. 使用 character() 添加 pawns。使用 move() 讓它們動起來,這會讓它們滑行並在角落轉彎。規劃繞過道具的路徑,因為 pawns 會直接穿過家具。
  4. 使用 camera(loc, look_at, lens=20–28) 在視線高度 1.5–1.7 公尺處添加相機,稍微偏離軸線,就像手持前期預覽相機一樣。另外兩種構圖:從高處 3/4 視角向下看模型,或在兩個 pawns 身後進行過肩鏡頭。對於相機移動,在起始和結束幀對 cam.location 和 cam.rotation_euler 設定關鍵幀。保持移動簡單(推近、平移、環繞),因為 AI 模型最能複製簡單的移動。
  5. 設定長度。一個鏡頭通常是 5–10 秒:KIT["scene"].frame_end = 120(24 fps 下為 5 秒)。move() 已經會為了涵蓋行走路徑而延長 frame_end。
  6. 呼叫 render_still() 並檢視結果。當構圖正確時,呼叫 export_for_ai()。
  7. 回報場景名稱、輸出資料夾以及第一幀和最後一幀。

取自參考影片的構圖規則

  • 牆壁、地板和天花板各有自己的顏色。在 previs 中,天花板是非常深的李子色(#3A3442),因此在畫面上方形成一條暗色帶。
  • 相機通常放置在房間內部。使用 open_walls 來移除相機後方的牆壁。
  • 門是半開的薄板。room() 的 door= 參數會切出開口並添加門板。
  • 雜物由扁平薄盒子構成,例如散落在桌上的紙張或牆上的便利貼(隨機粉彩色的 0.15 × 0.01 × 0.2 盒子)。
  • 人群:將 pawns 圍繞桌子排成圓圈,在櫃檯後排成直線,或成對作為警衛。在 toy 外觀中,按角色分配顏色。
  • 道具與 pawn 的比例一致,例如 pawn 的頭部大約與門的上三分之一處齊平。

AI 影片交接

export_for_ai(every=24) 將這些檔案寫入 Videos\Blockouts\<Scene>\:

  • <Scene>.mp4 是動作和結構參考。它用於影片到影片、動作控制,或作為 Seedance 或 idoGen 中的「參考影片」輸入。
  • first.png 和 last.png 是構圖輸入。對於寫實作品,它們提供給建立真實起始/結束幀的影像模型(請參閱下方的覆寫規則);僅在草稿測試時直接使用它們。
  • keys/key_####.png 是每秒一張的靜態圖片。將它們用於全方位參考多圖(@Image1…)或分鏡腳本。
  • <Scene>.blend 是場景檔,保留以供後續編輯。

在編寫生成提示詞時,告訴模型保持參考中的佈局、區塊和相機移動。然後描述最終的外觀:取代 pawns 的真實人物,以及材質、燈光和服裝。將每個 pawn 顏色對應到一個角色,例如「粉紅色身體的人物 = 穿紅色裙子的女人」。對於多圖 Seedance 提示詞,請交接給 seedance-25 技能。

寫實 AI 影片交接:劇本覆寫規則(2026-10-06)

上述外觀適用於動態腳本。當片段是用於寫實 Seedance 2.5 / idoGen 的控制片段時,Ido 前期預覽劇本中的這些規則優先(完整細節:idogen-video-brain → references/previs-to-seedance-playbook.md;鏡頭選擇:cinematography → references/camera-directing-playbook.md):

  • 中性灰色場景。 有顏色的牆壁/天花板的色調會滲入生成結果 [field]。僅在主要 pawns 和故事道具上保留純色。
  • 每個替身可透過兩個線索識別(顏色 + 高度/形狀/位置);僅用顏色對應是不可靠的 [field]。如果 pawn 顏色可能滲入服裝,請將 pawn 塗成服裝顏色 [unverified]。
  • 故事關鍵道具(瓶子、托盤、眼鏡)獲得自己的簡單基本幾何形狀。
  • 真實比例,存在地板,不應該移動的東西不要移動,沒有疊加層(路徑、裝置、網格、幀計數器、文字)且沒有音軌。
  • 每個鏡頭一個主相機移動,每個片段一個鏡頭。 僅烘焙慢速的肩部浮動;快速晃動請在文字中要求或在剪輯中添加。
  • 鏡頭是電影攝影的決策,不是固定的 20–28 毫米預設值:它被烘焙到片段中。對於 9:16,將感測器設定為 36.7 毫米(旋轉的 ALEXA Mini LF 片門)以便 Blender 的毫米等於真實世界的毫米。
  • 片段規格: 24 fps,輸出長寬比,整秒數,≥4 秒(Seedance 最低要求),片段長度 = 生成長度,並在可用部分之後保留真實動畫的尾巴。
  • first.png 不是開始幀。 它是提供給影像模型的構圖輸入,影像模型會與視覺參考一起建立寫實的開始幀。僅在草稿測試時直接使用它。
  • 同時為每個相機方向匯出一張空場景靜態圖片,以及一張俯視圖(位置平面圖)。

KIT — blockout_kit.py 的內容

# ---- BLOCKOUT KIT (每個工作階段貼上一次,然後呼叫輔助函式) ----
import bpy, math, random, os, glob
from mathutils import Vector

OUT_ROOT = os.path.join(os.path.expanduser("~"), "Videos", "Blockouts")
ASPECTS = {"16:9": (1280, 720), "9:16": (720, 1280), "1:1": (1080, 1080), "4:5": (1080, 1350), "21:9": (1680, 720)}

PREVIS = ["#9C7393", "#8DB59A", "#88BDB0", "#C48DAA", "#ADB277", "#88A2B5",
          "#8E78AA", "#BFAE94", "#7FA393", "#B28AA1", "#A2C0AA", "#D6A9B8",
          "#B3A28A", "#7E5A70", "#9FA6C2"]
TOY = {"white": "#E8E8E2", "black": "#0B0C0E", "blue": "#1667A8", "yellow": "#C9A20E",
       "red": "#B0122E", "orange": "#C27A12", "green": "#2E6B4A", "felt": "#2A6A48",
       "cream": "#E6DDC4", "wood": "#5A3218", "brass": "#9C8240", "floor": "#E3D2B0",
       "wall_teal": "#4E7468", "wall_wine": "#5C3740", "wall_taupe": "#6B5E4C"}
KIT = {"look": "previs", "rng": random.Random(7), "col": None}

def _rgba(h):
    h = h.lstrip("#"); c = [int(h[i:i+2], 16) / 255 for i in (0, 2, 4)]
    lin = [x / 12.92 if x <= 0.04045 else ((x + 0.055) / 1.055) ** 2.4 for x in c]
    return (*lin, 1.0)

def _mat(hexcol, rough=0.85):
    name = "BK_" + hexcol.lstrip("#")
    m = bpy.data.materials.get(name)
    if m: return m
    m = bpy.data.materials.new(name); m.diffuse_color = _rgba(hexcol); m.roughness = rough
    m.use_nodes = True
    b = m.node_tree.nodes.get("Principled BSDF")
    if b: b.inputs["Base Color"].default_value = _rgba(hexcol); b.inputs["Roughness"].default_value = rough
    return m

def _pick(color):
    if color is None:
        return KIT["rng"].choice(PREVIS) if KIT["look"] == "previs" else TOY["cream"]
    return TOY.get(color, color)

def _link(ob):
    for c in ob.users_collection: c.objects.unlink(ob)
    KIT["col"].objects.link(ob); return ob

def new_scene(name="Blockout", look="previs", seed=7, fps=24, aspect="16:9", res=None):
    """look: 'previs' (影片 1-2:Workbench,柔和隨機粉彩,無投影)
             'toy'    (影片 3:飽和團隊色彩,柔和陰影,低多邊形頭部)"""
    KIT["look"] = look; KIT["rng"] = random.Random(seed)
    sc = bpy.data.scenes.new(name); KIT["scene"] = sc
    if bpy.context.window: bpy.context.window.scene = sc
    col = bpy.data.collections.new(name + "_SET"); sc.collection.children.link(col); KIT["col"] = col
    sc.render.fps = fps; sc.render.resolution_x, sc.render.resolution_y = res or ASPECTS[aspect]
    sc.render.resolution_percentage = 100; sc.frame_start = 1; sc.frame_end = 1
    sc.render.engine = "BLENDER_WORKBENCH"
    sh = sc.display.shading
    sh.light = "STUDIO"; sh.show_specular_highlight = False
    if look == "previs":
        sh.color_type = "MATERIAL"          # 色盤已烘焙到材質中(跨渲染穩定)
        sh.show_shadows = False; sh.show_cavity = True
        sh.cavity_type = "WORLD"; sh.cavity_ridge_factor = 0.3; sh.cavity_valley_factor = 0.6
        sh.show_object_outline = False
    else:
        sh.color_type = "MATERIAL"; sh.show_shadows = True; sh.shadow_intensity = 0.35
        sc.display.shadow_focus = 0.6; sc.display.light_direction = (0.35, -0.45, 0.82)
        sh.show_cavity = False             # 環境凹陷會在分面頭部畫出網格線
    sc.view_settings.view_transform = "Standard"
    sc.view_settings.exposure = 0.45 if look == "previs" else 0.75   # 與參考幀亮度匹配
    return sc

def block(name, size, loc, color=None, rot_z=0.0, bevel=0.0):
    """軸對齊盒子。size=(x,y,z) 單位為公尺,loc = BOTTOM 面的中心。"""
    bpy.ops.mesh.primitive_cube_add(size=1, location=(loc[0], loc[1], loc[2] + size[2] / 2))
    ob = bpy.context.active_object; ob.name = name; ob.scale = size; ob.rotation_euler.z = rot_z
    bpy.ops.object.transform_apply(scale=True)
    if bevel:
        m = ob.modifiers.new("Bevel", "BEVEL"); m.width = bevel; m.segments = 3
        bpy.ops.object.shade_auto_smooth(angle=math.radians(35))
    ob.data.materials.append(_mat(_pick(color))); return _link(ob)

def cylinder(name, r, h, loc, color=None, verts=32):
    bpy.ops.mesh.primitive_cylinder_add(radius=r, depth=h, vertices=verts, location=(loc[0], loc[1], loc[2] + h / 2))
    ob = bpy.context.active_object; ob.name = name; ob.data.materials.append(_mat(_pick(color))); return _link(ob)

def room(name="Room", w=6, d=5, h=2.8, t=0.1, ceiling=True, door=None, floor_color=None, wall_colors=None, open_walls=()):
    """每面牆都是自己的物件,因此每面牆都有自己的顏色。
    door=(牆面索引 0..3, 沿牆偏移量, 寬度, 高度) 會透過分割該牆面來切出開口。"""
    fc = floor_color or ("#8EBFAE" if KIT["look"] == "previs" else TOY["floor"])
    block(name + "_floor", (w, d, t), (0, 0, -t), fc)
    if ceiling: block(name + "_ceiling", (w, d, t), (0, 0, h), "#3A3442" if KIT["look"] == "previs" else "#5A5650")
    specs = [((w, t), (0, d / 2)), ((w, t), (0, -d / 2)), ((t, d), (w / 2, 0)), ((t, d), (-w / 2, 0))]
    for i, ((sx, sy), (x, y)) in enumerate(specs):
        if i in open_walls: continue   # 0=+Y 後,1=-Y 前,2=+X 右,3=-X

…

[已截斷以利翻譯]

Individual skills in this repo

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

ido6/ai-video-skills

Design cinematic image and video prompts for genmedia. Use this for shot language, camera movement, lighting, lens choices, color grade, film texture, scene blocking, and production-ready visual direction.

ido6/ai-video-skills

Elite cinematic-video-prompt discipline for idoGen (mcp__idogen__generate_video, WaveSpeed/fal/poyo Seedance 2.0 and 2.5, Veo 3.1, Kling 3.0). Adapted from a production studio's CINEDANCE prompt-director system, folded together with GenHQ classroom technique (camera-movement library, Seedance 2.0-vs-2.5 dialect split, Kling 3.0 burger + @tag binding, Omni Flash video-to-video lock/preserve-list, storyboard mode, UGC/organic mode). Use this WHENEVER writing or fixing a prompt for mcp__idogen__generate_video, or when the user wants a cinematic/consistent/high-budget-looking video shot, camera control, a specific lens feel, spatial blocking across multiple shots, a scene that must match a previous shot's geography/lighting/character, a named camera move, a Kling multi-shot sequence, an edit of existing footage (Omni-style), or an organic/UGC/phone-shot look. Trigger even without the word "CINEDANCE" — any idoGen video-prompt build or repair task qualifies. Companion skills: idogen-image-brain (references/plat...

ido6/ai-video-skills

Generate Seedance 2.5 prompts for **multishot omni reference mode** — sequences where multiple reference images (@Image1, @Image2, etc.), and optionally videos and audio, are assigned across different shots. Use this skill when the user says "multishot", "omni reference", "omniref", uploads multiple references for a shot sequence, or asks for a multishot Seedance prompt. Do NOT use for single-shot, first+last frame, or generic Seedance prompts — those are separate skills. If the user just says "Seedance prompt" without indicating multishot, ask first.

相關技能