Communitygithub.com

MattiaIppoliti/tia-skills

所有面向 HyperFrames 的动效知识——原子运动规则、多阶段场景蓝图、场景过渡、更广泛的动效设计技术,以及七个运行时适配器(默认 GSAP,外加 Lottie、Three.js、Anime.js、CSS 关键帧、Web Animations API、TypeGPU)。适用于任何动效任务:挑选 2-4 条规则组合,加载蓝图,或查找特定运行时 API(如 GSAP 缓动/Lottie 播放器/Three.js 混合器)。还涵盖审计现有合成动画编排(动画映射)和 24 种命名文本动画效果。HyperFrames 原生:单一暂停时间线、可安全 seek、确定性。

tia-skills 是什么?

该技能是 HyperFrames 动画系统的核心知识库,提供了从原子运动规则到高级多阶段场景蓝图的完整动效设计工具箱。它涵盖了七个运行时适配器(GSAP、Lottie、Three.js 等),允许开发者在单个合成中自由组合不同运行时。技能中包含规则索引、蓝图目录、场景过渡文件,以及用于审计动画编排的脚本工具。对于任何动效任务,用户可以快速挑选 2-4 条规则组合,或加载预设计的多阶段模板(如品牌揭示、社交证明)。需要特别注意的是,尽管代码示例目前针对已退役的 HTML + 暂停 GSAP 时间线运行时编写,但动效工艺本身(定时、缓动选择、动作形状等)在 Remotion + React 框架下仍然有效。开发者需谨慎阅读技能开头的翻译对照表,将 GSAP 示例转换为 Remotion 的 `interpolate`、`spring` 等 API 调用,避免直接粘贴。

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

在你喜欢的 AI 中提问

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

文档

⚠ 合约状态:工艺当前,代码已过时

此堆栈的输出框架是 Remotion + React(/hyperframes-core)。 此处的动效工艺仍然适用:定时、缓动选择、动作形状、命名规则和蓝图。 代码则不适用:示例和适配器是针对已退役的 HTML + 暂停 GSAP 时间线运行时编写的。

阅读时请进行如下翻译对照:

此处在 Remotion 中
gsap.fromTo(el, {x:-40}, {x:0, duration:0.5})interpolate(frame, [0, SEC(0.5)], [-40, 0], {…"clamp"})
ease: "back.out(1.7)"spring({frame, fps, config:{damping}}),目视调整
暂停时间线 window.__timelines[id]无;每个值都是 useCurrentFrame() 的函数
片段上的 data-start / data-duration<Sequence from> / durationInFrames,以帧为单位
CSS 关键帧或过渡基于帧的内联 style(CSS 动画不渲染)

切勿将本技能中的任何示例未经修改直接粘贴到 Remotion 项目中。

HyperFrames 动画

单个技能包含所有动效知识:规则(原子配方)、蓝图(多阶段场景模板)、过渡(场景间切换)、技巧(更广泛的动效设计模式)和适配器(各运行时 API)。

关于合成合约(数据属性、子合成、确定性),请参阅 hyperframes-core。

默认方式:组合原子规则

从 rules-index.md 中挑选 2-4 条规则,用单个暂停的 GSAP 时间线将它们组合起来即可。这比从蓝图开始更快,且产生更少的代码。

何时加载蓝图

  • 当前场景匹配现有的预设计多阶段模板(品牌揭示、社交证明等),并且重用其阶段流水线可以节省实际创作时间
  • 你想要一个复杂 4-5 阶段编排的可运行参考代码

蓝图位于 blueprints-index.md。每个条目指向 blueprints/<id>.md(配方)。请勿无目的地阅读;仅当你已确定需要场景级编排时才加载它。

路由

目标…阅读
根据触发条件/标签挑选原子运动模式rules-index.md
阅读某条规则的完整 HTML / CSS / GSAP 配方rules/<name>.md
挑选多阶段场景模板blueprints-index.md
阅读某蓝图的完整配方blueprints/<id>.md
创作场景过渡(CSS 驱动,在两个片段之间)transitions/overview.md,transitions/catalog.md
查找更广泛的动效设计技巧techniques.md
分析现有合成的动画映射scripts/animation-map.mjs
GSAP API — 时间线 / 补间 / 位置参数adapters/gsap.md
GSAP — 直接可用的效果配方rules/gsap-effects.md
GSAP — 变换 / 性能adapters/gsap-transforms-and-perf.md
GSAP — 缓动 / 交错adapters/gsap-easing-and-stagger.md
GSAP — 时间线 / 标签adapters/gsap-timeline-and-labels.md
Lottie / dotLottie(After Effects 导出,window.__hfLottie)adapters/lottie.md
Three.js / WebGL(3D 场景,AnimationMixer,hf-seek)adapters/three.md
Anime.js(window.__hfAnime)adapters/animejs.md
CSS 关键帧(animation-delay / play-state / fill-mode)adapters/css-animations.md
Web Animations API(element.animate(),currentTime seek)adapters/waapi.md
TypeGPU / WebGPU(navigator.gpu,WGSL,计算管线)adapters/typegpu.md
HTML 作为纹理 + WebGL/GLSL 后期特效(通过 drawElementImage 捕获实时 DOM)adapters/html-in-canvas-patterns.md
命名文本动画效果(24 个 ID,通过外部 animate-text 技能)adapters/animate-text.md

