Communitygithub.com

MattiaIppoliti/tia-skills

技术目录:五种速度匹配的SEAMS(缩放穿越、反向缩放穿越、切曲线、瀑布切、旋焦模糊切)以及两种场景内技术——瀑布入场(用于标题卡/片段开场的交错到达级联)和微调曲线(慢-快-慢三阶段组滑动)。涵盖部分行程(~12%画面)通过镜像power4缓动的速度匹配、Z轴比例符号规则、按尺寸缩放模糊(10px文字/18-20px全帧)、逐词交错剪切、按元素权重的级联节奏,以及10/65/25滑动比例。在编写任何过渡、文字节拍交接、动态文字入场或组重定位之前,请先阅读。

tia-skills 是什么?

MattiaIppoliti/tia-skills是一个全面的动效技术目录,专为AI代理(如Claude Code、Cursor、Codex)设计,用于在视频编辑、动态图形或类似基于时间轴的软件中创建电影级过渡和场景内动效。它定义了五种SEAMS技术(缩放穿越、反向缩放穿越、切曲线、瀑布切、旋焦模糊切)以及两种场景内技术(瀑布入场和微调曲线),所有技术都基于在剪辑点匹配方向和速度的核心原理。该技能提供了精确的参数:Z轴缩放的范围(如正向缩放1→1.2)、模糊值(文字10px,全帧18-20px)、缓动函数(如power4.in/out)以及时间控制(总时长0.4-0.7秒)。它还强调了部分行程运动(约12%画面)、速度匹配的镜像缓动、逐词交错级联、按元素权重的节奏(重元素移动更远更慢),以及通过三阶段微调曲线进行光滑组重定位。该技能适用于任何支持JavaScript动画库(如GSAP)的平台,并链接到示例实现。它警告常见反模式,如错误镜像Z轴符号导致不连贯的推送/拉取感。总之,它为开发者提供了创建专业、连贯且视觉流畅过渡的参数化配方,避免了失控的动效。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/MattiaIppoliti/tia-skills/tree/HEAD/skills/video/cut-the-curve

在你喜欢的 AI 中提问

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

文档

切曲线 — 技术目录

五种 SEAMS 技术,一个原则:在峰值速度处剪切,匹配剪切两侧的方向和速度 — 以及两种场景内技术(§6 入场,§7 滑动)。接缝法则(矢量法则、电流、分类账、接缝门)位于 motion-doctrine 中;请先阅读它。本技能提供参数和机制。所有 GSAP 代码模板(工作器 + 注册表):examples/gsap-implementation.md。

目录

#技术范围轴用途
1缩放穿越(正向)场景内文字交换Z,朝向观众深入同一个想法
2反向缩放穿越入场/回报节拍Z,远离观众某件更大的事情落地
3切曲线场景之间X / Y默认边界,电影的当前方向
4瀑布切文字到文字接缝X,逐词大文字节拍之间的逐词交接
5旋焦模糊切同表面状态交换X / Y / Z你希望被注意到的剪切 — 数码单反的推拉对焦效果
6瀑布入场场景内入场(无接缝)Y,从下方标题卡,片段开场,列表介绍
7微调曲线场景内组滑动(无接缝)X / Y重新定位已组成的组以腾出空间

Z 方向是一个符号

“同一轴”在 Z 轴上不够用 — 在剪切处必须匹配 d(scale)/dt 的符号:

Z 矢量退出缩放入场缩放变体
推进(正向)增长 1 → 1.2增长 0.75 → 1缩放穿越
拉回(反向)缩小 1 → 0.8缩小 1.25 → 1反向缩放穿越

禁止的镜像:一个后退的退出被一个从小增长的入场回应(拉回翻转成推进 — 这是常见的,因为从小增长是默认的元素入场),以及一个推进退出被一个过大的收缩回应。这将绑定入场场景在接缝窗口期间(剪切 + 约 0.5 秒)自身的入场,而不仅仅是包装器补间:保持入场帧已组成,或编写其入场以匹配符号。根据接缝门规则 7 进行验证。

模糊逻辑(所有 Z 变体)

