Communitygithub.com

motion-language

指导AI智能体如何规划、构建或剪辑“动态语言”,使输出的视频素材成为可用的文案或脚本。通过动态语言、关键区别和词汇表三个步骤来实现这一目标。

motion-language 是什么?

Motion Language是一项专注于视频动态图形设计的AI智能体技能。它定义了“场景”与“闪光”的核心区别:场景承载需要观众阅读的论点,而闪光则用2-4秒的视觉手势强化一个已经听到的观点。技能提供了包含基础、玻璃、光泽、路径和状态五元素的设计词汇表,并内置了如converge、overload、steps等8种可复用的闪光动画库。该技能还包含完整的B-roll处理规范,支持照片和视频素材的卡片式或全屏展示,并集成了48条原子动画规则和373个可安装动画块的超帧库。技能强调确定性动画、避循时间线规则和可复现的视觉效果,适用于Cursor、Claude Code等AI编程工具,可显著提升技术解说视频的视觉一致性和制作效率。

兼容平台✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/lucasaerb/workless-video-editor/tree/HEAD/skills/motion-language

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

动态语言

继承自 skills/00-house-rules/SKILL.md。实现代码为 scripts/stingers.py;渲染所有内容的画廊为 scripts/build_stinger_gallery.py。

---\n

关键区别

场景解释。 闪光示意。

场景闪光
时长8–15秒2–4秒
承载内容需要观众阅读的论点一个已经听到的观点
面部隐藏或画中画隐藏 — 剪辑时切到它
数量每10分钟视频3–6个每20–40秒一个
如果移除论点无法传达视频变平,但不会出错

搞反这个区别是常见的错误。包含真实内容的三项列表是一个 compare 场景;同样的列表作为 steps 则是装饰。如果观众需要 阅读 它,那它就不是闪光。

闪光是被切到的,而不是叠加的。 它们在短暂的几秒钟内占据整个画面。一个全画面图形但讲话者仍可见的背景会显得像是错误,而缺失他面部的3秒钟几乎不造成损失。


词汇表

五种元素。库中的所有内容都是它们的组合,这就是不相关的动画读起来像一个系统的原因。

基础近乎黑色,带有柔和的径向提亮。从不使用纯 #000 — 真正的黑色画面看起来像是信号丢失,而不是设计。
玻璃半透明填充约4.5%墨量,1px边框约14%,圆角26。深度来自于边框和内部高光,绝不用卡片上的投影。
光泽卡片稳定时低角度镜面扫过。这是标志性动作 — 它使平面矩形看起来像一个实体对象。
路径约10%墨量的细虚线曲线。物体沿着路径移动。没有物体瞬移。
状态一行小点承载系统状态。该行上颜色变化表示“然后它坏了”,无需任何文字说明。

错开时间为120–160毫秒。 低于100毫秒,相邻元素被视为一个对象;超过200毫秒,观众开始等待。

每个闪光都保持其最后一帧。 它是对着语音剪辑的,所以在效果完成后结束在任何帧上都必须安全。没有循环;没有在空舞台上结束。


闪光的种类

{ "kind": "converge", "from": "所有东西汇聚到一个地方", "dur": 3.4,
  "chips": ["skill.md", "prompt", "context", "tool", "rule", "doc"] }
种类它所属的句子时长
converge“所有这一切都汇聚到一个地方。” 纸片沿着虚线路径进入一个发光核心;状态点在它接受负载时被填满。3.0–3.6
overload“然后它停止工作了。” 同一个核心裂开变成红色。共享 converge 的几何结构,因此两者可以作为一个故事剪辑在一起。2.4–3.0
steps“有三个这样的。” 编号的玻璃卡片,错开排列,每张卡片带有光泽。最可重复使用,也最被滥用。2.6–3.2
swap“这个,不是那个。” A 被划掉并向上退场;B 在它下面出现。两者都保持清晰可读。3.0–3.6
countup“是百分之四十三。” 一个数字攀升,大小随数值增长,在 可见的源行上。2.6–3.4
beats三个短促的短语,有节奏感。每个在同一个共享节拍网格上使用 不同的 入场方式。2.4–3.2
surround“你被工具淹没了。” 带标签的纸片环绕一个固定的中心,然后向内聚拢。中心从不移动。3.2–4.0
photo一张找到的图像,经过处理。玻璃卡片、缓慢的 Ken Burns 效果、标题、信用行。2.8–4.0
clip同样的卡片包含 视频素材 而不是静态图片。没有 Ken Burns 效果 — 它已经在动了。2.4–3.0

