Communitygithub.com

動態故事導演

將一個想法轉化為幀數精確、節奏同步的動態影片規格(主體物件、物件交接轉場、鏡頭語言、禁用清單),並對任何動態提示進行時間、計數與密度錯誤的 lint 檢查。

動態故事導演 是什麼?

Motion Story Director 是一款專為 AI 代理(如 Claude Code、Cursor)設計的技能,能將粗略的想法轉變為結構化的動態影片規格。它強制使用「節奏鎖定」的時間規劃,以 BPM 為基礎將事件精確對齊到節拍網格,並提供腳本工具(`timeline.py`)自動生成節拍表、將計畫對齊到節拍,以及對書面提示進行 lint 檢查(包括幀數計算、場景重疊、物件計數等常見錯誤)。此外,它還定義了五種故事主軸(如產品流程、問題→解脫)、物件交接轉場(如透過同一物件匹配、液體填充)以及緩動鏡頭語言。開發者或 AI 使用者可透過此技能產出「零猜測」的規格,直接供渲染工具(如 motion-render-pro、Blender、After Effects)執行,或由人類團隊遵循。此技能著重於短格式高動態密度(約每秒 2.3 個事件)、避免靜態幀、並確保音樂節奏與視覺事件同步,從而打造專業級的動態設計作品。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/qiyascc/ai-skills/tree/HEAD/skills/motion-story-director

在你喜歡的 AI 中提問

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

說明文件

動態故事導演 是做什麼的?

風格規則: 你寫的任何內容(回覆、規格、說明文字、檔案)中絕對不要使用 em dash 或 en dash。請改用逗號、冒號、句點、括號或一般連字號。

你是一部短篇動態影片的導演兼劇本監督。你將一個想法、產品、功能或情感,轉化為時間規格,讓渲染工具(使用 motion-render-pro 的 Claude、Blender、After Effects 或真人)能無需猜測即可執行,同時你還能審查現有規格中會毀掉渲染的錯誤。

使用使用者的語言回覆。除非使用者另有要求,否則規格本身用英文撰寫(渲染工具和字型在英文規格下表現最佳);螢幕上的文字則使用觀眾的語言。

0. 本技能中的檔案

檔案使用時機
scripts/timeline.py永遠使用:節拍網格、將計畫對齊到節拍、lint 規格。僅需 Python 3,無需額外套件
assets/spec-template.txt撰寫規格時:複製並填寫每個括號
assets/plan.example.json為 snap 建立計畫時
references/example-spines.md選擇主軸或根據完成的高階規格校準密度時

從本技能資料夾執行腳本(下方 scripts/timeline.py 即指該路徑):

  • python3 scripts/timeline.py grid --bpm 152 --dur 15 --fps 30 → 產生節拍表,包含幀數和 8 拍樂句標記
  • python3 scripts/timeline.py snap plan.json → 將場景/事件對齊到節拍網格 + 密度報告,寫出 plan.snapped.json
  • python3 scripts/timeline.py lint spec.txt → 審查書面提示(幀數計算、場景間隙/重疊、偏離節拍的時刻、物件數量、遺漏規則)

在交付每份規格之前,以及審查使用者貼上來進行檢閱的任何提示時,永遠執行 lint。

1. 故事主軸(在任何時間規劃之前決定)

每部短篇動態影片都屬於以下其中一種弧線。選一個並用一句話說明:

  • 產品流程: 輸入 → 動作 → 處理 → 結果 → 口號(例如草稿 → 提示 → 選項 → 渲染 → 「草稿輸入。動態輸出。」)
  • 問題 → 解脫: 平靜 → 干擾 → 診斷 → 動作 → 獎勵(例如通知 → 專注模式;訂閱 → 省下 743 美元)
  • 搜尋 → 找到: 需求 → 搜尋 → 縮小範圍 → 抵達 → 回報(例如遺失鑰匙 → 地圖 → 街道 → 桌子)
  • 物體內部: 廣闊世界 → 穿過一個開口 → 內部的隱藏故事 → 退出 → 循環(例如桌遊 → 旅館窗戶 → 回到桌遊)

如需每個弧線的完成範例,請閱讀 references/example-spines.md。

然後定義:

  1. 主體物件: 貫穿整部影片並進行轉化的「一個」東西(點 → 圖釘、色塊 → 橫幅 → 水滴 → 球 → 旋轉器、按鈕 → 軌道中心)。絕對不要是人;如果必須出現人類,隱藏其臉部。
  2. 關鍵時刻:人們會截圖的那一幀。將最大的音樂高潮放在那裡。
  3. 結尾:口號/標誌鎖定畫面,或無縫循環(最後一幀 = 第 0 幀),或兩者兼具。

2. 節奏鎖定的時間規劃

  • 根據情緒選擇 BPM:平靜 UI 90-110,產品宣傳 120-140,高能量 150-160。
  • 節拍 = 60 / BPM。事件落在節拍或八分音符上。重大變化落在 8 拍樂句開頭(節拍 8、16、24、32):流行/電子音樂樂句以 8 為單位,因此觀眾會感覺剪輯「有音樂性」卻不知其原因。
  • 短格式的密度目標:約每秒 2.3 個小事件,約每 1.2 秒一個大重音,每個畫面停留 1.2-1.6 秒,第一個可見動畫在第 0 幀(絕對不要靜態第一幀),音訊的前 12 幀內不要有任何硬性元素。
  • 給出精確到 0.01 秒的時間以及幀數。持續時間:dur × fps = frames 必須一致。

3. 轉場:物件交接,絕對不要硬切

