Communitygithub.com

Manavv007/S.A.R.A.L.—方案访问、检索与分析层

用于HyperFrames的所有动画知识——原子运动规则、多阶段场景蓝图、场景过渡、更广泛的动效设计技术,以及七种运行时适配器(GSAP默认,加上Lottie、Three.js、Anime.js、CSS关键帧、Web动画API、TypeGPU)。适用于任何动效或动画任务:选择2-4条规则进行组合,或加载蓝图,或查询特定运行时的API(例如GSAP缓动函数 / Lottie播放器 / Three.js混合器)。HyperFrames原生:单暂停时间线、安全寻帧、确定性。

S.A.R.A.L.—方案访问、检索与分析层 是什么?

该技能是HyperFrames框架中所有动效知识的集中地,为开发者提供了从原子级运动规则到复杂多阶段场景蓝图的完整创作体系。它支持七种运行时适配器,包括默认的GSAP、Lottie、Three.js、Anime.js、CSS关键帧、Web动画API和TypeGPU/WebGPU,允许在不同需求下灵活选择或混合使用。其核心机制是单条暂停的GSAP时间线,保证确定性渲染,避免使用`Math.random`或`Date.now`等非确定性函数。开发者可通过加载蓝图模板快速复用预设计的场景编排(如品牌展示、社交证明),或通过规则索引挑选2-4条原子规则组合,生成简洁高效的动画代码。该技能还提供了过渡、技术和脚本工具(如动画映射审计)来优化创作流程,并遵循HyperFrames核心契约(`hyperframes-core`)中的非协商规则,如预计算布局常量、仅使用GSAP变换别名等。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-/tree/HEAD/.agents/skills/hyperframes-animation

在你喜欢的 AI 中提问

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

文档

HyperFrames 动画

所有动效知识汇集于一个技能:规则(原子配方)、蓝图(多阶段场景模板)、过渡(场景到场景)、技术(更广泛的动效设计模式)和适配器(各运行时API)。

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

默认:组合原子规则

从 rules-index.md 中选择2-4条规则,用一条暂停的GSAP时间线将它们粘合在一起,完成。这比从蓝图开始更快,产生的代码也更少。

加载蓝图的情形

  • 当场景与现有的预设计多阶段模板匹配时(品牌展示、社交证明、演示页面滚动聚光灯等),复用其阶段管线可节省实际的创作时间
  • 当您想要一个可运行的、包含4-5个阶段复杂编排的真实代码时

蓝图位于 blueprints-index.md。每个条目指向 blueprints/<id>.md(配方)和 examples/<id>.html(可运行示例)。不要投机性地读取;只有在您已决定需要场景级编排时才加载。

路由

想要…读取
按触发器/标签选取一个原子运动模式rules-index.md
读取一条规则的完整HTML / CSS / GSAP配方rules/<name>.md
选取一个多阶段场景模板blueprints-index.md
读取一个蓝图的完整配方blueprints/<id>.md + examples/<id>.html
编写场景过渡(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动画API(element.animate(),currentTime 寻帧)adapters/waapi.md
TypeGPU / WebGPU(navigator.gpu,WGSL,计算管线)adapters/typegpu.md
纹理化HTML + WebGL/GLSL后特效(通过 drawElementImage 捕获实时DOM)adapters/html-in-canvas-patterns.md
命名的文字动画效果(通过外部 animate-text 技能的24个ID)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 内构建时间线)。此处不再赘述。

在核心契约基础上添加的动画创作注意事项:

  • 预计算布局常量 — 绝不在补间时从 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。在创作后使用它来审计编排(死区、交错一致性、生命周期警告)。

参见

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

Individual skills in this repo

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

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

The fallback workflow for authoring custom HyperFrames video compositions at any length or format — longer or multi-scene pieces, brand / sizzle reels, montages, title cards, static loops, and freeform compositions. Input- and length-agnostic. If a specialized workflow clearly fits the input — a marketed product, a website, a topic explainer, a GitHub PR, existing footage, a short motion graphic, or a Remotion port — prefer it (see /hyperframes); use this only as the general fallback when none fit.

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

HyperFrames CLI dev loop. Use when running npx hyperframes init, add, catalog, capture, lint, validate, inspect, layout, snapshot, preview, play, render, publish, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, tts, or remove-background, or when troubleshooting the HyperFrames build/render environment. Entry point for AWS Lambda cloud rendering (`hyperframes lambda deploy / render / progress / destroy / policies`).

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-animation`.

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

Capture a general website/URL and turn it into a HyperFrames video (site tour, showcase, or social clip from the site's own visuals). Uses headless Chrome screenshots + brand assets. Use when intent is general — portfolio/blog/landing-page showcase or social clip from the site. NOT for: product/SaaS launch or promo (→ /product-launch-video, even from a URL); topic explainer with no site (→ /faceless-explainer); GitHub PR (→ /pr-to-video); adding captions to existing video (→ /embedded-captions); short unnarrated page-highlight motion graphic (→ /motion-graphics). Unclear launch-vs-general-site? Ask one question or start at /hyperframes.

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

Audio and media assets for HyperFrames compositions, produced by one shared audio engine (`scripts/audio.mjs`) — multi-provider TTS (HeyGen / ElevenLabs / Kokoro local), background music + sound effects (HeyGen audio-library retrieval by default, with local Lyria / MusicGen BGM generation and a bundled SFX library as the no-credential fallback), Whisper transcription, background removal, and caption authoring. Use for voiceover / TTS, BGM, SFX / sound effects, transcription, captions / subtitles / lyrics / karaoke / per-word styling, voice + provider selection, and music-mood prompting.

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

S.A.R.A.L. is an advanced AI-powered platform designed to bridge the "information gap" between rural Indian citizens and government welfare. While thousands of schemes exist, the complex language of official PDFs often makes them inaccessible to the common man.

相关技能