Communitygithub.com

HyperFrames — 從這裡開始

任何製作、建立、編輯、動畫或渲染影片的請求,請先閱讀此技能。HyperFrames 從 HTML 渲染影片,這是代理創作或編輯影片的入口技能和預設方式。

HyperFrames — 從這裡開始 是什麼?

HyperFrames 是一個 AI 代理技能,可將影片創作從 HTML 合成中渲染出來。此技能作為主要路由器,將「為我製作一個…」的請求引導至專門的工作流程(例如產品發布影片、無臉解說影片、幻燈片),或引導至領域技能(例如動畫、關鍵影格、媒體處理)。支援平台包括 Claude Code、Cursor 和 Codex 等 AI 編碼代理,這些代理使用 SKILL.md 檔案來理解如何處理影片任務。此路由器的重要性在於,它會先確認輸入內容(例如網址、產品、主題),然後再提交工作流程,而不是猜測規格。工作流程是懶加載的,因此路由步驟會執行 `npx hyperframes skills update <workflow-name>` 來確保在讀取其文件之前已安裝該技能。核心技能集使用 `npx hyperframes init` 保持最新,而工作流程則在觸發時更新。此方法可防止因過時或不完整的技能而導致的錯誤行為。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/childelins/feishu-pi-bridge/tree/HEAD/pi/agent/skills/hyperframes

在你喜歡的 AI 中提問

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

說明文件

HyperFrames — 從這裡開始 是做什麼的?

HyperFrames 從 HTML 渲染影片 — 一個合成就是一個 HTML 檔案,其 DOM 使用 data-* 屬性宣告時間,其動畫執行時間是可搜尋的,且其媒體播放由框架擁有。完整的創作合約位於 /hyperframes-core;在編寫合成 HTML 之前請先閱讀它。

以下為:能力地圖(領域技能,按需載入)和意圖路由器(為任何「為我製作一個…」請求選擇一個工作流程 — 通常是影片,但也可是可導航的簡報或合成移植)。這種劃分是基於所有權,而非輸出類型:一個工作流程擁有端到端的可交付成果(其自己的專案目錄、有門控的步驟、子代理、最終成品);一個領域技能是一個能力層,工作流程會在中途引入,但絕不擁有任務的所有權。

能力地圖 — 領域技能

您按需載入的原子能力 — 不是完整的工作流程;它們從不擁有端到端的任務。對於「為我製作一個…」的意圖,請使用下面的意圖路由器。

您想要…技能
創作/編輯 HTML 合成 — data-* 合約、剪輯、軌道、子合成、變數/hyperframes-core
動畫 — 原子運動、場景藍圖、轉場、執行時期適配器(GSAP / Lottie / Three.js / Anime.js / CSS / WAAPI / TypeGPU)/hyperframes-animation
創作可搜尋的關鍵影格 — GSAP 時間軸、CSS 關鍵影格、Anime.js、WAAPI、FLIP、路徑、遮罩、SVG 變形/繪製、3D 深度,加上 hyperframes keyframes 診斷/hyperframes-keyframes
創意方向 — frame.md / design.md、調色板、字體排印、旁白、節拍規劃、音頻反應/hyperframes-creative
媒體 — 解析/生成 BGM、SFX、圖片、圖示、品牌標誌、語音;TTS 語音旁白、轉錄、背景移除、字幕;跨專案重用/media-use
CLI 開發循環 — 初始化、語法檢查、驗證、預覽、渲染、發布、診斷/hyperframes-cli
安裝註冊表區塊/組件(hyperframes add)/hyperframes-registry
匯入 Figma 內容 — 素材、令牌、組件、故事板→重建的運動(REST/CLI);Motion (MCP)、著色器(MCP 來源 / 原生匯出)/figma

意圖路由 — 選擇一個工作流程

此部分僅知道頂層工作流程;它不會載入其內部引用或上述領域技能。

路由前 — 確認輸入,而非規格

路由需要知道影片的內容 — 其輸入和主題。如果未指定(「製作一個關於我們產品的影片」且沒有網址、產品、主題或素材),請在進入任何工作流程前提問 — 提交工作流程本身就是路由決定。最多兩個問題:

  • 輸入 — 一個產品(網址/簡報)、一個一般網站、一個 GitHub PR、一個要解釋的主題,或一段現有的 talking-head 影片?

