Ice Motion Director
安裝

Ice Motion Director

給你的程式開發代理一位動態設計與影片導演。它會規劃、把影片寫成程式碼、算繪,最後親自檢查。

npx skills add Omar-Tnzxo/ice-motion-director -g --all

開源,Apache-2.0 授權,支援 Claude Code、Codex、Cursor、Gemini CLI 等 40 多種代理。

Ice Motion Director 的吉祥物 Ice:戴著深藍色導演貝雷帽的體素冰塊,坐在木製導演椅上,手拿場記板

一個需求,一條路線

一個路由技能先讀懂你的需求和專案,再把工作交給六種工作流程中最合適的那一種。

試試路由技能

「把這段 Podcast 錄音剪成三支直式短影音,加上阿拉伯文字幕。」

ice-edit你提供了要剪的素材

ice-film

從零開始做一支影片。一支完成的 MP4,加上一份交付報告。

ice-explainer

用旁白講解一件事。一支附字幕的旁白解說影片。

ice-remake

照這個樣子做。一支同樣風格、換上你內容的新影片。

ice-edit

剪輯你自己拍的素材。剪好的影片、字幕、直式版本。

ice-lottie

Lottie 與介面動態。Lottie JSON 或動態 SVG,加上給工程師的交接文件。

ice-ideas

動手之前先要點子。一組概念和一份腳本,隨時可以開工。

你

/ice-motion-director:ice 幫我的筆記 App 做一支 20 秒的上市影片。網站在這裡:<你的網址>

Ice

我看過你的網站,也查了你這個產業的廣告規範。還有兩個決定沒定案,每題的第一個選項是我的建議。

  1. 影片會在哪裡播放?直式,給社群用橫式,放網站方形三種都要
  2. 要有人聲旁白嗎?音樂加畫面文字旁白人聲加字幕無聲

接著我會提案、寫腳本、畫分鏡、動手製作。如果你在線上,正式製作前會先給你看一次風格影格。

/ice-04-storyboard

審查卡:分鏡

完成了什麼
選項與勝出者
考慮了三種開場。B 勝出:產品從第一秒就在畫面上。
評審意見
第 5 個鏡頭停太久;已剪短以對齊節拍。
尚未決定
片尾卡用珊瑚色還是深藍色。
下一步
說「核准,繼續」就會開始 /ice-05-look

為本頁撰寫的示意對話。

一句提示詞,或逐一走過每個階段

適合所有人

在 Claude Code 裡,第一則訊息以 /ice-motion-director:ice 開頭,再用你自己的話描述影片,長短都行;這個指令能確保導演一定會啟動,就算你還裝了其他影片技能也一樣。Ice 會先研究你的業務,再針對提示詞沒交代的每個決定發問:每題四個選項,建議的放第一個,每則訊息最多四題,要決定的事多就分成好幾則。如果提示詞已經涵蓋一切,或你說「不用問」,它就什麼都不問;否則它會等你的回覆,因為沉默絕不會被當成同意。接著,只有在你有空回覆時,才會給你看一次預覽(風格影格或動態分鏡),之後就一路做到最終檔案,不再發問。每個階段完成時,它會傳給你兩行說明和該階段的靜態畫格,不等你回覆,所以你的意見可以在途中傳到它那裡。它做的每個決定都會記錄下來,並在交付說明裡解釋。

適合想自己掌舵的人

一次跑一個階段,從 /ice-01-brief 到 /ice-10-deliver(在 Claude Code 中一定能用的寫法是 /ice-motion-director:ice-01-brief)。每個階段結束時都有一張審查卡:完成了什麼、有哪些選項以及為什麼選這個、評審意見、還沒定的選擇。要改幾次都可以;說「核准」就鎖定該階段,說「核准,繼續」就鎖定並開始下一個。/ice-status 會顯示目前進度。

