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:一块戴着深蓝色导演贝雷帽的体素冰块,坐在木制导演椅上,手拿场记板

一个需求,一条路线

一个路由技能读懂你的需求和项目,然后只交给六个工作流中的一个。

试试路由

“把这段播客录音剪成三条竖屏短视频,配阿拉伯语字幕。”

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

ice-film

从零开始做一支短片。成品 MP4 加一份交付报告。

ice-explainer

用声音讲清一件事。带字幕和旁白的讲解视频。

ice-remake

照这个样子做。用你的内容、按那种风格做的新短片。

ice-edit

剪辑你自己的素材。剪好的片子、字幕、竖屏版本。

ice-lottie

Lottie 和 UI 动效。Lottie JSON 或动画 SVG,外加开发交接说明。

ice-ideas

动手之前先要创意。一组概念和一份脚本,可直接开做。

你

/ice-motion-director:ice 为我的笔记应用做一支 20 秒的发布短片。网站在这里:<你的网址>

Ice

我看过你的网站和你所在行业的广告规则。还有两个决策待定;每个问题的第一个选项是我的推荐。

  1. 在哪里播放?竖屏,用于社交平台横屏,用于网站方形三种都要
  2. 要不要人声?音乐加屏幕文字旁白人声加字幕无声

接着我会提案、写脚本、画分镜并构建。如果你在场,会在完整构建前看一次风格帧。

/ice-04-storyboard

审核卡片:分镜

做了什么
备选方案与胜出者
考虑了三种开场。B 胜出:产品从第一秒就出现在画面上。
评审意见
第 5 个镜头停留太久;已剪短以卡上节拍。
仍待决定
片尾卡用珊瑚色还是深蓝色。
下一步
说“approved, go on”即可开始 /ice-05-look

为本页编写的示例会话。

一句提示词,或逐个阶段

人人都会用

在 Claude Code 中,第一条消息以 /ice-motion-director:ice 开头,然后用你自己的话描述短片,长短都行;即使装了其他视频技能,这条命令也能确保导演启动。Ice 先调研你的业务,再就提示词里没说清的每个决策向你提问:每个问题 4 个选项,推荐项排第一,每条消息最多 4 个问题,待定决策多时会分几条消息问。如果提示词已经说全了,或者你说“别问了”,它就什么都不问;否则它会等你的回答,因为沉默永远不会被当作同意。接着,只有在你能回应时,它才给你看一次预览(风格帧或动态分镜),之后就一路做到最终文件,不再提问。每个阶段完成时,它会发来两行说明和该阶段的静帧,不等你回复,所以你的意见可以在中途传达给它。它做的每个决定都有记录,并在交付说明中解释。

适合想亲自把控的人

一次运行一个阶段,从 /ice-01-brief 到 /ice-10-deliver(在 Claude Code 中始终可用的写法是 /ice-motion-director:ice-01-brief)。每个阶段结束时都有一张审核卡片:做了什么、有哪些方案以及为什么选这个、评审意见、仍待决定的选项。想改多少次都行;说“approved”锁定一个阶段,说“approved, go on”锁定并开始下一个。/ice-status 显示你当前所处的位置。

提示词的长短只决定由谁来做每个决策,从不影响质量。你随时可以切换:在运行中途输入某个阶段命令,或输入 /ice 让它自己做完。

查看十个阶段

十个阶段,每支短片都一样

每条路线都运行在同一条十阶段主干上,就像制作公司那样工作。编号不变;顺序随短片类型而变。

短片类型
任务规模

以故事为主导。 默认顺序。04 和 05 并行,接着 07 构建的同时制作 08a,08b 在草稿上混音。

  1. 简报

  2. 概念

  3. 脚本

  4. 分镜视觉

  5. 动态分镜

  6. 构建声音

  7. 混音

  8. 审核

  9. 交付

全部十个阶段按此顺序运行。同一步上的两个方块,在智能体支持子智能体时并行运行,不支持时依次运行:04 分镜与 05 视觉并行,然后 07 构建的同时进行 08a 声音;08b 在草稿上混音。到第 10 阶段,每种语言和画幅比例并行渲染。

阶段 01,简报