对象峰值模糊原因
文字缩放(标题,词组)10px20px 会涂抹字母形状 — 剪切读起来像故障,而不是速度
全帧表面(窗口,卡片,截图)18–20px在大表面上使用较轻的模糊会读起来像是渲染故障

在交换帧上,两侧使用相同的峰值模糊。模糊包装器,从不模糊子元素。


1. 缩放穿越(正向)

Z 轴速度匹配剪切;两个文本永远不同时可见。 一切都增长:退出的文字加速朝向相机,硬切换在峰值模糊处隐藏,入场的文字继续增长进入焦平面。仅限标题和短短语。总时长约 0.4 秒。

阶段缩放模糊不透明度缓动持续时间
退出1 → 1.20 → 10px1 → 0.15power3.in(不透明度:单独的 none 补间)0.2s
剪切(tl.set)入场:0.7510px退出:0 / 入场:0.15——
入场0.75 → 110 → 0px0.15 → 1expo.out0.5s

退出不透明度必须是其自己的线性补间 — power3.in 会使不透明度接近 1 保持太长时间。入场时所有属性共享 expo.out。

2. 反向缩放穿越(反向)

拉回镜像:退出的元素后退;入场的元素过大(就像刚在相机后面)并缩回焦平面。一切都缩小。用于入场/回报节拍 — 回报台词、巨大回复、结束状态保持 — 而不是普通边界。总时长约 0.7 秒(30% 退出 / 70% 入场)。

阶段缩放模糊不透明度缓动持续时间
退出1 → 0.80 → 10px1 → 0.15power3.in(不透明度:单独的 none 补间)约 0.2s
剪切(tl.set)入场:1.2510px退出:0 / 入场:0.15——
入场1.25 → 110 → 0px0.15 → 1expo.out约 0.5s

模糊是 10px 文字缩放;仅当两侧都是全出血表面时才使用 18–20px。

符号纪律: 入场场景作为一个已组成的帧到达收缩的包装器内部 — 在接缝窗口内没有从小增长的介绍。分阶段入场在收缩稳定后发生,或从 ≥1 开始并收缩。

3. 切曲线(默认场景边界)

X/Y 速度匹配剪切 — 所有场景到场景边界的默认方式,在电影的当前方向中,而不是一种强调。退出的主角向一个方向加速,剪切在运动中落地,入场的主角继续同一方向并减速。总时长约 0.6 秒;方向 左 / 右 / 上 / 下(默认 左)。

部分行程: 约 12% 画面(1920 时约 230px) — 从来不是完全移出屏幕的移动。

方向退出入场开始 → 结束
向左x: 0 → −230x: +230 → 0
向右x: 0 → +230x: −230 → 0
向上y: 0 → −230y: +230 → 0
向下y: 0 → +230y: −230 → 0

机制:

  • 镜像缓动: 退出 power4.in + 入场 power4.out,相同距离和持续时间 — 一个 power4.inOut 的两半,因此速度在剪切处精确匹配。
  • 淡出技巧: 退出不透明度在其行程的约 25–30% 完成(淡出约 0.18–0.3 秒 vs 运动 0.3–0.34 秒);入场在行程中间约 0.35 不透明度处点燃。计时最后一个淡出元素恰好在剪切处消失 — 如果中间没有移动,会产生死寂。
  • 退出 0.2–0.4 秒;入场 ≥ 退出。可选模糊 8–10px。
  • 舞台背景: #root 必须是不透明的 (background: var(--canvas-deep, var(--canvas, #000))) — 中间窗口剪切会打开一个求和不透明度 < 1 的窗口,否则会闪烁白色(参见 seam-craft)。

push-slide 存在但违反了部分行程和中运动阶段;优先使用切曲线。

4. 瀑布切(逐词切曲线)

在单词粒度上应用切曲线 — 用于文字到文字接缝的最强向左剪切。退出的单词在各自的曲线上加速移出;入场的单词在飞行中级联进入 — 一种眼睛能跟随接缝的波浪。

