Communitygithub.com

sansayan01/finance_app_zo

用于 HyperFrames 合成中需要安全寻址的 2D/3D 关键帧、GSAP 时间线、CSS 关键帧、Anime.js、WAAPI、FLIP、路径、遮罩、SVG 形变/绘制、文字拖尾、3D 景深或 `hyperframes keyframes` 诊断的场景。不适用于宏观场景策略、品牌设计、素材获取、字幕或常规视频规划。

finance_app_zo 是什么?

HyperFrames Keyframes 是一个针对 AI Agent 的精确技能,专为 HyperFrames 生态下的合成动画开发而设计。它定义了关键帧作为“姿态合约”,确保动画的可见状态、主体连续性、运行时寻址安全和像素级别的验证。该技能支持 GSAP、CSS 关键帧、Anime.js 和 WAAPI 等主流动画运行时,并要求开发者采用同步构建模式,避免使用 `Date.now()`、随机数或异步时间线等不可寻址机制。通过严格的诊断流程(lint、validate、`hyperframes keyframes`、`--shot` 和快照),开发者可以验证动画的每一帧,包括起始姿态、证明姿态、最终姿态和过渡细节。它还提供了针对 SVG 形变、3D 景深、Canvas/WebGL 动画以及文本动画的专属建议和诊断工具,帮助开发者避免常见的动画错误,如身份断裂、伪 3D 或不可读文本。总之,它是 HyperFrames 中实现精确、可验证、生产级关键帧动画的权威指南。

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

在你喜欢的 AI 中提问

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

文档

HyperFrames 关键帧

关键帧是一种姿态合约:可见状态、连续的主体身份、安全的运行时寻址、经过验证的像素。

使用 hyperframes-animation 来处理广泛的场景配方。 使用 hyperframes-cli 获取完整的命令文档。 仅在需要选择实现机制(而非视觉风格)时,才使用 references/keyframe-patterns.md。

操作流程

  1. 识别动画主体、可见状态、最终状态和运行时间。
  2. 选择能满足提示的最小机制。仅在机制不明确时阅读 references/keyframe-patterns.md。
  3. 在声明的运行时中编写安全的可寻址关键帧。同步构建并注册运行时实例。
  4. 使用 lint、validate、hyperframes keyframes、一个集中的 --shot 以及在证明时刻的快照进行验证。
  5. 如果证明失败,修复源关键帧并重新运行最小的失败诊断程序,然后再进行渲染。

合约

  • 命名移动的主体。
  • 命名证明预期运动所需的姿态,包括最终状态。
  • 关键帧作用于可见通道,而非隐藏的辅助状态。
  • 当连续性重要时,保持对象身份不变。
  • 仅在目标运动是替换或溶解时才使用交叉淡入淡出。
  • 保持可读或语义状态足够长的时间以便看到。
  • 最后一帧是动画的一部分,而非清理操作。
  • 除非要求,否则不要重置为静止状态。
  • 除非要求,否则不要以黑屏结束。
  • 如果要编辑起始场景,除非要求重新设计,否则保持布局、副本、资源、颜色和最终状态不变。

运行时规则

GSAP:

  • 在页面加载时同步构建
  • 使用 gsap.timeline({ paused: true })
  • 注册为 window.__timelines[compositionId]
  • 注册键必须匹配 data-composition-id
  • 不要为渲染关键的运动调用 tl.play()
  • 保持循环次数有限

CSS 关键帧:

  • 有限的持续时间和迭代次数
  • 确定的延迟
  • animation-fill-mode: both
  • 当时间线属于某个片段时使用 data-start

Anime.js:

  • 同步创建
  • autoplay: false
  • 有限的持续时间和循环次数
  • 将每个实例推送到 window.__hfAnime

WAAPI:

  • 有限的 duration
  • fill: "both"
  • 确定的构建方式
  • 文本表面不列出 WAAPI;使用 --shot(它会寻址 WAAPI)和快照进行验证

绝不用于渲染关键的运动:

  • Date.now()
  • performance.now()
  • 未设置种子的 Math.random()
  • 悬停/滚动触发器
  • 定时器
  • 异步创建的时间线
  • 未注册的 requestAnimationFrame
  • 无限循环

GSAP 骨架

const root = document.querySelector("[data-composition-id]");
const compositionId = root.dataset.compositionId;
const tl = gsap.timeline({ paused: true });

tl.addLabel("state-a", 0);
tl.to(".subject", {
  keyframes: [
    { x: 0, opacity: 1, duration: 0.2 },
    { x: 120, opacity: 1, duration: 0.4, ease: "power2.out" },
    { x: 100, opacity: 1, duration: 0.2, ease: "power2.inOut" },
  ],
  ease: "none",
});

window.__timelines = window.__timelines || {};
window.__timelines[compositionId] = tl;

使用标签表示语义状态。 使用位置参数而非链式延迟。 对于稍后影响同一属性的 from()/fromTo() 补间动画,使用 immediateRender: false。

关键帧形式

  • 数组关键帧:具有每步持续时间和缓动的姿态阶梯。
  • 百分比关键帧:单个补间动画内的精确时间。
  • 属性数组:紧凑的多停靠点变化。
  • 当每个停靠点都有自己的缓动时,在父级上使用 ease: "none"。
  • 当每个片段应共享相同感觉时使用 easeEach。

不要从示例中复制数字距离或时间。从实际合成的几何形状和持续时间中推导它们。

对于一个在两个框之间移动的主体,优先使用一个连续的变换补间动画或 FLIP。仅当希望观看者感受到明显的节拍时,才将 x/y/scale 拆分为多个缓动的关键帧;每个片段都会改变速度,并可能被视为卡顿。