提示詞的長短只決定由誰做每個決定,從不影響品質。隨時都能切換:在流程中間輸入某個階段指令,或輸入 /ice 讓它自己做完。

看看十個階段

十個階段,每支影片都一樣

每條路線都跑在同一條十階段主軸上,就像一間製作公司的做法。編號不變,順序則依影片類型調整。

影片類型
工作規模

以故事為主。 預設順序。04 和 05 並行,接著 07 製作的同時做 08a,08b 在初版上混音。

  1. 簡報

  2. 概念

  3. 腳本

  4. 分鏡視覺

  5. 動態分鏡

  6. 製作聲音

  7. 混音

  8. 審查

  9. 交付

十個階段全部執行,依此順序。同一步上的兩個區塊,在代理有子代理時會並行,沒有時就依序進行:04 分鏡與 05 視覺並行,接著 07 製作的同時進行 08a 聲音;08b 在初版上混音。到了階段 10,每種語言和畫面比例會同時算繪。

階段 01,簡報

先做研究:業務簡報(做什麼、受眾、產品真相、市場與競爭對手、品牌識別與真實素材、目前的行銷活動、語氣)、品牌素材計畫,以及產業和平台的廣告規範;接著是專案簡報,並針對每個未決定的事項發問:每題四個選項,每則訊息最多四題,必要時分成好幾則。

主要產出 ice/BRIEF.mdice/research/COMPLIANCE.mdice/assets/brand-sheet.jsonice/DIRECTION.md

規則來源 ice-direction 需求蒐集、ice-assets

在這個規模 完整主軸,精簡團隊,審查輪數依 ice-film 的團隊層級而定。

階段 01 在各條路線上的意義
ice-film創意簡報
ice-explainer創意簡報
ice-remake創意簡報加參考分析
ice-edit創意簡報加素材匯入
ice-lottie創意簡報
ice-ideas創意簡報

沒有兩支影片長得一樣

範本和示範只是參考,從來不是預設值。影片必須在六個軸向中至少四個與最接近的內建範本不同,才能往下走。你自己選定的風格(一個參考作品、一種指定風格、你品牌自己的識別)在它所決定的那些軸向上可以免除。

試試這條規則。勾選你的影片和最接近的範本有哪些不同:

6 項中 2 項

太接近範本。影片退回導演階段。

  • 研究日期就是今天

    每支影片都從全新的研究開始,只根據你的創意簡報。查詢詞若無法追溯到你的簡報,執行前就會被刪掉。

  • 發散式提案

    好幾個方向,至少兩個出乎意料,由另一位評審來評判。

  • 每支影片一個指紋

    每支完成影片的配色、字型和結構都存在你的電腦上,下一支就不能重複。

  • 預設風格關卡

    滿版藍紫色,而創意簡報裡沒有理由,影片自己的關卡就會判定不通過。

製作者從不替自己打分數

由獨立的評審角色審查分鏡、畫面、動態、聲音和匯出的檔案。每支影片都要依這個順序通過每道關卡。

Ice 用體素放大鏡檢查一條底片影格,場記板夾在手臂下
  1. 製作之前

    先做分鏡檢查和算繪前檢查,任何東西算繪前再出一張印樣表。

    檢查:分鏡與計畫

  2. 影格與接縫

    檢查影格與接縫、動態密度和空白時段,再對算圖結果本身做工藝關卡檢查,不讓任何地方停滯、跳動或缺漏。

    檢查:每一格畫面

  3. 粗製濫造掃描

    掃描粗製濫造和簡報投影片感,在你之前先揪出制式的 AI 樣貌。

    檢查:視覺風格

  4. 預設風格關卡

    整支影片被藍色和紫色主導,而創意簡報裡沒有理由,就不通過。

    檢查:配色

  5. 距離與指紋

    檢查與範本的距離,並用指紋和你先前的影片比對。

    檢查:雷同度

  6. 文字與聲音

    字幕與同步驗證,對匯出檔的音量和規格檢查,再做混音稽核,證明每個音效都聽得到,並附上一份讓你用耳朵確認的短清單。

    檢查:匯出的檔案

  7. 陌生人的眼光

    從沒看過簡報的新觀眾必須看得懂這支影片,品牌影片在隨機抽取的畫面裡也要認得出是那個品牌,高潮還要與一個參考作品比較。

    檢查:觀眾

  8. 交付說明

    算繪核准,以及一份每項說法都附有實測數據的交付報告。

    檢查:ice/review/NOTE.md

