Communitygithub.com

Avinash1286/pendent

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

pendent 是什么?

该技能封装了 HyperFrames 生态中所有动画相关知识,提供从原子级运动规则到多阶段场景蓝图、场景过渡及泛用动效设计技巧的完整工作流。它默认采用 GSAP 作为主要运行时,同时支持 Lottie、Three.js、Anime.js、CSS 关键帧、Web Animations API (WAAPI) 和 TypeGPU (WebGPU) 六种适配器,允许在同一个合成中混用多个运行时。用户可以通过 skill 目录下的索引文件快速选取规则或蓝图,生成可运行的 HTML/CSS/GSAP 代码片段,并利用 `animation-map.mjs` 脚本审查合成的时间线编排,检查死区、多帧一致性和生命周期警告。该技能严格遵守 HyperFrames 核心契约(单一暂停时间线、`data-duration` 主导时长、无随机性),并针对布局常量预计算和仅使用 GSAP 变换别名(`x`/`y`/`scale`/`rotation`)等动效实现细节给出了明确的约束指南。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Avinash1286/pendent/tree/HEAD/film/docs

在你喜欢的 AI 中提问

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

文档

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 可以在一次遍历中寻找所有实例。

关键约束

先决条件: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 <composition-dir> \
  --out <composition-dir>/.hyperframes/anim-map

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

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

参见

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

相关技能