像场景一样在 composition.json 中使用它们 — 相同的 from / at / dur 锚定,如果短语无法解析,则报同样的硬错误。


B-roll:photo / clip 闪光

两种处理方式,full 在它们之间选择。full 是主动选择的;省略它则得到卡片。

full: true — B-ROLLfull: false — 引用
画面全出血、无卡片玻璃卡片、光泽、缓慢漂移
画面上的文字一个下方三分之一,标示这个镜头是什么标题 和 信用行
画面上的来源从不必需
用途用于体现某个时刻的素材和静态图片截图、图表、定价页面、文档

B-roll 是全屏的,不显示来源信息。来自人类的长期指令,2026-08-14。 它像每个人看过的任何剪辑中的 B-roll 一样占据整个画面。唯一允许在其上的文字是下方三分之一,说明这个镜头 是什么,绝不说它来自哪里。归属仍然会发生 — 在项目临时文件夹的 _FINAL/ATTRIBUTION.md 中,由 fetch_stock.py 在下载时写入,任何编辑都不能跳过。Pexels 和 Pixabay 都使画面上的水印成为可选项,因此清单本身满足许可要求,画面保持干净。

这取代了之前关于 B-roll 的段落,该段落说全出血剪辑“看起来像不同的视频”,并将所有内容放在卡片中。这个推理仍然适用于引用情况,并且只适用于它:当观众被要求 阅读 作为你引用的证据的素材时,使用 full: false,来源行回到画面上。

构建器仍然默认使用卡片,这是故意的。 改变默认值将静默地重新处理所有已根据它编写的 photo 场景 — 其中包括 drop-005 的 working/stingers/plan.json — 昨天渲染卡片的规范今天必须渲染同样的卡片。新作品要求 "full": true;skills/executive-animator 总是这样做。如果卡片最终被完全弃用,st_photo 中的单字更改就足够了。

一个几何学注意事项:全出血使用 object-fit: cover,所以 给它一个已经是 16:9 的源素材。一个 2.19:1 的裁剪在全画面显示时每边丢失 221px,这就是图表的第一列和最后一列被切掉,而每个门都报告一个正确边界框的原因。

一个构建器,两个名称。 photo 用于静态图片,clip 用于视频素材;它根据文件扩展名分支,所以名称只是为了提高规范的可读性。实际变化如下:

photoclip
元素<img><video muted playsinline>,带有框架计时
Ken Burns有,1.00 → 1.07 跨越卡片无

视频素材没有 Ken Burns 效果。 剪辑本身提供了运动,在真实运动上叠加缩放渐变正是使素材看起来像素材的原因。静态图片是静止的,需要漂移来保持活力;剪辑不需要。

// B-roll。全屏,下方三分之一说明它是什么,画面上无来源。
{ "kind": "clip", "from": "一切同时移动", "dur": 3.0,
  "src": "broll/cut-data-flow.mp4", "caption": "一切同时移动" }

// 引用。观众作为证据阅读的文档,所以卡片和水印都回来。
{ "kind": "photo", "full": false, "from": "定价页面变了", "dur": 3.2,
  "src": "assets/pricing.png", "caption": "Anthropic 定价,2026年8月",
  "credit": "ANTHROPIC.COM · FETCHED 2026-08-13" }

下方三分之一位于 cap_left / cap_bottom,默认为 96 / 186 — 横屏,这清除了 youtube_long 的 96 左侧和 132 底部。一个 9:16 的来电必须传递自己的 cap_bottom:Reels 在底部预留了 520,Karaoke 带占据 Y 1150-1400,因此横屏默认值会将标题放在进度条下方。没有一对值在两个画面中都正确。