檢查直接量測算繪出的影片本身:節奏、景深、收尾處理、調色、固定標誌、說話者的光線,以及每個音效是否真的聽得到。交付報告裡的每項說法都附有實測數據,記在 ice/review/NOTE.md。

每支影片都是程式碼

HTML、CSS、GSAP、Remotion、Lottie 或 FFmpeg。影片每次算繪結果都相同,一般筆電就能跑,不需要 GPU,也不需要付費影片模型。

不會生成任何素材畫面。文字、數字和標誌一律用程式碼排出,和你核准的完全一樣。每支影片各自選擇引擎:

  • HyperFrames
  • Remotion
  • HTML canvas 搭配 Playwright 和 FFmpeg
  • Three.js
  • Lottie
  • p5
  • 只用 FFmpeg

真實品牌,用真實素材

影片的主角是真實的公司、產品或 App 時,Ice 會先做研究並蒐集真實素材:網站和 App 的實際擷取畫面、官方品牌素材包、從官網讀出的顏色和字型、原封不動的標誌。品牌的樣貌絕不靠猜;拿不到素材時,它會直說並詢問你。影片裡不會燒錄「非官方」字樣,也不會燒錄 AI 標示:如果是為你並未任職的品牌做的概念片,這行字會放進交付說明和建議的貼文說明文字裡。

your-project/  ice/    state.json路線、目前階段、時間戳記    BRIEF.md每一欄都註明來源    DIRECTION.md每個決定、它的選項和理由    research/標有日期的研究筆記    plan/腳本、分鏡、鏡頭計畫、音效提示表    review/NOTE.md交付報告,附實測數據    renders/final/影片和它的各個版本
所有東西都放在專案的 ice/ 資料夾裡,任何工作階段都能從上次停下的地方接著做。

阿拉伯文是一等公民

只要影片使用阿拉伯文,或與其他語言混排,從第一個文字決定開始就套用阿拉伯文與右至左書寫的規則。

مـخـرج

فيلم لتطبيق Notes مدته ٢٠ ثانية

مخرج 的意思是導演。Kashida 只在阿拉伯文允許的連接處拉長字詞;下面那一行混排拉丁名稱和數字,閱讀順序也不會亂。
  • 動態中的字形與點
  • Kashida,在正確的連接處拉長
  • 混排行的雙向隔離
  • 阿拉伯印度數字或西式數字
  • 斷行與阿拉伯文字幕
  • 阿拉伯文的安全區與封面字級
  • 選字型時逐一檢查各語言
  • 腳本和旁白可設定方言
  • 語音辨識只用來對時間

156 種風格,一個指令

輸入 /ice-style 依風格家族瀏覽風格庫,或指定一種風格並說明影片主題,直接用它開始一支影片。

預設風格只鎖定視覺家族。創意簡報、研究、概念和品質關卡照樣執行,所以影片不會是該風格示範的翻版。

Satellite Briefing

真實、授權乾淨、帶地理座標的衛星或空拍影像,調暗成分析師的……

最適合 環境隨時間的變化、距離與比例、調查報導……

來源 lemo-opuscar (LemoLab)

用這個風格開始

/ice-style satellite-briefing <你的影片在講什麼>

每種代理都能安裝

一行指令就能裝進你電腦上找得到的每個代理。主要代理另有原生外掛安裝方式,每種代理和作業系統也都有手動複製的路徑。

