Communitygithub.com

sansayan01/finance_app_zo

HyperFrames 組合合約 — 建立一個可渲染的專案。用於組合結構、`data-*` 時間屬性、`class="clip"`、軌道、子組合、變數、框架擁有的媒體播放、確定性渲染規則與驗證。也涵蓋 Tailwind 專案及 STORYBOARD.md / SCRIPT.md 規劃格式。在撰寫組合 HTML 前請先閱讀。

finance_app_zo 是什麼?

HyperFrames Core 技能是建立 HyperFrames 影片組合的技術合約與建構指南。它定義了如何從一個 HTML 檔案建立可渲染的專案,其中 DOM 元素透過 `data-*` 屬性宣告時間,動畫執行環境可尋址,且媒體播放由框架擁有。此技能詳細說明組合的兩種根形式(獨立與子組合)、非協商性的確定性規則(禁止執行時時鐘、未隨機化的亂數、無限重複等)、軌道與片段管理、變數與媒體播放設定,以及完整的參考文件索引。支援的平台包括任何可使用 HyperFrames CLI 的環境,並特別涵蓋 Tailwind v4 專案與規劃文件格式。透過嚴格的 lint、驗證、預覽與快照指令,確保組合在渲染前符合所有規則,避免難以察覺的佈局錯誤。

相容平台~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-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/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。

根必須設定大小(無聲的佈局錯誤)

獨立根需要一個明確的大小盒子(以 px 為單位的 width/height),並且每個祖先直到 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 通過(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

相關技能