src 相对于规范文件解析,构建器将其复制到项目的 assets/ 中,因此错误的路径会在构建时大声失败,而不是产生空白的卡片。同时从 scripts/fetch_stock.py 获取两者,它会打印出准备粘贴的块。

归属是清单义务,不是画面义务。 每个三级资产都在项目临时文件夹的 _FINAL/ATTRIBUTION.md 中获得一行,由 fetch_stock.py 在下载时写入 — 这就是 config/broll-policy.md 要求的,并且不是可选的。水印是否也出现在画面上是一个设计决策,而对于 B-roll,答案是否定的。在引用卡片上,它会保留,以 WCAG AA 标准渲染,没人能读懂的归属不是归属。

首先按层级顺序解析每个图像。照片是 三级:只有当您自己的素材和二级叠加层确实都没有任何东西时才使用它。Ken Burns 效果运行在裁剪卡片内部的 <img> 上,绝不在卡片本身上运行。

⚠ 不要复制长的第三方视频插入模式。 这种语言来源的参考运行了50秒别人的采访素材。config/broll-policy.md 直接禁止了这一点,再好的动态设计也不能让它变成我们的。带归属的照片没问题;但挪用一半视频是不行的。


更广泛的菜单 — 当以上都不适合时使用什么

存在两个上游语料库,两者都比这个库大。从中阅读,而不是发明新的动画。

hyperframes-animation 技能 — 48 条原子规则 + 22 个场景蓝图。使用 Skill(hyperframes-animation) 加载它,然后打开 rules-index.md 并阅读 rules/<name>.md 中你需要的那个规则。默认是 在一个暂停的时间线上组合 2–4 条原子规则;蓝图适用于你想要一个完整的 4–5 阶段镜头的情况。

块注册表 — 373 个可安装块:npx hyperframes catalog --query "<概念>",然后 npx hyperframes add <块>。

情况 → 规则

为讲解型视频精选。这些是符合我们格式的规则;其余的 48 条大多假设是产品 UI 或我们不使用的驱动光标。

当一句话是…规则为什么适合
一个数字、统计、百分比counting-dynamic-scale、stat-bars-and-fills已实现为 countup;对条形图、环形图、星形填充直接使用规则
一个有力的列表、快速连续kinetic-beat-slam、waterfall-entry实现为 beats;waterfall-entry 是更温和的级联
一个定义或术语定居gradient-text-sweep、depth-scatter-assemble第一个中字形从不移动;第二个从深度组装它们
“这是它的形状”(图表)svg-path-draw轮廓自行绘制。在设置时使用 getTotalLength() 测量
“它被包围/掩埋/连接”radial-surround、avatar-cloud-network、orbit-3d-entry实现为 surround;另外两个添加连接线和 3D 入口
一个想法取代另一个scale-swap-transition、card-morph-anchor、morph-swap实现为 swap;card-morph-anchor 变形容器本身
“仔细看这个”depth-of-field-blur、coordinate-target-zoom、viewport-change焦距变换,或 .world 包装器上的虚拟摄像机
强调口语词汇asr-keyword-glow、css-marker-patterns发光与单词时间戳同步 — 我们已经有了测量到的单词时间
一个硬朗的、有节奏的重音chromatic-glitch、particle-burst、motion-blur-streak谨慎使用;每个视频最多一个
一个平静的落地节拍titlecard-reveal(蓝图)、ambient-glow-bloom低运动是有效载荷,不是缺陷
任何入口spring-pop-entrance典型的弹出。有疑问时,使用这个

值得了解的蓝图

22 个蓝图中的大多数是产品发布广告形状。四个映射到我们实际制作的内容上:

  • kinetic-type-beats — 主力。文字承载镜头,没有场景,没有表面。
  • dataviz-countup — 当数据承载论点时。
  • comparison-split — 同时权衡两个能力(我们的 compare 场景是其扁平化的表亲)。
  • titlecard-reveal — 呼吸节拍,完全一个克制的动作。

