Communitygithub.com

Avinash1286/pendent

所有關於 HyperFrames 動畫的知識——原子運動規則、多階段場景藍圖、場景轉場、廣泛的動態設計技術,以及七種執行時期適配器(預設 GSAP,外加 Lottie、Three.js、Anime.js、CSS 關鍵影格、Web Animations API、TypeGPU)。可用於任何動畫任務:挑選 2-4 條規則組合、載入藍圖,或查詢特定執行時期 API(例如 GSAP 緩動函式 / Lottie 播放器 / Three.js 混合器)。同時涵蓋審視現有合成作品的編舞(動畫對應表)以及 24 種命名文字動畫效果。HyperFrames 原生:單一暫停時間軸、安全搜尋、確定性。

pendent 是什麼?

此技能將所有 HyperFrames 動畫知識集中於一處:原子運動規則(簡潔的 GSAP 配方)、多階段場景藍圖(品牌揭露、社交認同等預製模板)、場景轉場(以 CSS 驅動的剪輯間過渡)、廣泛的動態設計技術,以及七種執行時期適配器的詳細 API。對於任何動畫任務,預設工作流程是從`rules-index.md`中挑選 2-4 條規則並加以組合,這樣比從頭撰寫藍圖更快且程式碼更少。當需要複雜的多階段編排時,則可載入藍圖。其路由表格提供了一個清晰的索引,方便查閱各項資源:例如 GSAP API(時間軸、緩動、變形)、Lottie 播放器、Three.js 動畫混合器、Anime.js 全域變數、CSS 關鍵影格、Web Animations API,以及 TypeGPU/WebGPU 管線。此技能也包含一個動畫對應表指令碼,用於審視合成作品以檢查死區和時間軸問題。它強制執行 HyperFrames Core 的關鍵限制:單一暫停時間軸、由`data-duration`控制長度、禁止使用`Math.random`和`getBoundingClientRect()`,以及僅使用 GSAP 變形別名(`x`、`y`、`scale`、`rotation`)進行空間運動。多種執行時期可在一個合成作品中共存,而 HyperFrames 會在一次傳遞中將它們全部搜尋。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Avinash1286/pendent/tree/HEAD/film/docs

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

HyperFrames 動畫

所有動畫知識濃縮於此技能:規則(原子配方)、藍圖(多階段場景範本)、轉場(場景間過渡)、技術(更廣泛的動態設計模式),以及適配器(各執行時期的 API)。

關於合成合約(data 屬性、子合成、確定性),請參閱 hyperframes-core。

預設:組合原子規則

從 rules-index.md 中挑選 2-4 條規則,使用單一暫停的 GSAP 時間軸將它們黏合在一起,完成。這比從藍圖開始更快,產生的程式碼也更少。

適合載入藍圖的時機

  • 當場景符合現有的預先設計多階段範本(品牌揭露、社會證明等),且重複使用其階段管線能節省實際創作時間
  • 當您想要一個可執行的事實標準程式碼,用於複雜的 4-5 階段編舞

藍圖位於 blueprints-index.md。每個條目指向 blueprints/<id>.md(配方)。請勿預先讀取;在您已決定需要場景層級編排時再載入。

路由

想要…請閱讀
根據觸發條件 / 標籤挑選原子運動模式rules-index.md
讀取某一規則的完整 HTML / CSS / GSAP 配方rules/<name>.md
挑選多階段場景範本blueprints-index.md
讀取某一藍圖的完整配方blueprints/<id>.md
創作場景轉場(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 Animations 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
命名文字動畫效果(24 個 ID,透過外部 animate-text 技能)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 內部建構時間軸)。核心仍允許使用 GSAP autoAlpha 和在明確的時間軸邊界設定零持續時間的可見性。僅對非剪輯元素或剪輯內的包裝器使用這些例外;框架擁有 .clip 的生命週期。請勿在此重述完整合約。

在核心合約基礎上增加的動畫製作規則:

  • 預先計算的佈局常數 — 切勿在補間時間從 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。用於在創作後審視編舞(死區、交錯一致性、生命週期警告)。

animation-map.mjs 會先從當前專案解析輔助套件,然後可以引導捆綁的 HyperFrames 套件版本。僅在技能外部執行(非透過捆綁的 CLI / 技能安裝)且需要明確固定引導版本時,才設定 HYPERFRAMES_SKILL_PKG_VERSION=<version>。

另請參閱

  • hyperframes-core — 合成結構、data 屬性、子合成、確定性渲染合約
  • hyperframes-creative — 色盤、排版、敘事、節拍規劃(非動畫創意指導)
  • hyperframes-cli — npx hyperframes lint / check / snapshot / preview / render

相關技能