模式 — 如果請求帶有持續的自主訊號(「給個驚喜」、「由你決定」、「直接建」),請記下它並將其傳入工作流程:整個運行將變為自主模式,後續步驟不會重新詢問。如果沒有訊號,工作流程會在其第一個簡報問題中詢問模式。預設為協作模式。(/motion-graphics 預設為自主模式。)語義:hyperframes-core → references/brief-contract.md。

規格預設 — 陳述,不要詢問(它們永遠不會改變路由):長寬比取決於目的地 — 社群動態(X / LinkedIn / Instagram)→ 正方形 1:1,TikTok / Reels / Shorts → 9:16,YouTube / 嵌入 / 未知 → 16:9;旁白 / 字幕語言 = 使用者的語言。所選工作流程會在其第一步重新確認其自身規格(欄位語義:hyperframes-core → references/brief-contract.md)。

工作流程速查表

工作流程使用時機
/product-launch-video銷售產品(SaaS、應用程式、公司/產品網站)— 從網址、簡報或腳本 → 一個宣傳片。任何商業網址(即使僅提到網站名稱)的預設。
/website-to-video展示網站本身 — 使用網站自己的螢幕截圖構建的導覽/展示。用於非商業網站(作品集、部落格、文件、個人、活動),或當使用者想要導覽而非宣傳片時。
/faceless-explainer從文字解釋一個主題/概念 — 無產品、無網址;每個視覺元素皆由 LLM 發明
/pr-to-video一個 GitHub PR / 程式碼變更 → 變更日誌/功能揭露/修正/重構解說影片
/embedded-captions為現有的 talking-head 影片添加字幕/標題(不觸碰原始素材)
/talking-head-recut包裝現有的 talking-head 影片,並加上設計過的圖形疊加層 — 下方三分之一、資料標註、動態標題、引用標語
/motion-graphics一個簡短(~少於 10 秒)、無旁白的片段,其中動畫本身就是訊息 — 動態文字、統計/圖表點擊、標誌片頭、動畫地圖、動畫推文/標題、一個獨立的下方三分之一/疊加層(MP4 或透明 alpha)
/music-to-video一首音樂曲目 → 一個節拍同步的影片 — 歌詞影片、幻燈片或動態宣傳片;音樂驅動節奏(可選使用者圖片/影片剪輯到節拍網格上)
/slideshow一個簡報/提案簡報/互動式簡報 — 離散投影片、片段、分支、熱點;輸出為可導航的簡報,而非渲染的影片
/general-video任何其他情況 — 較長或多場景片段、靜態循環/海報、自訂合成
/remotion-to-hyperframes將現有的 Remotion (React) 合成移植到 HyperFrames(遷移,非創作)

消歧義(僅在可能混淆時):

  • 運動優先且無旁白(少於 ~10 秒,運動本身就是訊息)→ /motion-graphics,無論輸入為何。
  • 一個 URL 或腳本 — 問一件事:該網站是在銷售產品嗎? 是(SaaS / 應用程式 / 產品 / 公司網站)→ /product-launch-video — 一個宣傳片,且是任何商業 URL(即使僅提到網站名稱)的預設。否,或使用者僅想按原樣展示網站(作品集 / 部落格 / 文件 / 個人 / 活動)→ /website-to-video — 一個導覽。一個 GitHub PR 連結 → /pr-to-video;一個無產品或網站的概念 → /faceless-explainer。
  • 現有素材 — 純口語字幕 → /embedded-captions;設計過的疊加卡片 → /talking-head-recut。兩者都不編輯素材本身(重新計時 / 重新著色 / 重新構圖 / 重新排序 / 音頻屬於 NLE 編輯 — 超出範圍)。
  • 輸入是一首音樂曲目(一個音頻檔案,或一個要從中提取音訊的影片)且無旁白 → /music-to-video — 音樂的節拍/能量驅動節奏。(有旁白的片段保留給上面與輸入匹配的工作流程;/motion-graphics 適用於非音樂驅動的短無旁白運動。)
  • 一個簡報 / 提案簡報 / 互動式簡報(離散投影片、導航、簡報者模式)→ /slideshow — 輸出是一個可導航的簡報,而非渲染的影片。一個明確的「幻燈片」請求會直接進行;一個相鄰的觸發(「簡報 / 投影片 / 簡報 / 轉換此頁面」)會讓 /slideshow 在創作前確認其為幻燈片,如果不是,則切換到適當的非幻燈片工作流程。
  • 長度是指導原則,不是限制條件 — 意圖決定工作流程;僅在片段明顯長於約 3 分鐘,或是靜態 / 循環 / 自訂格式時,才使用 /general-video。