通道

优先使用合成器/视觉通道: x/y/z、xPercent/yPercent、scale、rotationX/Y/Z、skew、transformOrigin、svgOrigin、opacity、autoAlpha、clip-path、遮罩、CSS 变量、SVG 路径/描边值、相机变换、着色器统一变量。

避免使用布局/生命周期通道: top/left/right/bottom、width/height、margin/padding、display、visibility、延迟的 DOM 创建、执行主体运动的辅助叠加层。

机制选择

选择能满足提示的最小机制:

需求机制
同一主体改变盒子或层级共享元素 / FLIP
主体沿可见路线行进路径行进
描边增长或勾勒描边绘制
一个形状变为另一个形状形状插值
显示边界可见裁剪、遮罩或着色器统一变量
许多项目按顺序移动交错 / 索引延迟
文字本身移动行、词、字或波段细分
表面弯曲、拉伸或裁切父/子反向变换
UI 具有状态显式状态机
场景具有景深DOM 3D、Three.js 或 WebGL 相机/对象关键帧

机制可以组合,但每个机制必须阐明概念。装饰不是证明。

时间

  • 只有在它能解释原因或方向时才使用预期。
  • 加速离开静止状态。
  • 峰值证明应明确无误地展示机制。
  • 后续动作体现能量和方向。
  • 仅当主体感觉有弹性或触感时才使用过冲。
  • 恒定速度的路径行进通常需要 ease: "none"。
  • 离散的 UI 状态通常需要锐利的缓出。
  • 重复元素需要有序偏移,而不是相同的时间。
  • 最终的锁定需要比过渡姿态更长的保持时间。
  • 平滑度意味着同一主体上的连续速度。
  • 不要重叠写入同一变换属性的补间动画,除非重叠是故意的并且经过验证。
  • 避免在相同的主体表面同时缩放或移动时,动画化大型 clip-path/遮罩变化;在主移动稳定后使用嵌套显示。

文本

保留行框、词间距、可读性和最终适配。如果文本内部移动,移动字形或遮罩波段,而不仅仅是文本周围的装饰。快照可读帧。

SVG

对于描边增长,优先使用 DrawSVGPlugin,然后是 stroke-dasharray/stroke-dashoffset。 对于形状插值,优先使用 MorphSVGPlugin;必要时将基本形状转换为路径,并将复杂轮廓拆分为更简单的部分。

3D

单独缩放是伪景深。 在稳定的父级上使用透视、transform-style: preserve-3d、z 轴移动、旋转、相机/世界运动、遮挡、以及当对象交叉时的图层顺序。

使用一个或两个能够揭示景深关系的诊断角度。如果角度证明未显示景深交叉,改进 z 轴/相机/遮挡。

Canvas / WebGL

通过确定性状态关键帧处理相机位置、相机目标、对象变换、材质不透明度、着色器统一变量和后处理强度。从 HyperFrames 时间渲染。使用 --ghost,因为标记框无法看到内部画布运动。

CLI 证明

npx hyperframes lint
npx hyperframes check
npx hyperframes keyframes .
npx hyperframes keyframes . --json
npx hyperframes keyframes . --runtime all
npx hyperframes keyframes . --selector "<selector>" --shot "<file>" --samples <n>
npx hyperframes keyframes . --selector "<selector>" --shot "<file>" --layout strip --from <t0> --to <t1>
npx hyperframes keyframes . --shot "<file>" --ghost --angle <angle>
npx hyperframes snapshot . --at <times>

为实际的动画主体选择 <selector>。 为第一帧、证明姿态、最终减去保持和精确最终选择 <times>。 仅当需要证明景深时才选择 <angle>。

工具证明内容
keyframes目标、显式停靠点、路径、轨迹、组合的父/子运动、CSS 停靠点、Anime 注册
--shot幽灵、路线形状、时间间隔、DOM 3D 投影、聚焦的选择器证明
--layout strip原位运动、重叠、接触、细微的缩放/不透明度、文字波动
--ghostCanvas、WebGL、着色器运动、渲染的 3D
snapshot --at遮罩、文字可读性、完整状态、最终锁定、黑色/重置尾部

如果选择器证明看起来错误:

  1. 重新运行 --json
  2. 找到实际的动画目标
  3. 拍摄该目标
  4. 快照完整帧
  5. 相信渲染的像素胜于日志

诊断解读

flat 表示没有显式的中间姿态。keyframes 表示存在显式停靠点。motionPath 表示存在路线。trace 表示多笔画绘制。composed with 表示子运动继承父运动。

均匀的幽灵间距表示恒定速度。聚集的幽灵表示缓入或稳定。大间隙表示快速移动。

辅助选择器拍摄不是证明。在破碎的完整帧上的重叠拍摄也不是证明。

错误处理

失败情况修复方法
仅端点添加中间姿态,保持峰值证明,重新运行 --shot
身份断裂保持一个元素存活,使用共享源/最终框,移除替代交叉淡入淡出
伪 3D添加 z 轴/相机移动、遮挡、角度证明
错误最终添加最终保持,快照最终减去保持和精确最终
不可寻址运行时暂停自动播放,注册实例,移除定时器,同步构建
不可读文本保留行框,减少位移,添加最终保持,快照文本帧

完成状态

运行 lint、validate、keyframes、一个集中的 --shot 和快照。确认第一帧、证明姿态、最终减去保持、精确最终、主体拥有的运动,并且没有调试叠加层。

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

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. Also covers Tailwind projects and the STORYBOARD.md / SCRIPT.md plan formats. Read before writing composition HTML.

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

MicroFlow Pro - MFI Staff Portal built with Flutter & Supabase

相关技能