用途 HyperFrames Animation 是面向 HyperFrames 组合的动画知识技能，集中提供运动规则、场景模板、转场、技法与运行时适配接口。该技能默认以组合原子规则的方式工作：从 rules-index.md 选取 2-4 条规则，用一条暂停的 GSAP 时间线串联。资料称这种做法比从蓝图起步更快、代码更少。
主要能力
- 规则（atomic recipes）：原子运动配方，全部基于 GSAP。
- 蓝图（blueprints）：多阶段场景模板，如品牌揭示、社会证明等；当场景匹配既有模板或需要复杂 4-5 阶段编排的可运行基准代码时加载。蓝图入口为 blueprints-index.md，每条指向 blueprints/<id>.md。
- 转场：CSS 驱动的两个片段之间的场景转场，见 transitions/overview.md 与 transitions/catalog.md。
- 技法：更广泛的运动设计模式，见 techniques.md；运动模糊见 references/motion-blur.md。
- 适配器：按运行时提供 API，包括 GSAP（时间线、补间、位置参数；效果配方；变换与性能；缓动与交错；时间线与标签）、Lottie/dotLottie（含角色动画）、Three.js/WebGL、Anime.js、CSS 关键帧、Web Animations API、TypeGPU/WebGPU、HTML-as-texture 与 GLSL 后处理，以及通过外部 animate-text 技能提供的 24 个命名文字动画效果。
使用方式 技能提供按需求路由的表格：按触发/标签选择原子运动模式读 rules-index.md；查看单条规则的完整 HTML/CSS/GSAP 配方读 rules/<name>.md；选择多阶段场景模板读 blueprints-index.md；编写转场读 transitions 目录；查询运动技法读 techniques.md；分析既有组合的动画映射使用脚本 animation-map.mjs；GSAP API 查 adapters/gsap.md。资料建议不要预先投机读取蓝图，只有在确定需要场景级编排时才加载。
运行时选择 GSAP 覆盖约 95% 的运动工作，包括时间线编排、变换、缓动、交错，所有原子规则均基于 GSAP。Lottie 用于自带预烘焙时间线的资产（典型为 After Effects 导出），包括行走、手势或反应的角色。Three.js 用于 3D 场景、镜头运动和着色器视觉。Anime.js 为轻量补间。CSS 用于简单重复图案、装饰、微光等无需 JS 动画开销的场景。WAAPI 用于不依赖 GSAP 的原生浏览器关键帧。TypeGPU/WebGPU 用于粒子、液态玻璃、自定义着色器等 GPU 渲染画布。多个运行时可在同一组合中共存，各实例注册到对应全局对象，以便 HyperFrames 一次遍历全部寻址。
关键约束 前置要求为 hyperframes-core，其契约包括：单一暂停时间线、由 data-duration 决定长度、禁用 Math.random/Date.now/performance.now、无有限根 data-duration 时不得使用 repeat: -1、不得对后续场景片段做页面加载时的 gsap.set、不得对 display 或原始 visibility 做补间，并且时间线必须在完全构建后才注册（包括在 document.fonts.ready 等异步回调中构建的情况）。GSAP 的 autoAlpha 和显式时间线边界上的零时长 visibility 设置在 core 中仍被允许，但仅用于非片段元素或片段内部包装器，片段生命周期由框架管理。动画工艺在 core 契约之上另加要求：布局常量必须预计算，禁止在补间时用 getBoundingClientRect() 推导位置，因为渲染器并行采样会导致测量失步，应在组合初始化时计算一次并复用；空间运动仅用 GSAP 变换别名（x、y、scale、rotation），core 允许非空间属性补间使用 opacity/color/backgroundColor/borderRadius，但绝不能用 width/height/top/left 做布局变化。
脚本 运行 node <SKILL_DIR>/scripts/animation-map.mjs <composition-dir> --out <composition-dir>/.hyperframes/anim-map，可读取 window.__timelines 上注册的所有 GSAP 时间线，枚举补间、采样包围盒、计算标志，输出 animation-map.json，用于编写后审计编排（死区、交错一致性、生命周期警告）。该脚本优先从当前项目解析辅助包，之后可引导打包的 HyperFrames 包版本；仅在捆绑 CLI/技能安装之外运行且需显式固定引导版本时，设置 HYPERFRAMES_SKILL_PKG_VERSION=<version>。
适用场景与限制 适用于在 HyperFrames 中制作确定性动画组合，如品牌揭示、转场、角色动画、3D 与着色器视觉、文字动画等。限制在于必须遵循 hyperframes-core 的组合契约与上述动画附加约束；不同运行时需按其适配器文档使用；插件场景下安装需遵循插件执行规则，独立安装保持资料中的更新说明。