选择运行时

  • GSAP 是 95% 动效工作的默认选择——涵盖时间线编排、变换、缓动、交错。本技能中的所有原子规则都基于 GSAP。
  • Lottie 用于拥有自己预烘焙时间线的资源(通常是 After Effects 导出)。
  • Three.js 用于 3D 场景、摄像机运动、着色器驱动的视觉效果。
  • Anime.js 用于轻量级补间(当 GSAP 过于繁重时)。
  • CSS 用于简单的重复图案、装饰、闪烁——无需 JavaScript 动画成本。
  • WAAPI 用于无需 GSAP 依赖的原生浏览器关键帧。
  • TypeGPU / WebGPU 用于 GPU 渲染的画布(粒子、液体玻璃、自定义着色器)。

多个运行时可以在单个合成中共存。每个运行时都会将其实例注册到运行时特定的全局对象上,以便 HyperFrames 能够在一次遍历中 seek 所有实例。

关键约束

先决条件:hyperframes-core → 不可协商的规则(单一暂停时间线,data-duration 控制长度,不能使用 Math.random / Date.now / performance.now,不能使用 repeat: -1,不能在后场景片段上进行页面加载时的 gsap.set,不能使用 display 或原始 visibility 补间,不能在 async / setTimeout / Promise 内部构建时间线)。核心框架允许 GSAP 的 autoAlpha 和在明确的时间线边界上的零持续时间可见性设置。仅对非片段元素或片段内的包装器使用这些例外;框架拥有 .clip 的生命周期。此处不再重复完整合约。

在核心合约基础上增加的动画工艺约束:

  • 预计算的布局常量 — 绝不在补间时从 getBoundingClientRect() 推导位置。补间时进行 DOM 测量会导致不同步,因为渲染器并行采样;在合成设置时一次性计算坐标并复用。
  • 空间运动仅使用 GSAP 变换别名(x,y,scale,rotation)。核心允许列表也允许对非空间属性补间使用 opacity / color / backgroundColor / borderRadius — 但绝不对布局更改使用 width / height / top / left。

脚本

node skills/hyperframes-animation/scripts/animation-map.mjs <合成目录> \
  --out <合成目录>/.hyperframes/anim-map

读取注册在 window.__timelines 上的每个 GSAP 时间线,枚举所有补间,采样边界框,计算标志,输出 animation-map.json。在创作后使用它来审计动画编排(死区、交错一致性、生命周期警告)。

animation-map.mjs 首先从当前项目解析辅助包,然后可以引导捆绑的 HyperFrames 包版本。仅当在捆绑的 CLI/技能安装之外运行该技能,并且需要显式固定该引导版本时,才设置 HYPERFRAMES_SKILL_PKG_VERSION=<版本>。

参见

  • hyperframes-core — 合成结构、数据属性、子合成、确定性渲染合约
  • hyperframes-creative — 调色板、排版、叙事、节拍规划(非动画创意指导)
  • hyperframes-cli — npx hyperframes lint / check / snapshot / preview / render

Individual skills in this repo

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

MattiaIppoliti/tia-skills

The technique catalog: five velocity-matched SEAMS (zoom-through, INVERSE zoom-through, cut-the-curve, waterfall cut, rack-focus blur-cut) plus the two in-scene techniques — waterfall ENTRY (staggered arrival cascades for title cards / segment openers) and the nudge curve (slow-fast-slow three-phase group slides). Covers partial-travel (~12% of frame) velocity matching via mirrored power4 eases, the Z scale-sign rule, size-scaled blur (10px text / 18-20px full-frame), word-by-word staggered cuts, cascade pacing by element weight, and the 10/65/25 slide ratio. Read before authoring any transition, text-beat handoff, kinetic text entry, or group reposition. [depth, zoom, inverse-zoom, scale-sign, mirrored-zoom, rack-focus, pacing, velocity, cut-the-curve, waterfall, stagger, cascade, kinetic-text, title-card, segment-opener, nudge, slide, easing, group-motion, z-depth, motion-graphics, cinematic, transition, blur, directional-continuity]

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

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.

相关技能