任何代理

Claude Code、Codex、Cursor、Gemini、Copilot、Windsurf、Cline、Roo、Kilo、OpenCode、Antigravity、Amp、Goose、Kiro、Qwen、Trae、Zed、Warp 等等。

npx skills add Omar-Tnzxo/ice-motion-director -g --all
  • 它會把每個 Ice 技能裝進你電腦上找得到的每個代理,過程不會發問。
  • 請全部安裝:技能之間會互相呼叫,只挑一部分會讓流程中斷。
  • 需要 Node 22.20 以上版本。之後用 npx skills update 更新。

Claude Code

從任何 shell 以外掛形式安裝。

claude plugin marketplace add Omar-Tnzxo/ice-motion-director
claude plugin install ice-motion-director@ice-motion-director
  • 在工作階段內:先執行 /plugin marketplace add Omar-Tnzxo/ice-motion-director,再執行 /plugin install ice-motion-director@ice-motion-director。

Claude.ai 與桌面版

依序開啟 Customize、Plugins、Add、Add marketplace,輸入 Omar-Tnzxo/ice-motion-director。

  • 請先在 Settings 的 Capabilities 開啟 Code execution and file creation。
  • 在外掛頁面按 Check for updates 即可更新。
  • 在那裡能做的:創意簡報、研究、概念、腳本和分鏡。算繪需要電腦上的瀏覽器和 FFmpeg,聊天的程式碼沙箱不一定有(未經驗證),所以請用 Claude Code 這類本機代理來算繪影片。

Codex

CLI 和應用程式。

codex plugin marketplace add Omar-Tnzxo/ice-motion-director
codex plugin add ice-motion-director@ice-motion-director
  • 或在 Codex 執行 /plugins 並從那裡安裝,然後開一個新的工作階段。
  • 更新:codex plugin marketplace upgrade ice-motion-director。Codex 應用程式則用 Plugins 分頁。

Cursor

為 Cursor 安裝技能。

npx skills add Omar-Tnzxo/ice-motion-director -a cursor

Gemini CLI 與 Antigravity

Gemini CLI 擴充功能和 Antigravity CLI 外掛。

gemini extensions install https://github.com/Omar-Tnzxo/ice-motion-director
agy plugin install https://github.com/Omar-Tnzxo/ice-motion-director
  • Gemini 用 gemini extensions update ice-motion-director 更新;Antigravity CLI 則再執行一次同樣的 agy 指令。
  • Antigravity 應用程式和 IDE:npx skills add Omar-Tnzxo/ice-motion-director -a antigravity。

GitHub Copilot

CLI 和 VS Code。

copilot plugin marketplace add Omar-Tnzxo/ice-motion-director
copilot plugin install ice-motion-director@ice-motion-director
  • VS Code:開啟命令選擇區,選 Chat: Install Plugin From Source,貼上 https://github.com/Omar-Tnzxo/ice-motion-director。
  • 更新:copilot plugin update ice-motion-director。

Qwen Code

以擴充功能形式安裝。

qwen extensions install Omar-Tnzxo/ice-motion-director
  • 更新:qwen extensions update ice-motion-director。

其他所有代理

Windsurf、Cline、Roo Code、Kilo Code、OpenCode、Amp、Goose、Kiro、Trae、Zed、Warp、Augment 等等。

npx skills add Omar-Tnzxo/ice-motion-director -a <agent>
  • 代理 id:windsurf、cline、roo、kilo、opencode、amp、goose、kiro-cli、trae、zed、warp、augment。
  • 每種代理、每種作業系統的手動複製路徑,都在儲存庫的安裝對照表裡。

你的電腦需要什麼