范围: 由工作器在一个多节拍合成(堆叠的全帧 .beat 图层)内编写,而不是注册表/注入器类型 — 它补间单词跨度,而不是剪辑包装器。进出文字节拍块的边界仍然得到一个正常的注册表过渡。不计入 2–3 个过渡预算。

参数值原因
行程±230px(约 12% 画面)部分行程 + 速度 > 全帧推动
退出0.34s power4.in加速本身就是剪切
退出淡出0.18s,与 x 同时开始单词在约 25–30% 行程处消失 — 无拖影
退出交错按阅读顺序 +0.022s行被剥离,而不是块滑动
入场0.3s power4.out复合的后半部分 — 速度匹配
入场开始不透明度0.35中间路径点燃;二进制 0→1 会弹出
入场间隔0.05s × 0.84 衰减加速级联,解析为已组成

规则:

  • 一个链条一个方向,顺着电流而行。反向缩放穿越只是链条的入场节拍。
  • 在构建时将所有单词预设为 x: +230, opacity: 0 — 仅 immediateRender: false 会使未开始的单词在静止时可见。
  • 一个短的第一节拍可以整行退出:其淡出在剪切前约 0.02s 结束,以便在下个单词点燃时仍在拖尾 — 没有死寂间隙。
  • 仅变换/不透明度(对寻址安全);不透明舞台背景适用。

5. 旋焦模糊切(可见剪切)

一种变体,其中剪切是被看到的:一个离焦模糊尖峰隐藏了一个单帧硬切换 — 就像手持数码单反的推拉对焦。用作同一视觉主题内同一表面的状态切换的偶尔效果;绝非常规边界。

与其他变体的区别:退出保持完全不透明直到剪切(模糊隐藏了切换 — 没有早期淡出);缓动 power2.in / power2.out(柔和光学,非动量)。

规则:

  • 仅在叙事节拍处触发,每约 8 秒最多一次;绝不在字幕期间或保持期间使用。
  • 在峰值模糊处剪切(≥6px;峰值 8–12px,最大 ≤16–18px)— 在上升途中交换会暴露剪切。
  • 一个微妙的缩放(约 1.06 镜头呼吸)使其看起来像光学效果。
  • 两侧同一方向 — 矢量法则仍然适用。入场 ≥ 退出持续时间。
  • 模糊包装器;永远不要在一个补间中对一个元素同时使用模糊和不透明度(无头合成错误);永远不要直接模糊 <video>(用包装器包裹)。

6. 瀑布入场(场景内入场 — 不是接缝)

交错入场级联:单词/元素从下方急速进入(一个一致的方向),每个在前一个稳定之前开始 — 一个加速波,解析为已组成的布局。标题卡、片段开场、列表/功能介绍。接缝兄弟是 §4;不要混合它们的规则:

§6 入场(到达)§4 瀑布切(接缝)
不透明度通过 tl.set 在入场时二进制 0→1 — 从不淡出在中间路径 0.35 处点燃 — 淡出本身就是速度技巧
默认轴Y,从下方X,顺着当前方向
退出方无单词在镜像 power4.in 上加速退出

编排:

  • 重叠,不排队 — 下一个元素在前一个稳定后的 ±2 帧内开始;间隙在级联中缩小;最后一个元素快速到位。
  • 速度按权重变化 — 重/锚元素移动更远更长;轻单词/标点快速到位:
参数锚/重正常单词轻/标点
Y 偏移60–80px40–50px30–48px
持续时间0.16–0.20s0.13–0.16s0.10–0.13s
重叠0–2f 间隙1f 重叠1–2f 重叠
  • 缓动 power4.out(expo.out 用于额外快速);入场时永不使用 .inOut。
  • 一个级联一个方向。
  • 将最后一个单词拆分为片段以延长高潮;片段移动更远。
  • 稳定后,组通常滑动以为下一节拍腾出空间 — 那就是 §7。

7. 微调曲线(场景内组滑动 — 不是接缝)

慢-快-慢重新定位一个已组成的组(单词行、卡片堆、列表)以显示内容或腾出空间。没有单一内置缓动可以产生它 — power4.inOut 会猛停。在一个属性上链式三个补间:

