Communitygithub.com

sansayan01/finance_app_zo

HyperFrames 合成契约——构建一个可渲染项目。用于合成结构、`data-*` 时序属性、`class="clip"`、轨道、子合成、变量、框架自有媒体播放、确定性渲染规则及验证。也涵盖 Tailwind 项目和 STORYBOARD.md / SCRIPT.md 计划格式。在编写合成 HTML 前阅读。

finance_app_zo 是什么?

该技能定义了 HyperFrames 框架的**技术契约**,指导开发者如何构建一个完整的视频合成 HTML 项目。它详细说明了通过 `data-*` 属性声明 DOM 时序、框架控制媒体播放、以及可检索动画运行时的核心机制。技能内容覆盖了从零开始的可渲染合成模板、模块化与单体结构的选择、轨道与片段管理、子合成嵌套与变量传递,以及严格的确定性渲染规则(例如禁止运行时时钟、无限重复、以及未许可的动画属性)。此外,它还提供了 Tailwind v4 项目集成、STORYBOARD.md / SCRIPT.md 计划格式编写、以及子代理分发命令的参考指南。该技能主要服务于使用 HyperFrames 进行视频生成的开发者,帮助他们遵循框架约束,避免常见的布局和渲染错误。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/sansayan01/finance_app_zo/tree/HEAD/.agents/skills/hyperframes-core

在你喜欢的 AI 中提问

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

文档

HyperFrames 核心

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

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

参考文献

文件阅读目的…
references/minimal-composition.md从最小的可渲染合成骨架开始
references/composition-patterns.md选择单体 vs 模块化;构建模块化 index.html;选择子合成原型类型
references/data-attributes.md查找任何 data-*(根级属性/剪辑/子合成宿主/遗留别名);使用 class="clip"
references/tracks-and-clips.md选择 data-track-index,处理同一轨道重叠/z 索引,将片段相对于另一个片段计时
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/brief-contract.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。

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

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

一条暂停的时间线

每个合成在 window.__timelines["<id>"](键 = 根 data-composition-id)处注册恰好一条 gsap.timeline({ paused: true }),在页面加载时同步构建。渲染持续时间 = 根 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-hidden 会使其在预览和渲染中均被隐藏,覆盖其时间窗口;这是非破坏性/可逆的,由 Studio 时间线中的眼睛图标切换。
  • 添加子合成:在连线宿主之前,验证其内部的 data-composition-id。

验证

使用 hyperframes-cli 获取命令详情

  • npx hyperframes check 通过(0 条发现:lint、运行时、布局、运动和对比度)
  • 包含子合成的项目: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.

sansayan01/finance_app_zo

Add captions to a talking-head video. ONE catalog (CATALOG.md) of 36 visual identities behind two engines: column-flow (captions composited INTO the scene — matte occlusion + mix-blend; cream/ink/editorial/keynote/documentary/loud/neon/glitch/chrome/velocity) and themed constitutions (anchor/ordnance/terminal/neonsign/stardust/stomp/scoreboard/transit/vhs/arcade/dossier/laser/thunder/hologram/biolume/aurora/spectrum/papercut/popup/chalkboard/graffiti/brush/inkwater/ransom/lastpage/nightcity — e.g. a glyph-decode climax, a neon sign WRITTEN stroke by stroke, or the quiet `anchor` rail default). Route by identity, never by mode. Trigger on "captions/subtitles", "embed/cinematic captions", "VFX captions", "炸/特效/酷炫字幕", a named identity, or top-tier motion-graphics asks. Embedding every word is wrong for most talking-head content — `anchor` is the verbatim default. Runs locally end-to-end (transcribes and mattes the subject itself, no API key). Requires hyperframes and a single-subject clip (multi-shot clips ar...

sansayan01/finance_app_zo

The fallback workflow for authoring or editing any custom HyperFrames composition at any length or format — longer / multi-scene pieces, brand and sizzle reels, montages, title cards, static loops, freeform builds. Use only when no specialized workflow fits the input; routing table at /hyperframes.

sansayan01/finance_app_zo

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). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

sansayan01/finance_app_zo

HyperFrames CLI dev loop. Use when running npx hyperframes init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, render, publish, cloud, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, tts, or remove-background (validate/inspect/layout are deprecated aliases covered by check), or when troubleshooting the HyperFrames build/render environment. Entry point for HeyGen-hosted cloud rendering (`hyperframes cloud render / list / get / delete`) and self-managed AWS Lambda rendering (`hyperframes lambda deploy / render / progress / destroy / policies / sites`).

sansayan01/finance_app_zo

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`.

sansayan01/finance_app_zo

Use when a HyperFrames composition needs seek-safe 2D/3D keyframes, GSAP timelines, CSS keyframes, Anime.js, WAAPI, FLIP, paths, masks, SVG morph/draw, text trails, 3D depth, or `hyperframes keyframes` diagnostics. Don't use for broad scene strategy, brand design, media sourcing, captions, or general video planning.

sansayan01/finance_app_zo

MicroFlow Pro - MFI Staff Portal built with Flutter & Supabase

相关技能