代理會依你選的路線檢查這些項目,並告訴你缺什麼,附上適合你系統的那一行指令。路線需要的免費套件和模型,由它自己以固定版本安裝,並在交付說明中列出;任何要付費或要註冊帳號的東西,會先問你。點子和腳本什麼都不需要。Lottie 需要 Node。每支要交付的影片(影片、解說、仿作和剪輯)都需要 Node、FFmpeg、瀏覽器,以及裝好品質檢查套件的 Python 3:沒有 Python,影片做得出來但無法交付,因為豐富度檢查跑不了。

Windows 的安裝指令
需求指令
Node.js(LTS)winget install --id OpenJS.NodeJS.LTS -e
FFmpegwinget install --id Gyan.FFmpeg -e
Chrome 或 Chromiumwinget install --id Google.Chrome -e
Python 3winget install --id Python.Python.3.13 -e

Windows 注意事項

  • 每個指令在 PowerShell 和 cmd 中用法都一樣。
  • 如果 PowerShell 說已停用指令碼執行,請改用 npx.cmd skills add,或用 Set-ExecutionPolicy -Scope CurrentUser RemoteSigned 為你的使用者帳戶開放一次。
  • --all 在 PowerShell 和 cmd 中用法相同(在 cmd 中 --skill '*' 無效,要寫成 --skill "*")。
  • 在 WSL 中,只有當你的代理也在 WSL 裡執行時,才在 WSL 內安裝。
macOS 的安裝指令
需求指令
Node.js(LTS)brew install node@24
FFmpegbrew install ffmpeg
Chrome 或 Chromiumbrew install --cask google-chrome
Python 3brew install python
Ubuntu 或 Debian 的安裝指令
需求指令
Node.js(LTS)nvm, then nvm install --lts
FFmpegsudo apt install ffmpeg
Chrome 或 ChromiumChrome .deb or sudo snap install chromium
Python 3sudo apt install python3 python3-venv
Fedora 的安裝指令
需求指令
Node.js(LTS)sudo dnf install nodejs
FFmpegsudo dnf install ffmpeg-free
Chrome 或 Chromiumsudo dnf install chromium
Python 3sudo dnf install python3
Arch 的安裝指令
需求指令
Node.js(LTS)sudo pacman -S nodejs npm
FFmpegsudo pacman -S ffmpeg
Chrome 或 Chromiumsudo pacman -S chromium
Python 3sudo pacman -S python

確切的最低版本記在 skills/ice-engines/references/versions.json。每種代理的手動複製路徑:安裝對照表。

它不做的事

  • 它不拍實景。 它剪輯你提供的素材,其餘一切都用程式碼做成動態設計。
  • 它不是寫實 CGI 或角色動畫工作室。 複雜的角色綁定、對嘴和高度寫實的 3D 不在它的範圍內;風格化 2D、動態文字、拼貼、像素、手繪和輕量 3D 才是它的主場。
  • 它不是 AI 影片生成器。 AI 圖片、影片或語音是你可以要求的選配,從來不是主要引擎。文字、數字和標誌一律用程式碼排出。
  • 它不會捏造真實品牌的事實。 真實品牌用真實素材;拿不到的東西,它會向你要。