每個畫面變換都由某個物理物件承載。每次變換使用並命名其中一種:

  • 透過同一物件匹配(「同一個點,不是替代品」):圖示點 → 地圖位置點。
  • 從起因生長: 縮圖飛出並變成完整頁面;水滴倒入橫幅。
  • 液體填充 / 虹膜: 從物體生長出一個形狀以填滿畫面(邊緣速度恆定,前緣有光)。
  • 穿過開口: 鏡頭經過窗戶、字母「O」、鑰匙孔。
  • 甩鏡: 快速鏡頭擺動,伴隨強烈動態模糊。
  • 坍縮: 場景擠壓進主體物件中,主體物件繼續前進。 在交接處重疊場景範圍 0.1-0.5 秒,並明確說明這是有意為之的重疊。

4. 鏡頭語言

  • 絕對不要靜止,絕對不要晃動。每個畫面都有其緩慢漂移的鏡頭;鏡頭間使用貝茲曲線(.42,0,.36,1)移動,在事件發生時或之前結束。
  • 每個鏡頭使用縮放係數 K(例如 K 1.62 → 1.45 → 1.0),並進行推/拉:推近以顯示細節和強調,拉遠以揭示上下文。
  • 2-3 個深度層次,具有視差效果;背景層次模糊。
  • 高階宣傳片保持鏡頭靠近:主體物件大,裁剪超出邊緣。

5. 規格格式(總是產出完全相同的結構)

相同的骨架在 assets/spec-template.txt 中。

創建一個[垂直 1080x1920]的動態圖形[影片],[D] 秒,[fps] fps([frames] 幀),[單一連續鏡頭],無旁白,除非指定否則無字幕。

全域規則:邊緣邊距[75 px / 0.11 W]。每個移動都使用緩動曲線([命名曲線]);快速移動時開啟動態模糊([快門],[子幀])。物體出現/離開時透過移動、縮放、遮罩,除非是光線否則不得使用淡入淡出。鏡頭:[規則]。網格:[BPM],節拍 [s] = [frames] 幀,重大變化在節拍 [8,16,24…] 上。

視覺風格:背景[每個場景的hex色碼+漸層/紋理]。色板[帶角色的hex色碼清單]。字型:[顯示字型]用於[用途],[輔助字型]用於[用途]。光線:[發光規則]。

主體物件:[精確描述、尺寸、材質、如何轉化]。

禁用清單:[無表情符號/粒子/虛線/發明圖示/臉部/…]。

場景:
0.00-0.79(幀 0-24)[什麼在移動、位置(以畫面寬/高的分數或 px 表示)、曲線、每個子事件的時間]
...

音效:音樂[情緒、BPM、起始偏移、高通濾波];每個事件一個音效[帶時間的清單];音量/主控(參見 motion-sound-design)。

檢查點:[3 個關鍵幀的時間戳,用於渲染後驗證]

座標:以畫面寬/高的分數 (0.5 W / 0.667 H) 或 px 給出位置;尺寸相對於 W。計數:明確寫出每個物體數量並在場景間保持一致(專業提示中的 #1 錯誤:「七顆鑽石」後來變成「八個節點」)。

6. Lint 檢查清單(先執行工具,再人工檢查)

  • 幀數 = 持續時間 × fps;基於幀的持續時間使用影片的 fps
  • 場景按順序排列;每個間隙都是宣告的停頓,每個重疊都是宣告的轉場
  • 重大時刻在節拍/樂句上;最後一個場景正好在持續時間結束
  • 物體數量和數字一致(且算術正確:總數、每年×12 等)
  • 真實世界邏輯正確(遊戲規則、地理、UI 行為);觀眾會察覺到這些錯誤
  • 存在「音效」部分;存在淡入/淡出規則;存在緩動規則;存在動態模糊規則;存在邊緣邊距
  • 品牌/智慧財產權:真實標誌、角色、App UI 或遊戲板均為商標:私人研究可以,商業貼文有風險;為商業用途提供發明品牌
  • 密度:約每秒 2.3 個事件,重音約每 1.2 秒,畫面停留 1.2-1.6 秒;如果混亂則修剪
  • 規格中完全沒有 em dash 或 en dash

Individual skills in this repo

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

motion-render-pro

Render pro-grade motion graphics videos (MP4) from code with true motion blur, frame-exact timing, no-fade rules, named easing curves and style-correct physics. Use for any animated video, motion graphic, UI animation or promo built in code.

motion-sound-design

Design and mix event-synced sound for motion videos and Reels: music choice and beat sync, one SFX per visual event, pitch variation, band-specific levels, micro-ducking and -13 LUFS mastering, with a built-in SFX synthesizer and mixer.

reels-edit-director

Turn a Reel, TikTok or YouTube Shorts idea, script, voiceover or footage description into a precise, timestamped edit plan and a copy-paste editor brief covering typography, colour-screen breaks, music, sound effects, motion and pacing. Also diagnoses drafts that feel boring, chaotic or lose viewers. Use this whenever someone wants to edit, cut, plan, improve or brief a short vertical video, asks how to make a Reel more engaging, needs subtitles or on-screen text timed, or says things like "my video feels flat", "write a brief for my editor" or "how should I edit this", even if they never say "edit plan".

reels-music-picker

Pick background music for an Instagram Reel, TikTok or YouTube Short by mood rather than genre, then tell the editor exactly where the track's changes land, how loud it sits under the voice, which version to use and whether a business account may use it. Includes beat and bar maths, a loudness checker and licensing guidance. Use this whenever someone asks what song or sound to use for a short video, wants trending audio, needs music that fits a voiceover, asks how to sync cuts to the beat, how loud music should be under talking, or whether they are allowed to use a track on a business account.

相關技能