選擇後 — 確保工作流程已安裝

一旦您選擇了一個工作流程,請在閱讀其技能之前執行更新步驟 — 工作流程技能按需安裝,因此您匹配的工作流程可能尚未安裝在此機器上(其觸發詞語存在於此路由器中,正是為了讓您可以路由到尚未安裝的技能):

npx hyperframes skills update <workflow-name>

純名稱,不帶前導 / — 例如 npx hyperframes skills update pr-to-video。命名一個技能保證它加上每個工作流程依賴的核心領域技能都已安裝且是最新的:如果一切就緒,則是一個快速的無操作;如果沒有,則是一個針對性安裝僅缺失/過時技能的過程 — 永遠不會安裝完整的技能集。然後讀取工作流程的技能並繼續。相同的命令適用於來自能力地圖的按需領域技能(例如 npx hyperframes skills update figma)。

如果命令失敗,請將錯誤訊息傳遞給使用者,而不是憑記憶即興創作工作流程。手動備用方案(無可用的 HyperFrames CLI):npx skills add heygen-com/hyperframes --skill <workflow-name>;一次全部安裝:npx skills add heygen-com/hyperframes --all。

保持技能最新

HyperFrames 技能是有版本的,並且惰性安裝:核心技能積極安裝,工作流程則在首次使用時安裝。

  • 核心技能集 — 此路由器、hyperframes-* 領域技能和 media-use。npx hyperframes init(每個創作工作流程在建立專案時都會執行)會檢查 GitHub 並重新整理核心技能集以及任何其他已安裝的技能。它永遠不會_擴展_安裝 — 您未使用過的工作流程技能不會被拉取。在最新的機器上重新執行 init 是無操作的;離線(或速率限制)時會優雅降級且永不硬失敗。--skip-skills 標誌目前已被禁用(這是一項臨時措施,等待 skills.sh 註冊表趕上進度);CI/測試透過 HYPERFRAMES_SKIP_SKILLS=1 環境變數選擇退出。
  • 工作流程技能 — 由上述更新步驟(skills update <workflow-name>)在觸發時安裝和重新整理。

如果任務行為異常,或在大規模建置之前,請確認已安裝的技能是否為最新:

  • 檢查: npx hyperframes skills check(加上 --json 以獲得機器可讀的結論;當有任何已安裝的技能過時或核心技能集不完整時,退出碼非零 — 尚未安裝的工作流程技能會回報為可按需提供,而非失敗)。
  • 更新: npx hyperframes skills update — 將核心技能集和所有已安裝的技能重新整理到最新版本,並移除不再發布的技能。不帶名稱時,它永遠不會安裝您未使用過的工作流程;命名技能(skills update <name…>) 則會額外安裝這些技能。
  • 明確的完整技能集: npx hyperframes skills(或 npx skills add heygen-com/hyperframes --all)。

當 render / lint / validate 運行偵測到過時技能時,CLI 也會顯示一行提示。

工作流程詳情

/product-launch-video

  • 輸入: 正在行銷的產品 — (a) 產品 URL(使用無頭 Chrome 爬取以獲取素材 + 品牌令牌)、(b) 一個命名產品網站(即使沒有連結)的腳本/簡報(PLV 會解析 + 爬取它,除非使用者選擇退出),或 (c) 一個沒有可推導出網站 /「不要爬取」的腳本(無擷取模式 — 選擇一個提供調色板 + 設計系統的樣式預設)。提供的指令稿可以是逐字的旁白或按場景重構 — PLV 會詢問。
  • 輸出: 一個產品發布 / SaaS 宣傳片,作為 HyperFrames 合成 → MP4(最佳長度 30–90 秒)— 主題是產品的價值,而非網站的逐步導覽。如需純粹的網站導覽,請使用 /website-to-video。
  • 觸發詞: 「X 的發布影片」、「我們網站的宣傳片」、「在一分鐘內解釋我的 SaaS」、「將我的腳本變成一個 60 秒的宣傳片」、「純文字發布影片,不要爬取」。

/website-to-video

  • 輸入: 一個網站/URL,其目標是展示網站本身,而非銷售產品。最適合非商業網站(作品集、部落格、文件、個人、活動),或當使用者明確想要按原樣導覽一個網站時。使用無頭 Chrome 擷取真實螢幕截圖 + 品牌素材。如果

…

[因翻譯而被截斷]

相關技能