阶段缓动距离时间感觉
1 加速上升power3.in约 10%约 20%几乎不动 — 运动已注册,无冲击
2 爆发none(线性)约 65%约 18%约 2× 平均像素/帧 — 有目的性
3 尾部power4.out约 25%约 62%衰减蠕行至静止 — 消除猛击

规则:

  • 尾部的时间是加速上升的 ≥3 倍。如果仍然有猛击感:延长尾部的时间(不是距离)或使用 power5.out。
  • 阶段 2 保持线性 — 缓动它会失去爆发对比。
  • 在阶段 2 期间显示新内容 — 爆发掩盖了它的出现。
  • 相同比例垂直;按比例缩放距离,保持时间比例。

选择变体

缩放穿越反向缩放穿越切曲线瀑布切
范围场景内文字交换入场/回报节拍场景之间文字到文字接缝
Z 符号 / 轴增长(推进)缩小(拉回)X / YX,逐词
行程/缩放1→1.2,然后 0.75→11→0.8,然后 1.25→1±230px±230px
峰值模糊10px 文字 / 18–20 全帧10px 文字 / 18–20 全帧可选 8–10px无
缓动power3.in / expo.outpower3.in / expo.outpower4.in / power4.outpower4.in / power4.out
感觉深入探索到达被侧向携带跨接缝的波浪

反模式

不要而是
在接缝窗口内两个元素上使用不同的模糊值在交换帧上使用相同的峰值模糊
在入场中使用 .inOut 缓动(它使峰值速度居中,而不是放在剪切处)入场使用 .out,以在剪切处保持峰值速度
将全帧运动与缩放穿越混合 — 缩放穿越作用于 Z 轴对于场景间边界使用切曲线(XY 轴)
在瀑布入场中使用淡入(入场使用二进制不透明度 .set())入口使用 .set() 立即显示
对组重新定位使用 power4.inOut使用 §7 中的三阶段微调曲线
在瀑布切中一个链条使用多个方向一个链条一个方向,顺着电流而行
模糊直接应用于 <video> 元素用包装器包裹视频并模糊包装器
同时模糊和不透明度在同一个元素的一个补间中分成两个单独的补间

Individual skills in this repo

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

MattiaIppoliti/tia-skills

Import Figma content into a HyperFrames composition — rendered assets, brand tokens, components, storyboard sections → reconstructed motion (frames read as states, not slides) (REST/CLI), connector-assisted motion when available, and shaders from a connector or native export. Use when the user pastes a figma.com link or asks to bring a Figma design, frame, logo, brand, or animation into a video/composition.

MattiaIppoliti/tia-skills

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title. Route fresh creation through hyperframes before using this skill.

MattiaIppoliti/tia-skills

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

MattiaIppoliti/tia-skills

Use when audio already placed in a HyperFrames composition needs to be mixed: fade-in/fade-out, crossfade, track gain or volume, volume automation, ducking, a music bed that fights a voiceover (voiceover carve), effects on a track (EQ, compressor, limiter, gate, saturation, delay, reverb, chorus, phaser, bitcrush), or automation envelopes drawn on a track's volume or any effect parameter. Don't use for sourcing or generating audio — finding BGM, SFX, or making a voiceover is `/media-use`. Don't use for clip timing or track layout, which is `/hyperframes-core`.

MattiaIppoliti/tia-skills

Drive the Remotion CLI development loop: scaffold, studio, type-check, compositions, still probes, single and batch render, bundle, Lambda and Cloud Run rendering, benchmark, versions, upgrade, and GPU checks. Also use when diagnosing a build or render failure, or when looking for a capability the retired HyperFrames CLI used to own.

MattiaIppoliti/tia-skills

The composition contract for building one renderable Remotion project. Use for project structure, `<Composition>` registration, `<Sequence>` timing, layer/track ordering, scene components, props and schemas, framework-owned media playback, deterministic-render rules, and validation. Also covers Tailwind projects and the STORYBOARD.md / SCRIPT.md plan formats. Read before writing composition code.

相关技能