先说问题:做不出想要的效果,往往是不知道它「叫什么」
用 AI 做视频、做动效的人,多半都经历过这种憋屈:脑子里画面清清楚楚——标题从下方遮罩里滑出来、镜头贴着地面慢慢推近、页面滚动时元素一个接一个淡入——可真到写提示词的时候,只剩下「那个……就是那个效果」。
于是提示词越写越长,全是形容词和比方:「像电影里那种慢慢靠近的感觉」「炫酷一点的入场动画」「高级感的转场」。模型收到这种描述,只能靠猜,猜出来的东西和脑子里的画面对不上,又说不清到底差在哪一句话上,只能重抽。
motion-prompt 作者在仓库里讲了这个项目的由来:他发过几条给动态图形动作和镜头运动命名的短视频,评论区很多人说,卡住自己的不是没想象力,而是不知道这种运动「叫什么名字」。这句话点破了整件事:专业创作者和 AI 之间缺的不是工具,是一套共同语言。剪辑师跟导演说「dolly in」,双方都知道是轨道推镜、不是变焦;你跟 AI 说不出这个词,就只能用一整段形容去碰运气。
本篇主线:先看清它解决什么问题 → 拆开这套 216 个名字的词库长什么样 → 三种用法逐个上手 → 讲清「名字+四要素」的点单方法 → 安装三路线与排障。
项目地址:https://github.com/showheyohtaki/motion-prompt ,在线画廊:https://showheyohtaki.github.io/motion-prompt/
它是什么:一套给 AI 点单用的名字库
motion-prompt 不是生成工具,它本身不产出任何视频或图片。它是一部带动态样片的词典:把创作者平时要向 AI「点单」的东西——动态图形动作、镜头运动、转场、UI 组件、网页动效、照片观感、生图画风——逐个起上正式名字,每个名字配三样东西:
- 一段会动的样片。不是静态截图,名字对应的动作直接在画廊里动给你看,所见即所得。
- 一句话释义。这个名字到底指什么,一行说清,不用猜。
- 一句点单例句。向 AI 提出这个要求时,话应该怎么说,现成的句子可以直接抄改。
全库共 216 个名字,分 9 套词包,每套 24 个,编号从 001 排到 216。所有名单都有五种语言版本:英语、日语、西班牙语、简体中文、繁体中文——查中文名、抄英文名去喂视频模型,两种需求都照顾到了。在线画廊里每个样片都能动,名单也可以直接在 GitHub 的 packs/ 目录里读。
它还有一层身份:仓库里带了一个同名 Skill(技能包),装进编程助手之后,助手能直接打开画廊、接收你的点选、把选中的效果做进你的项目里。所以它既是一本可以裸读的词典,也是一个能装进 Agent 的工作流组件。词典这层定位和 提示词工程 里讲的「把模糊意图翻译成模型能执行的描述」是一回事,只不过它把翻译工作提前做成了现成的名录。
九套词包速览
先用一张表把 9 套词包对齐,查的时候按需求翻对应的包就行:
| 编号 | 词包 | 内容 | 典型用途 |
|---|---|---|---|
| 001–024 | motion | 动态图形动作(第一辑) | 片头标题、字幕条、图形元素的入场与强调动作 |
| 025–048 | camera | 镜头运动与转场(第一辑) | 给视频模型下运镜指令、给剪辑定转场 |
| 049–072 | ui | UI 组件名 | 向 AI 描述界面零件时用对名词,别再「那个框」「那个条」 |
| 073–096 | lp | 落地页与网页动效(第一辑) | 做产品页、官网时点名要滚动与悬停效果 |
| 097–120 | photo | 照片观感、光影与风格 | 给照片类生成和修图下风格指令 |
| 121–144 | motion2 | 动态图形动作(第二辑) | 第一辑之外的进阶动作补充 |
| 145–168 | lp2 | 落地页与网页动效(第二辑) | 更多页面效果与交互动效 |
| 169–192 | camera2 | 镜头运动与转场(第二辑) | 更细的运镜与转场名目 |
| 193–216 | artstyle | 生图画风 | 给图片模型点名画风,同一张草图换不同风格 |
几个使用细节值得知道:
- 每套包有自己的视觉风格,不是全库一个模子。比如
motion系是深海军蓝底加四色,camera系是浅灰底加一抹蓝,artstyle包干脆不用绘图,而是拿同一张底稿让图片模型按每种画风重绘,再用斜向擦除动画对比原稿——选画风时对比感拉满。作者说得很明白:词包要做对的是名字,不是统一的房屋风格。 - 编号是全库统一的。报号就能唯一定位一个效果,
#032在任何语言版本里指的都是同一个运镜,这是后面「报号点单」能成立的基础。 - 名单和画廊是同一份数据。画廊里动的样片,和
packs/里读到的文字名单,一一对应,不会出现图里有、名单里查不到的情况。
三种用法,逐个上手
用法一:装成技能,在画廊里点选,直接发给助手
这是最省脑子的用法,适合「我知道想要哪种感觉,但叫不出名字」的场景。前提是把 motion-prompt 技能装进你的编程助手(安装方法见后面一节),之后流程是纯点选:
- 对助手说一句:
Open the motion-prompt library.(打开 motion-prompt 词库),画廊会在浏览器里打开。想缩小范围可以点名类别,比如说只看镜头运动,画廊会过滤到camera和camera2两套一起显示。 - 在画廊里逐个看样片,看中哪个就点它上面的 Pick,可以连选多个;画廊底部有个备注栏,能写一句用途,比如「for the opening title」(用在片头标题上)。
- 点 Send to AI,你的点选就发回给助手了。
- 回到对话里说要拿这些效果做什么,比如:
Edit the opening of this video like this.(把这段视频的片头按这个改)。
助手这边会做什么,README 里写得很清楚:它只用你选中的那几样,不会自作主张加别的;它会去取这些效果的规格说明和参考代码,再结合你的项目实际产出方式(Canvas、Remotion、CSS、After Effects,或者给视频生成模型的提示词)把效果做进去。你没选、让它自己挑的时候,它会先建议打开画廊;你明确让它挑,它才按目录逐场搜索。
知道编号时可以跳过画廊,直接报号点单,这是熟练之后最快的路径,例句都是可以直接抄的句式:
Use the motion-prompt skill with #012 and #045 to make this product video look professional.(用 motion-prompt 技能的 #012 和 #045,把这条产品视频做得专业一点。)Replace the part where the title appears with #005 from motion-prompt. Keep the length and the transitions before and after it.(把标题出现的那一段换成 motion-prompt 的 #005,时长和前后的转场保持不变。)没有装技能的助手也能用画廊:在画廊里点选完,点底部的 Copy picks,会得到一段带样片和规格链接的文本,粘贴进任意对话窗口即可。
用法二:不装任何东西,查到名字直接写进提示词
词库的第二种用法零安装:打开名单或画廊,找到你想的那个效果,把它的名字原样写进提示词。名字本身就是压缩过的专业描述,一个词顶一段形容。官方给的例句长这样:
Bring the title in with a mask reveal from below, 0.6 s, each line slightly after the one before.(标题用自下而上的遮罩揭示入场,0.6 秒,每行比上一行稍晚一点。)Slow dolly in toward her face; move the camera, do not zoom.(缓慢轨道推镜靠近她的脸;移动机位,不要变焦。)这种用法在给视频生成模型下运镜指令时尤其值钱。视频模型对镜头术语的响应远比对形容词稳定,你把画廊里某个运镜的名字拿出来,甚至可以让助手先帮你转写成目标模型的提示词,README 里就有现成句式:
Turn the camera move in motion-prompt #032 into an English prompt for Veo. The subject is a coffee cup on a desk.(把 motion-prompt #032 的运镜改写成给 Veo 的英文提示词,主体是桌上的一只咖啡杯。)这条路径和 muse-video-prompt-skill 的六段式提示词工作流 正好接得上:六段式模板管的是每一镜的整体结构,motion-prompt 管的是其中「运镜」和「动作」这两段到底填哪个词。一个定框架,一个供词汇,配合使用时提示词既有章法又有准头。
用法三:给自己的领域和语言,做一套你自己的
这是这个仓库格局最大的一手。作者把「怎么做一套这样的词库」的提示词也开源了,放在 make-your-own/ 目录里,附带渲染视频的脚本和两个做完的范例(HTML 源码、三条视频、一张速查图)。三条路线:
| 目标 | 用哪份提示词 |
|---|---|
| 把现有视频换成另一种语言 | make-your-own/prompts/en/01-translate.md |
| 给你自己的领域起名,用你自己的视觉风格 | make-your-own/prompts/en/02-your-own-field.md |
| 做一页纸的速查图 | make-your-own/prompts/en/03-cheatsheet-image.md |
关键在于:领域不限于视频。作者明说,灯光、声音、UI、摄影、烹饪、建筑——任何「知道名字才能开口要」的领域,都可以照这个模子做一套。因为限制人的从来不是领域,是那套共同语言还没人整理。仓库也开放贡献:懂某个领域的人可以按 CONTRIBUTING.md 的说明新增词包,或给现有词包补一个语言版本。
为什么「名字」这么关键:点单四要素
把三种用法串起来看,会发现这套词库真正教的是一种点单方法:名字只是第一要素,说全了才准。README 里那句提醒是核心——找到名字之后,再补上时长、强度和谁在动,结果才接近你想要的。拆开就是点单四要素:
- 名字:要哪种动作、运镜或效果,用正式名或编号锁定,不留猜测空间。
- 时长:这个动作持续多久。0.6 秒的遮罩揭示是利落,2 秒就是舒缓,完全两种气质。
- 强度:幅度多大。推镜推到特写还是中景,弹跳回弹一下还是三下,差一个量级就是两种风格。
- 谁在动:动的是镜头、主体还是背景元素。「镜头推近」和「主体迎面走来」画面完全不同,这一项说反,整条片子的空间感就全错了。
为什么名字排第一?因为名字是其余三要素的挂载点。没有名字,你得用一整段话同时描述动作长什么样、持续多久、幅度多大,话越长模型越容易丢信息;有了名字,动作本体被一个词锚定,剩下的篇幅全用来调时长、强度和主体,指令的信噪比完全不同。这和 前期策划技能 muse-video-skill 的思路互为表里:策划管「这一镜要讲什么」,词库管「这一镜的动作具体叫什么、怎么调」。
WARNING名字要用对包、报对号。同名不同包的情况是存在的——比如转场类名字在
camera和lp里都可能出现,一个是镜头转场、一个是页面切换效果。报号前先确认编号区间属于哪一套包,报对名字却报错包,助手会一本正经地把网页动效做进你的视频里。
安装三路线(用法一的前置)
只有用法一需要安装,另外两种用法打开网页就能用。安装需要 Node.js 18 或更高版本,先 node --version 确认。三条路线任选:
路线一:一句话让助手自己装。 把下面这句粘贴进 Claude Code 或 Codex,助手会照仓库说明完成安装并回你三行用法:
Read https://github.com/showheyohtaki/motion-prompt and install the motion-prompt skill in this environment. When it is installed, tell me how to use it in three lines.路线二:命令行装。 用通用的 skills 安装器,一条命令,兼容 Claude Code、Codex 等读取 Agent Skills 的助手:
npx skills add showheyohtaki/motion-prompt路线三:Claude Code 插件。 在 Claude Code 里依次执行:
/plugin marketplace add showheyohtaki/motion-prompt/plugin install motion-prompt@motion-prompt手动安装也行:把仓库的 skills/motion-prompt 文件夹拷到对应目录——~/.claude/skills/ 是 Claude Code 全局生效,~/.agents/skills/ 是 Codex 等助手全局生效;放在项目内的 .claude/skills/ 或 .agents/skills/ 则只对该项目生效。
装完可以自检一次:在技能目录下运行 node <skill-dir>/scripts/motion-prompt.mjs info,能打印出数据源和元素数量就是装好了;退出码 3 表示数据源连不上,先解决网络再重试,别对着一个没装成的技能反复下指令。另外想自己跑画廊的话,仓库支持本地启动画廊页面,具体命令见 README 的 Skill reference 一节。
适合谁
- 做短视频和动效的人:片头、字幕条、转场这些高频需求,全在
motion和camera四套包里,点选或报号都比打字形容快。 - 给视频模型写运镜提示词的人:这是这套词库最被低估的用法——运镜术语是视频模型的「母语」,查对名字再下单,出片稳定性明显不一样。
- 做落地页和产品站的人:
lp、lp2、ui三套包把页面效果和组件名备齐了,跟 AI 协作改页面时沟通成本直接降一档。 - 想给自己行业攒一套术语库的人:
make-your-own/的三份提示词就是现成的生产线,你的领域缺的那套共同语言,可以照着做出来。
反过来,如果你只用聊天式助手写文案、从不碰视觉产出,这套词库暂时用不上,不必为了收藏而安装。
常见问题与排障
Q:我没装技能,画廊里选好的东西怎么给助手? A:在画廊底部点 Copy picks,得到的文本自带样片与规格的链接,粘贴到对话里即可。装了技能的路径是点 Send to AI 直达助手,助手会等你点选,最长等 15 分钟,慢慢挑没关系。
Q:报号点单,助手做的效果和样片对不上? A:先查两件事:一是编号有没有报错包(对照九套词包速览表的编号区间);二是四要素有没有说全——只报名字不给时长和强度,助手只能按默认值发挥,偏差往往不在名字,在你没说的那三项上。把时长、强度、谁在动补齐再下一次单。
Q:npx skills add 选助手的环节卡住或装错地方?
A:安装器可能会问装给哪个 Agent,选你当前用的那个。不确定装到哪了,就按手动路径核对目录:全局是 ~/.claude/skills/ 或 ~/.agents/skills/,项目级是项目内的同名目录。实在不行改走手动拷贝,最笨但最可控。
Q:运行自检脚本报退出码 3?
A:这是数据源不可达的意思,技能本体没坏,是网络到不了数据地址。恢复网络后重跑 info 命令确认即可,不要因此重装技能。
Q:中文名单和英文名单,实际用哪个? A:查阅用中文名单最快,理解零门槛;真正写进提示词时,喂视频模型和图片模型的指令建议换回英文名——主流生成模型对英文术语的训练覆盖更全。同一个编号在五种语言里指的是同一个效果,按编号对照着换语言不会串。
Q:能不能只装词库的一部分?
A:技能是一个整体,装的是全套;但使用时完全可以只翻你需要的那两三套包。名单本身也可以只读 packs/ 里对应的文件,不装技能照样查。
小结
motion-prompt 做的事情,用一句话说:把「我想要那种效果」里说不出口的「那种」,逐个变成了有名字、有样片、有例句的现成词条。216 个名字、9 套词包、五种语言,装成技能可以点选直达助手,不装也能查名点单,还能照着它的生产线给你自己的领域做一套。
给它在本系列里定位:前面的工具多在解决「怎么生成」「怎么拼接」「怎么策划」,这一篇解决的是更靠前的一环——开口之前,先把话说对。名字对了,时长、强度、谁在动补齐了,后面用哪个模型、走哪条工作流,出片的下限都会稳很多。