先做调研:业务简报(做什么、受众、产品真相、市场和竞品、品牌识别和真实素材、当前的推广活动、语气),品牌素材计划,以及行业和平台的广告规则;然后是项目简报,并就每个待定决策提问:每个问题 4 个选项,每条消息最多 4 个问题,必要时分几条消息问。

主要产出 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简报

没有两支短片长得一样

模板和演示只是参考,从不是默认值。一支短片必须在六个维度中至少四个上与最接近的内置模板不同,才能进入下一步。你自己选定的风格(一个参考、一个点名的风格、你品牌自己的识别度),在它所固定的维度上不受此限。

试试这条规则。勾选你的短片与最接近的模板相比改了哪些:

2 / 6

离模板太近。短片退回导演环节重做。

  • 以今天为准的调研

    每支短片都从一次全新的调研开始,只依据你的简报。任何追溯不到简报的检索词都会在运行前被剔除。

  • 发散式提案

    多个方向,其中至少两个出人意料,由一位独立评审来评判。

  • 每支短片一个指纹

    每支完成的短片的配色、字体和结构都存在你的电脑上,下一支就不能重复它们。

  • 默认风格关卡

    满屏蓝紫色、而简报里又没有理由,短片就过不了自己的关卡。

构建者从不给自己打分

独立的评审角色分别审核分镜、画面、动态、声音和导出的文件。每支短片都要按这个顺序通过每一道关卡。

Ice 用体素放大镜检查一条胶片帧,场记板夹在胳膊下
  1. 构建之前

    分镜检查和渲染前检查,然后在任何渲染开始前出一张缩略图总览。

    检查分镜和计划

  2. 画面与接缝

    检查画面和镜头接缝、动态密度和空档,再对渲染结果本身做工艺关卡检查,确保没有卡顿、跳帧或缺失。

    检查每一帧

  3. 粗制滥造扫描

    粗制滥造扫描和 PPT 感扫描,抢在你之前揪出千篇一律的 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

真实品牌使用真实素材

当短片讲的是真实的公司、产品或应用时,Ice 会调研它并收集真实素材:网站和应用的实时截取、官方品牌套件、从其官网读取的颜色和字体、原样使用的标志。品牌的视觉风格从不靠猜;拿不到素材时,它会直说并向你要。成片里不会烧录“非官方”字样,也不会烧录 AI 标注:如果是为你并不供职的品牌做的概念片,这行字会写进交付说明和建议的帖子文案里。

your-project/  ice/    state.json路线、当前阶段、时间戳    BRIEF.md每一项都注明来源    DIRECTION.md每个决策、备选方案和理由    research/附日期的调研笔记    plan/脚本、分镜、镜头计划、声音提示表    review/NOTE.md附实测数据的交付报告    renders/final/短片及其各个版本
所有内容都放在项目里的 ice/ 文件夹中,所以任何会话都能从上一次停下的地方继续。

阿拉伯语是一等公民

只要短片使用阿拉伯语,或把阿拉伯语与其他语言混用,阿拉伯语和从右到左的规则就会从第一个文字决策开始生效。

مـخـرج

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

مخرج 的意思是导演。Kashida 只在阿拉伯语允许的连接处拉伸单词;下面一行混排了拉丁文名称和数字,阅读顺序不会被打乱。
  • 动画中的字形和字母点
  • Kashida,在正确的连接处拉伸
  • 混排行的 bidi 隔离
  • 阿拉伯-印度数字或西方数字
  • 断行和阿拉伯语字幕
  • 阿拉伯语的安全区和封面字号
  • 按语言检查的字体选择
  • 方言作为脚本和旁白的设置项
  • 语音识别只用于卡时间

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 extensions update ice-motion-director 更新 Gemini;再次运行同一条 agy 命令即可更新 Antigravity CLI。
  • 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 开头的提示词,然后回答每个待定决策的问题(每个问题 4 个选项,每条消息最多 4 个问题;如果提示词已说全或你说“别问了”,就一个都没有),如果你在场,再看一次预览,同时试听叠在短片上的两三个真实音乐选项并选定一个(三个,除非你在 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 打开场记板,准备喊“开拍”