隱私與網路

  • 在本機執行。 影片在你的電腦上,用你的瀏覽器和 FFmpeg 算繪。這些技能不會上傳任何東西。
  • 所有網路連線都會告知。 為了決定方向而做的網路研究(透過你代理本身的搜尋工具);代理自己挑選並下載的免費真實素材(音樂、音效、影片素材、照片、旗幟、地圖、字型),來源是公開素材庫和官方來源,每一項都會連同來源和授權狀態記錄在你的專案裡,其中具名公眾人物的肖像和官方旗幟會透過 Wikidata 和 Wikimedia Commons 查找,並且會先搜尋你自己的素材庫資料夾(sources.json 中的 local_libraries);Ice 自己的 CC0 音效包(128 個錄製的音效),只從專案的 GitHub Release 下載一次,並以 SHA-256 檢查;以固定版本安裝免費工具和模型,並在交付說明中列出;所選字型來自 Google Fonts 時,會從那裡下載。可以用 --offline 或 ICE_OFFLINE=1 關閉下載,也可以在 ~/.ice-motion-director/sources.json 設定成下載前先詢問。在大量下載和算繪之前,它會檢查可用的磁碟空間,並改在空間足夠的磁碟上作業。
  • 選用功能,只在你要求時啟用。 AI 圖片、影片或語音生成,雲端語音轉文字或 TTS。這些可能要付費,沒有你點頭絕不使用。
  • 本機記憶。 一個小小的指紋檔 ~/.ice-motion-director/fingerprints.jsonl 會記下每支完成影片的配色、字型和結構,讓下一支不會重複。隨時都可以刪掉。
  • 不蒐集使用數據。
  • 直接複製,保留原授權條款
  • 只取概念,用我們自己的話改寫
  • 非商業資料夾,各有授權
  • 隨附原有授權條款
  • 創辦人自己的技能

完整細節、用了什麼、放在哪裡:CREDITS.md。原始授權條款全文:LICENSES/。

常見問題

Ice 戴著深藍色體素耳機,雙手扶著耳罩,場記板立在腳邊

不需要。影片以程式碼寫成,在一般筆電上用瀏覽器和 FFmpeg 算繪。

可以,你做的影片屬於你。少數名為 noncommercial/ 的內建資料夾採用原作者的非商業授權;工作流程會檢查你專案中關於商業用途的回答,商業案就會略過它們。它找到的或你提供的外部素材(素材畫面、音樂、標誌)會連同授權狀態寫進交付說明;發布前釐清這些權利是你的責任。

ice-engines 會為每支影片挑選:HyperFrames、Remotion、HTML canvas 搭配 Playwright 和 FFmpeg、Three.js、Lottie、p5,或只用 FFmpeg。部分企業使用 Remotion 需要公司授權;遇到這種情況,技能會告訴你。

說「你幫我決定」或「不用問」就好。它會自己選,把每個理由記在 ice/DIRECTION.md,並在交付報告裡列出每個選擇,你回一則訊息就能改掉其中任何一個。如果你就是不回覆,它會一直等:沉默絕不會被當成同意。

代理會依你選的路線檢查,並告訴你缺什麼,附上適合你系統的那一行指令。路線需要的免費套件和模型(轉錄、音軌分離等)會由它自己以固定版本安裝,並在交付說明中列出;任何要付費或要註冊帳號的東西,會先問你。點子和腳本什麼都不需要。Lottie 需要 Node。每支要交付的影片都需要 Node、FFmpeg、瀏覽器和 Python 3。

你要做的:在 Claude Code 輸入一句以 /ice-motion-director:ice 開頭的提示詞,再回答每個未決定事項的問題(每題四個選項,每則訊息最多四題;提示詞已涵蓋一切或你說「不用問」就不會問),如果你在線上,還有一次預覽,你可以在預覽時聽到疊在影片上的兩三首真實音樂選項,並挑一首(三首,除非你在 sources.json 把 music_options 設為 2)。執行期間,每個階段都會以兩行說明加靜態畫格傳給你,所以你可以中途介入。在背後,你的代理會帶著好幾個輔助代理跑完十個階段,所以就算是短廣告也要跑一陣子,用掉的方案額度也遠多於一次聊天回答。如果代理中途碰到用量上限,晚點再輸入 /ice:它會依 ice/state.json 從中斷處接著做。

是。Ice Motion Director 以 Apache-2.0 授權開源。名為 noncommercial/ 和 vendor/hypit/ 的資料夾保留各自的授權條款,寫在資料夾裡。

給你的代理一位導演

貼上一行指令,再用白話要一支影片。Ice 會從創意簡報一路做到交付,在你想看的每一步都讓你看到它的成果。

npx skills add Omar-Tnzxo/ice-motion-director -g --all
Ice 打開場記板,準備喊開拍