motionmaxxing：53 段专业动效量出 12 条缓动，Agent 交片前先过 6 道门，随包的 GSAP 不归 Apache 管
今天拆的是 motionmaxxing：一个把「什么算好动效」量成 12 条缓动与 15 条检查规则、再让 Agent 在交片前自过六道门的技能包；文章给全它在链条上的层级、五步上手路、十四处实测卡点，以及 Apache-2.0 之外那份 GSAP 自有许可。
动效难看，毛病往往出在几件具体的事上：角落挂一个品牌名、右上角一个「02 / 05」计数器、左边标题右边卡片、每段都淡入淡出。
motionmaxxing 这个技能包就冲这几件事来的。它把这几种「AI 味」写成 15 条可执行的检查规则，再给 Agent 六道必须过的门。
装它之前值得先弄清四件事：它盖在谁身上、你要给它什么、哪里会卡住、许可与钱怎么算。这四件事弄清了，最后那个「今天该不该动手」才站得住。
它在链条上站在哪一层
渲染底座那几期讲过的 HyperFrames、Remotion，负责把代码变成像素。motionmaxxing 盖在它们上面，管的是「拍什么、怎么动、够不够好」。它的技能描述写明可以在 HyperFrames 里用，也可以在纯 HTML 里用1。
这一层解决的是判断力。Agent 天生会写淡入淡出，因为这类写法在训练数据里最常见。它缺的是一把尺子，告诉它专业片子里 58% 的入场用减速、只有 8.8% 的动作带过冲。
motionmaxxing 做的事，是把这把尺子做成技能文件里可检索的条目。代价是上下文：技能主文件 20.6 KB，14 份参考文档合计 494 KB，按需加载。每开一个会话，主文件都会先占掉那 20 KB。
两边的关系还有两处细节。它的自检脚本会去探测本机有没有装 HyperFrames，本机探到的版本是 0.8.21；技能自己也写了一句，与 HyperFrames 的房子风格冲突时以本技能为准1。
所以装它之前，底下的渲染路径得先有：Chrome 无头加 ffmpeg，或者一套 HyperFrames。
它在这一层怎么做事
干活顺序是十步：查工具箱、摸品牌、写一句真话、找创意、搭世界与时间、写词配音、先做最难那一拍、回头看片、声音对画面、交付。
技能文件把每一步对应的脚本都点名了：品牌用
brand.mjs 抓，静帧用 render.mjs --still，整片检查用 look.py 与 lint.mjs，返工时按「坏了或假的 → 创意 → 衔接 → 层级 → 时间 → 表面 → 声音」的固定顺序改1。底气来自一份测量。作者把 53 段 3 到 7 秒的专业发布片段逐帧重建成 GSAP 时间线，用 6 个并行的分析 Agent 加人工复核，量出约 4,288 个动作，归并成 12 条缓动曲线和约 150 条规则3。
12 条曲线各自标了典型帧长、占 4,288 个动作的比例和适用场合：
snapSettle 11 帧占 6%，glide 10 帧占 14%，bounceHard 只占不到 1%。脚注写明 11% 的动作十二条曲线都套不上，这部分它没有覆盖；图由项目自带的 docs/media/eases.svg 转成位图。这些规则躺在
library/moments.jsonl 里，一共 716 行：156 条测量出来的规则、53 个片段时刻、以及另外 39 部片子的 507 行。脚本 precedent.py 按「这一拍要干什么、画面是什么内容」检索，返回带编号的规则4。检索出来的是这种句子。查「证据」这一类里涉及界面的拍子，排第一的规则说：一张屏幕平着出现时，把窗口本身从 0.70 倍画幅推到 0.78 倍，用 1.2 秒，别去缩放里面的卡片和横条。
理由是视差和焦点会告诉眼睛哪块面板是活的。规则后面挂着三个片段编号作为出处，也注明了这些行由模型解读、尚未逐条人工核对。
验收是六道门。G0 看片渲出来了没有，G2 看有没有连续三帧以上画面不动，G3 看结尾定格有没有超过 1.4 秒；这三道由
look.py 算。G5 由
lint.mjs 查页面装饰，15 条规则全部针对那几种「幻灯片段位」。G1「证据看得清」和 G4「一帧一个主角」没有脚本，只能看联络表用眼睛判，技能要求 Agent 在交付说明里承认这一点1。
左边是一帧故意做脏的合成画面：左上角品牌标签、右上角计数器、时间码、底部进度条、左侧踢标压在标题上；右边是同一次 lint 的输出，C1、C2、C3、C4、C6、C7、D1 七条判 FAIL，G5 整门不过，退出码 1。这张图来自项目自己的
docs/media/gates.png。这份清单是尸检出来的。作者把被拒的 AI 片子排出 25 种默认套路，再逐条追问责任：技能写清楚了而 Agent 没听，还是技能自己的措辞把它领过去，还是根本没有这条规则。
有一类结论出在技能身上。早先的版本要求「按幕交替使用平铺底色」「保留一个反复出现的载体」，Agent 老老实实照做了。于是作者改的是技能，不是骂 Agent。
你要给什么，它交回什么
| 你给 | 它交回 |
|---|---|
| 一个品牌网址或名字 | film/brand/：board.png、页面截图、字体、官方 logo、BRAND.md |
| 一台装了 Node 22、Python 3、Chrome、ffmpeg 的机器 | render.mjs 渲出的静帧与 mp4，附 events.json 记录每个动作发生在哪一帧 |
| 一个能跑 shell 的编码 Agent | 十步走完的 film/ 目录：STORYBOARD.md、index.html、final.mp4、NOTE.md |
| 可选的 ElevenLabs key | 配音、音效、配乐，以及 look.py 的音频段报告 |
| 可选的 Codex 图像生成 | 缺失表面的插画底板，画面里不会出现文字与 UI |
交付里最要紧的是
NOTE.md 与 look/gates.json：门的编号、数字、哪几门是肉眼看过的，都要写进去。它交出的是一支能再改的 HTML 片子，加一份可以拿去复核的体检单。最短上手路径
第一步，克隆到技能目录并自检：
git clone https://github.com/Tejashmakwana/motionmaxxing ~/.claude/skills/motionmaxxing
bash ~/.claude/skills/motionmaxxing/install.shinstall.sh 只检查、不装任何东西。本机跑下来 Node 22.13.1、Python 3.12.16、ffmpeg 7.1.5、Chrome（/usr/bin/chromium）四项全过，ElevenLabs key 与 Codex 图像生成两项显示缺失，都标成可选。它默认把技能目录软链到
~/.claude/skills/motionmaxxing。你的 Agent 不认软链，就加 --copy 复制一份，代价是以后更新要自己重来。第二步，用
bash scripts/providers.sh 确认机器状态。本机返回 ready: true，同时报出 HyperFrames 0.8.21 可用、磁盘余量 529 GB。第三步，对 Agent 说一句话，例如「给这个网址做一支 15 秒发布片」。先让它交出
board.png 与 STORYBOARD.md，你点头再往下建。这一步是整条流程里最省钱的卡位：故事板不对，后面每一帧都是白渲。第四步，先渲最难那一拍的静帧。本机用项目自带的
examples/demo 试了三次：三张 1920×1080 静帧 0.93 秒出图，同时写出 22 条事件记录。
examples/demo 第 4.2 秒的一帧，1920×1080，2026-11-01 在本机用 node scripts/render.mjs … --still 渲出。画面是一张输入框，是这份示例工程的默认内容，正好代表这套运行时裸跑时的样子。检查这一环也在本机验过。示例工程跑
lint.mjs：14 个采样点、15 条规则全 PASS、退出码 0。我另写了一张故意违规的页面（角标、计数器、踢标压标题、底部通栏），同样的脚本判 C1、C2、C3、C6、C7、D1 六条 FAIL、退出码 1。门确实有牙。第五步，整片渲完再跑
look.py。它会给出一张联络表、切点列表、结尾定格时长、响度与真峰值，并把 G0、G2、G3 的判定写进 gates.json。这份报告是交付时最有说服力的东西，也是你复核 Agent 有没有偷懒的凭据。
会卡住的地方
项目自己对这套门的边界写了一份
KNOWN-LIMITS.md，60 行，把「门能看见什么、看不见什么」逐条列了出来。这一节里有一半条目能从那份文件里对到原文。
- 成片编码在本容器里没有产出文件。 触发条件：用默认的
render.mjs渲 mp4。现状：静帧正常，2 秒片段打印了「render: 60 frames」却没落盘，9 秒整片跑满 420 秒未完成；本容器的视频编码由平台接管，这算环境限制。你能怎么办：换一台有 ffmpeg 的机器，或先用--still判断画面。 - 没有 ElevenLabs key 就没有声音。 触发条件：不设
ELEVENLABS_API_KEY。现状：技能会写一行说明然后继续，画面改按固定节拍走5。你能怎么办：先做默片，满意后再补音。 - 图像生成要 Codex 的 image_generation 能力。 触发条件：用
imagegen.py补缺失的画面底板。现状：本机codex不可用，providers.sh报codex.image_generation: null。你能怎么办：只用代码与抓取素材，或另配一个能出图的模型。 - lint 看不见 canvas、图片和视频里的字。 触发条件：把品牌名烤进生成图或画在 canvas 上。现状：项目自己写明「lint 是线索，不是判决」5。你能怎么办：这类帧只能人看。
- 两门没有脚本，靠肉眼。 触发条件：G1 证据可读、G4 一帧一个主角。现状：技能要求先给联络表每一帧写一句话，再在
NOTE.md里声明这两门是看出来的。你能怎么办：把联络表当成必须交付的中间物。 - 切点识别依赖事件文件。 触发条件：没有
render.mjs写出的events.json。现状：look.py退化成从画面猜切点，show/hide密集的片子会被算成很多刀，项目举例说仓库里的横幅被判出 33 个切点，结尾镜头占比也跟着变5。你能怎么办：别删事件文件。 - 审美结论只有一个评分者。 触发条件：相信「9/10 盲测选中带技能的那支」。现状：那批数据来自 5 个虚构品牌、2 个模型、一位评分者，作者自己写「这一代还没有新的 A/B」3。你能怎么办：当作方向，别当作基准。
- 测量样本有题材偏斜。 触发条件：拿那套节奏套长片、纪录片、口播。现状：53 段全是 3 到 7 秒的 SaaS 风格界面片段，作者明说「99% 的帧都在动」只描述这类片段，整片的人味中位数 6.8，那个数只是提问5。你能怎么办：短促的发布片用它，慢片只借规则、不借数字。
- 同一份材料里有两处口径不一致。 触发条件：读了 README 再读脚本。现状：README 说清点了 25 种默认套路，
lint.mjs只有 15 条规则；SKILL.md 说 52 部真人片被排序，先例库统计出来是 39 部6。你能怎么办：以能跑起来的脚本为准，数字当宣传页看。 - WebGL 场景很慢。 触发条件：
runtime/hero3d的三维主视觉。现状：项目自报 1080p 下每秒 7 到 11 帧（Apple GPU），软件渲染更慢，--scale也不减少 WebGL 开销5。你能怎么办：只给最难那一拍开三维。 - 仓库极年轻。 触发条件：当成可长期依赖的工程件。现状：2026-10-06 建立、2 次提交、0 tag、0 release、1 条未关闭 issue（macOS 上会留下 Chrome 副本）7。你能怎么办：把技能目录钉在某次提交上，升级路径自己管。
- 品牌抓取会抓错东西。 触发条件：目标站点没有规范图标。现状：
fetch_logo.mjs按 SVGL、Simple Icons、站点自身图标的顺序找，最后一步常拿到页眉横条；挡无头浏览器的站点直接抓空。你能怎么办：渲一次 SVG 看一眼再往下做。 - 每帧必须是时间的纯函数。 触发条件：在页面里用
setTimeout、Math.random、CSS 动画。现状：跳到同一时间点渲出来的画面会不一样，Motion.selfTest只抽查采样帧5。你能怎么办：把随机与定时器换成按帧数计算的参数。 - 技能与一个商业应用同源。 触发条件：期待独立的桌面体验。现状：技能自述「lives inside FinalMotion」，那个应用 1.0 免费、要求 Apple 芯片与 macOS 13 以上、未公证8。你能怎么办：只用技能配自己的 Agent，桌面端当可选项。
许可与真实成本
仓库本体是 Apache-2.0，
NOTICE 逐项列了覆盖范围：SKILL.md、references/、scripts/、templates/、examples/、taste/、library/、docs/、runtime/motion.js 与 runtime/hero3d/9。随包最需要注意的是 GSAP 3.12.5。它的许可是 GreenSock 自己的 Standard「No Charge」，
NOTICE 直接写「THIS IS NOT AN OPEN-SOURCE LICENSE」。按 GSAP 官方页面，商用网站与应用免费，AI 生成 GSAP 代码也允许；需要另谈的是「让终端用户拖拽搭动画、与 Webflow 竞争」的工具10。其余随包组件是常见许可：three.js 与 fflate 为 MIT，Inter 字体为 OFL，ffmpeg 自备。做内部宣传片与客户项目，这一层没有额外授权问题；做给外部用户的可视化动画产品，GSAP 那条要先问。
| 项 | 当天价格 | 说明 |
|---|---|---|
| motionmaxxing | 0 美元 | Apache-2.0，仓库无付费档 |
| Claude 订阅 | Pro 每月 20 美元，年付折算 17；Max 自每月 100 美元 | 两档都含 Claude Code11 |
| ElevenLabs | 免费档 1 万 credits、不可商用；Starter 6、Creator 22、Pro 99 美元每月 | 商用授权自 Starter 起12 |
| Codex 图像生成 | 随 ChatGPT 付费档提供 | 价格只在渲染后的卡片里，本次读取没拿到数字13 |
| Chrome、ffmpeg、Node、Python | 0 美元 | 需自行安装 |
真正的开销是时间：每一轮「建 → 渲 → 看联络表 → 改」都要人参与判断，作者建议两到三遍诚实的返工。它省下的是审美决策的推理成本，花掉的是你看片的时间。
和之前几期放在一起看
| 项目 | 站在哪一层 | 许可 | 2026-11-01 体量 | 与本期关系 |
|---|---|---|---|---|
| motionmaxxing | 审美与验收层 | Apache-2.0 + GSAP 自有许可 | 1,193 star，2 次提交 | 本期 |
| HyperFrames | 渲染底座 | Apache-2.0 | 76,058 star | 它可以直接拿来当底座 |
| Remotion | 渲染底座 | 自订两层许可 | 69,146 star | 帧函数那条路的参照 |
| OpenMontage | 流水线与资产 | AGPL-3.0 | 73,423 star | 管流程，不管审美 |
| hypit | 工作流描述语言 | 改过的 Apache-2.0 | 26,885 star | 词锚定那一层 |
| FilmCraft | 剪辑器 | MIT 或 Apache-2.0 | 17,077 star | 命令驱动的 NLE |
| video-shotcraft | 镜头卡库 | Apache-2.0 | 15,143 star | 也做镜头规则，偏结构与配方 |
| Mortiflix | 分阶段流水线 | AGPL-3.0 | 670 star | 也设门，门设在流程节点上 |
今天该不该动手
今天动手，如果：你正在用 Claude Code 或 Codex 做 10 到 40 秒的发布片、产品片、动效短片；你愿意每支片花两三轮人看；你想给团队一套能写进交付单的验收标准（六道门、15 条规则、
gates.json）。这三条同时成立，装它就是一次 clone 的事。先收藏，如果：你主要剪真人出镜的长片，它的强项不在那里；你用 Windows，脚本里的
say、路径与 Chrome 探测都只在 macOS 与 Linux 上验证过；你只想要一个拖拽就出片的界面。跳过，如果：你的成品要 4K 长片或复杂合成，这套运行时按帧渲 HTML 的做法会在时间上惩罚你；你要做的是让外部用户拖拽生成动画的产品，GSAP 的条款要先谈；你需要一个有人维护、有版本号、有问题响应的依赖。
References
- 1motionmaxxing SKILL.md
github.com
- 2Tejashmakwana/motionmaxxing
github.com
- 3HOW-IT-WAS-BUILT
github.com
- 4references/tools.md
github.com
- 5KNOWN-LIMITS
github.com
- 6README 的 25 种套路一节
github.com
- 7issue #1
github.com
- 8FinalMotion
finalmotion.video
- 9NOTICE
github.com
- 10GSAP Standard License
gsap.com
- 11Claude 价格页
claude.com
- 12ElevenLabs 价格页
elevenlabs.io
- 13ChatGPT 价格页
chatgpt.com
This story was produced automatically by a channel. One sentence is all it takes for Neodrop to keep producing for you.