Communitygithub.com

octaviosilva2/frontend-video-skill

使用 HyperFrames 產生確定性影片 — 在 Chrome/FFmpeg 中捕獲 HTML/CSS 合成,並聲明格式、幀率、時長與解析度,且需經渲染授權。當交付結果為渲染後的媒體檔案(MP4、WebM、MOV、PNG)時使用,或用於使用者要求的影片片段、匯出動畫或可重現的合成。

frontend-video-skill 是什麼?

這項技能專為需要產生「確定性影片」的情境而設計,其核心是透過 HyperFrames 引擎,將 HTML/CSS 內容在 Chrome 與 FFmpeg 環境中捕獲並渲染成標準媒體檔案(MP4、WebM、MOV、PNG)。它嚴格區分「靜態媒體檔案」與「網頁互動 UI」:若交付結果是互動式網頁或內嵌影片的網站資產,則不屬於此技能的範疇。使用前必須由使用者明確指定格式、解析度、幀率與時長,沒有任何預設值;此外,渲染程序絕非自動化,必須獲得使用者明確授權才能執行。此技能支援 Claude Code、Cursor 等 AI 代理平台,特別適合需要用程式碼產生精確、可重現的動畫或影片合成場景。為確保輸出可完全複製,需鎖定 HyperFrames、Chrome、FFmpeg、字型、素材、編解碼器與環境版本;否則不應承諾位元組級別的可再現性。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add octaviosilva2/frontend-video-skill

在你喜歡的 AI 中提問

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

說明文件

閘門 — 在任何合成之前

觸發條件:交付結果為渲染後的媒體檔案。 MP4、WebM、MOV、PNG。 是交付格式,而非外觀。

在以下情況不啟用此技能:

  • 網站內嵌的影片 — 主視覺、背景、見證影片。這是一般的網頁資產, 與其他圖片或字型相同處理方式(參見 referencias/assets.md)。
  • 看似影片但實際可互動的 UI 元件 — 屬於介面動態或 3D, 非渲染輸出。

區分標準在於交付格式。如果結果可在瀏覽器中開啟並回應點擊, 則不屬於此技能。

格式、解析度、幀率與時長沒有預設值

選擇「1080p 30fps 因為很常見」正是閘門要防止的情況。四個欄位 — 格式、解析度、幀率、時長 — 必須在合成開始前由使用者決定。

營運成本 — 在承諾前先確認

HyperFrames 不是一個匯入工具:它是一個生產流程。依賴 Chrome 與 FFmpeg 已安裝,且捕獲過程可能分散執行。

在承諾使用此路徑之前,請確認基礎設施已就緒。如果渲染時才發現 缺少 FFmpeg,代表整個合成程式碼都已寫完才發現問題。

渲染絕非自動執行

未經使用者明確授權,不得執行任何渲染。 渲染會消耗機器時間, 且在涉及媒體生成時,可能產生實際費用。

當缺少某項素材且替代方案為自行生成時:請列出缺少的項目與要生成的 內容 — 然後在此暫停。

使用方法

frontend-video/
├── SKILL.md                ← 本檔案。唯一總是會被讀取的檔案
└── referencias/
    ├── hyperframes.md      閘門、格式/幀率/時長、確定性時間、
    │                       adapter、字幕、渲染授權
    ├── direcao-visual.md   附有原因說明的 Token,反通用
    ├── assets.md           來源、授權、最佳化 — 此處資產即為交付物
    └── validacao.md        可套用於媒體的閘門
你的任務開啟檔案
決定格式、解析度、幀率、時長hyperframes.md §3
內容、字型、字幕、權利hyperframes.md §4
確定性時間、可重現輸出、場景適配器hyperframes.md §5
可及性與效能hyperframes.md §6
授權渲染hyperframes.md §7
合成美學方向direcao-visual.md
圖片、字型、音軌授權assets.md
完成交付validacao.md

永遠忽略: SEO、可索引的 DOM、導航流程與應用狀態 — 確定性媒體 不包含上述任何一項。瀏覽器作為最終交付環境也不適用:此處瀏覽器 是捕獲工具,而非目的地。

可重現性 — 「確定性」的真正要求

引擎讓合成結果可按時間搜尋。僅此並不能保證輸出完全相同。

要承諾逐位元組可重現的檔案,必須鎖定以下所有項目:HyperFrames、Chrome、 FFmpeg、字型、素材、編解碼器與旗標、解析度、幀率、時長與環境。 沒有上述鎖定條件的同一 commit 不允許做出此承諾。

稽核來源:儲存庫 heygen-com/hyperframes,commit af1cb1c10da33bade100db8233435c7591b7c0bc,該 commit 下主套件 0.8.17, 根目錄與 CLI 皆採用 Apache-2.0 授權。最後驗證時間:2026-08-28。 若版本變更或合成內容依賴未涵蓋於此記錄的能力,則需重新稽核。

永遠適用的原則

  1. 使用真實內容,絕不虛構 — 不可使用看似最終版的佔位符。
  2. 字幕與對比度是交付物的一部分,非額外選項。
  3. 在實際輸出上驗證,而非預覽。 預覽顯示的內容與最終檔案中的內容 在編解碼器、色彩與時間上可能不同。
  4. 場景程式碼仍須自行負責資源清理。 合成中的 Three/WebGL 場景 與其他地方一樣需要正確的拆卸程序。

相關技能