Communitygithub.com

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

HyperFrames 组合合约 —— 构建一个可渲染项目。用于组合结构、`data-*` 时序属性、`class="clip"`、轨道、子组合、变量、框架自有的媒体播放、确定性渲染规则及验证。在编写组合 HTML 前请先阅读。

S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer- 是什么?

该技能是 HyperFrames 框架的核心技术合约,它定义了一个 HTML 组合的运行规则。HyperFrames 通过 HTML 文件中的 `data-*` 属性声明时序,实现视频渲染。组合是一个 DOM 结构,支持可搜索的时间线,框架拥有媒体播放控制权。开发者需要遵循一系列严格的规则,包括确定性渲染(禁止运行时时钟、未种子化的随机数、网络请求等)、动画属性白名单、子组合的模板包裹方式、以及媒体元素必须直接作为组合根的子节点等。该合约还提供了详细的参考文档索引,覆盖最小组合、轨道与剪辑、子组合、变量与媒体、全屏运动、故事板格式、脚本格式以及 Tailwind 集成等主题。使用本技能前,开发者必须确保 `npx hyperframes lint`、`validate` 和 `inspect` 命令通过验证。

兼容平台~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-core

在你喜欢的 AI 中提问

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

文档

HyperFrames 核心

HyperFrames 通过 HTML 渲染视频。组合是一个 HTML 文件,其 DOM 使用 data-* 属性声明时序,动画运行时是可搜索的,媒体播放由框架拥有。

该技能是技术合约 —— 如何构建一个 HyperFrames 项目。以下正文是构建指南;每个主题的详细内容位于 references/ 中(索引见下),按需阅读。其他关注点位于同级领域技能中 —— hyperframes-animation、hyperframes-creative、hyperframes-media、hyperframes-cli、hyperframes-registry。/hyperframes 中的能力图谱说明了每个覆盖的内容。

参考

文件阅读目的
references/minimal-composition.md从最小的可渲染组合骨架开始
references/composition-patterns.md选择单体式或模块式;构造模块式 index.html;选取子组合原型
references/data-attributes.md查找任何 data-*(根/剪辑/子组合宿主/遗留别名);使用 class="clip"
references/tracks-and-clips.md选择 data-track-index、处理同一轨道重叠/z-index、相对于另一个剪辑计时
references/sub-compositions.md连接子组合(宿主属性、<template>、每个实例的变量)并在其内部动画
references/variables-and-media.md声明变量;放置 <video>/<audio>、设置音量、修剪
references/determinism-rules.md构建可搜索的时间线;确定性禁止规则;可动画属性白名单;布局/文本适配
references/full-screen-motion.md使用共享背景制作全帧运动
references/storyboard-format.md编写 STORYBOARD.md 计划(以及解析后的清单)
references/script-format.md编写可选的 SCRIPT.md 锁定的旁白
references/subagent-dispatch.md将子代理调度动词(并行扇出/后台/等待)映射到你的工具链
references/tailwind.md在 Tailwind v4 项目中工作(init --tailwind;运行时合约与 Studio 的 v3 不同)

对于动画运行时细节(GSAP API、Lottie、Three.js 等)请转到 hyperframes-animation → adapters/<runtime>.md。

构建组合

两种根形式(不可互换)

  • 独立式(顶级 index.html)—— 根 <div data-composition-id="…"> 直接位于 <body> 中,没有 <template> 包裹(包裹会隐藏所有内容并破坏渲染)。
  • 子组合(通过 data-composition-src 加载)—— 根必须包裹在 <template> 中。

⚠ 传输规则:运行时仅克隆 <template> 内容;外部所有内容(包括 <head> 样式/脚本)都会被丢弃 —— 将 <style>/<script> 放在模板内部。 ⚠ 宿主 ID 规则:宿主插槽的 data-composition-id 必须完全等于内部模板的 data-composition-id 以及 window.__timelines["<id>"] 键 —— 没有 -mount/-slot/-host 后缀。

文件形状、宿主连接以及预渲染检查清单 → references/sub-compositions.md。

根必须有尺寸(静默布局错误)

独立式根需要一个显式的有尺寸的盒子(以 px 为单位的 width/height),并且向上到 height:100% 元素的每个祖先都必须有解析的高度 —— 否则 flex/100% 子元素会折叠到 ~0 且内容堆叠到左上角。lint/validate/inspect 不会捕获此问题。骨架 → references/minimal-composition.md。

一个暂停的时间线

每个组合在 window.__timelines["<id>"] 注册恰好一个 gsap.timeline({ paused: true })(键 = 根的 data-composition-id),在页面加载时同步构建。渲染持续时间 = 根的 data-duration,而不是时间线长度。不要手动将子时间线嵌套到宿主中。完整合约(包括非 GSAP 运行时)→ references/determinism-rules.md + hyperframes-animation/adapters/。

不可协商的规则(lint/validate/inspect 不会捕获的静默错误)

在此列出;完整理由在链接的参考中。不得违反:

  • 无渲染时时钟 / 未种子化的 Math.random / 网络 / 输入状态;无 repeat: -1(使用有限计数)。 → determinism-rules.md
  • 仅对可视化属性白名单进行动画;绝不用 display/visibility;后续场景的剪辑不使用 gsap.set。 → determinism-rules.md
  • 正文文本中无 <br>;变换后的元素必须为块级且有尺寸;脉冲式绝对装饰元素需要峰值间隙。 → determinism-rules.md
  • <video>/<audio> 必须是宿主根的直接子元素(绝不能位于子组合 <template>/包裹器内部);框架拥有播放控制权。 → variables-and-media.md
  • 每个 id 必须跨组装后的页面唯一;在子组合内部,以组合 ID 为 id 添加前缀(#<id>-hero)。重复的 <video>/<img> 的 id 会渲染为空白 —— 生产者通过 getElementById 注入帧,跨文件重复会绕过 lint。 → composition-patterns.md
  • 全屏场景填充应放在全出血子元素上(position:absolute; inset:0),绝不能放在组合根元素上 —— 生产者的帧合成可能丢弃根元素自身的 background(帧渲染为黑色),即使预览/snapshot 正确显示。 → composition-patterns.md

编辑现有组合

  • 首先阅读文件。保留不相关的时序、轨道、ID、变量、媒体路径。
  • 匹配现有的组合 ID 和时间线键。
  • 添加剪辑:选择一个非重叠的 data-track-index 或有意调整周围时序。
  • 添加子组合:在连接宿主之前验证其内部的 data-composition-id。

验证

使用 hyperframes-cli 获取命令详情

  • npx hyperframes lint 通过(0 错误)
  • npx hyperframes validate 通过(0 控制台错误)
  • npx hyperframes inspect 通过(0 错误)
  • 包含子组合的项目:npx hyperframes snapshot --at <midpoints> 并目测每一帧
  • npx hyperframes preview 用于审查(用户可以在 Studio 的时间线中编辑任何内容)
  • 仅在用户批准后执行 npx hyperframes 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-

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). HyperFrames-native: single paused timeline, seek-safe, deterministic.

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-

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.

相关技能