跳过 cursor-ui-demo、device-surface-showcase、cta-morph-press、prompt-type-submit-generate 以及其它演示系列,除非我们实际在展示产品 UI。它们很出色,但不符合我们的格式 — 一个突然执行假应用演示的讲解型视频看起来像广告。

每个上游规则假设的契约

在复制一个规则之前值得了解,因为破坏这些不会导致检查失败 — 而是导致渲染失败:

  • 一个在 window.__timelines 上暂停的 GSAP 时间线。永远不要自动播放,永远不要有第二个时间线。
  • 双向搜索安全 — 使用显式 from 状态的 fromTo,绝对值,永远不要相对 +=。状态必须是时间线时间的纯函数。
  • 确定性 — 没有 Math.random(),没有 Date.now()。仅使用基于索引的伪随机。有限重复,永远不要 repeat: -1。
  • 仅变换和绘制。 禁止使用 width / height / top / left 补间;使用 scale/translate 代理或遮罩。
  • 分组错开限制,使一个到达读作一个节拍 — items × stagger ≤ ~0.5s。
  • 预先计算布局常量。 永远不要在补间时间派生位置;渲染器并行采样,测量会不同步。

添加新概念

  1. 首先搜索注册表 — npx hyperframes catalog --query "<概念>"。存在 373 个块。radial-surround、morph-swap、split-tilt-cards 和 particle-image-reveal 是此库中元素的近亲,可能比新代码是更好的起点。
  2. 从上述五个元素构建它。需要第六个元素的概念要么是场景,要么表明词汇表需要刻意扩展 — 而不是例外。
  3. 将其添加到 scripts/stingers.py 中的 KINDS。
  4. 渲染画廊并把它们全部放在一起看。这是判断新元素是加入了家族还是只是落在旁边的唯一方法。
python3 scripts/build_stinger_gallery.py <out> --photo <image>
cd <out> && npx hyperframes check
python3 scripts/probe_frames.py <out> --plan --grid sheet.png

此库已经捕获的三个缺陷

每个都通过了干净的 hyperframes check,然后才有人查看帧:

  1. GSAP 无法为 ::after 设置动画。 它使用 querySelector 解析目标,而 querySelector 从不返回伪元素,因此每个光泽都默默地什么都不做。光泽现在是一个真实的子元素 (SHEEN_EL)。如果你添加卡片,把它放进去。
  2. GSAP 无法为 clip-path 设置动画。 来自 hyperframes 文档。使用 mask-image 进行路径动画。clip-path 仍然适用于蒙版形状,但任何随时间变化的路径都需要 mask。
  3. 截图在不同平台上使用不同的字体。 一个引用卡片在 mac 上看起来很好,但 Segoe UI 与 SF Pro 不同。卡片字号在 ddrop/style/font-lockup.json 中,但跨平台验证仍然是非正式的最佳努力。

技术限制

此技能需要下游 ddrop 工具链提供的以下运行时功能:

  • 用于 CSS 和 SVG 管理的 Puppeteer / Playwright 实例。
  • Python 3.11+,用于运行 scripts/ 下的构建脚本。
  • Node.js 22+,用于 npx hyperframes 目录查询。
  • ffmpeg,用于视频帧探测和画廊生成。
  • 一个项目结构,包含 assets/、broll/、style/、composition.json 和 _FINAL/ATTRIBUTION.md。

没有这些依赖项中的任何一个,技能可以规划,但不能渲染。


变更日志

日期变更
2026-08-14添加了 B-roll 全出血策略,取代了引用图片的卡片默认值。扩展了 photo / clip 用法。
2026-06-22将上层规则集从 hyperframes-animation 合并为摘要和速查表。
2026-05-10初始库发布,包含下面 8 种闪光种类。

*欲了解完整上下文,请打开 skills/00-house-rules/SKILL.md。" }

Individual skills in this repo

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

相关技能