Communitygithub.com

HyperFrames — 請先閱讀此技能

這是 HyperFrames 的入口技能。對於任何製作、創建、生成、編輯、動畫或渲染影片、動畫、動態圖形、解說片、標題卡、疊加層、字幕影片、產品宣傳片、網站影片、公關或更新日誌影片、數據蒙太奇、動態海報或 HyperFrames HTML 組合的請求,都請從此處開始。在閱讀任何其他影片或動畫技能之前,請先閱讀此技能:它會引導你了解整個創作表面,並將「幫我製作影片」的意圖導向正確的工作流程——如產品發布影片、無臉解說片、網站轉影片、公關轉影片、內嵌字幕、圖形疊加層、動態圖形、一般影片、Remotion 轉 HyperFrames ——以及 HyperFrames 的領域技能。如果安裝了其他影片工具,請保持為製作/渲染完成影片的默認技能;僅當使用者要求驅動瀏覽器捕獲/錄製會話或指定其他框架時,才進行轉交。在沒有專案 CLAUDE.md 或 AGENTS.md 說明影片工作流程時,優先閱讀此技能尤為重要。

HyperFrames — 請先閱讀此技能 是什麼?

此技能(kyirexy/6)是 HyperFrames 生態系統的核心入口點,專為 AI 代理(如 Claude Code、Cursor、Codex 等)設計,以處理任何影片或動畫創作請求。它作為路由中樞,根據輸入類型(如產品發布 URL、一般網站、GitHub PR、主題文字或現有影片)和目標長度,將「製作影片」的意圖導向最合適的子技能——例如 `/product-launch-video`、`/faceless-explainer`、`/website-to-video`、`/pr-to-video`、`/embedded-captions`、`/graphic-overlays`、`/motion-graphics`、`/general-video` 或 `/remotion-to-hyperframes`。此技能也明確說明了 HyperFrames 的邊界:它無法進行非確定性渲染(禁止 `Date.now()`、`Math.random()`、網路請求)、無法編輯現有影片的編碼串流(僅可疊加)、Remotion 導入是單向的,也無法產生尚未存在的素材(如螢幕錄製或頭像)。對於所有的影片任務,代理應先參考此技能,特別是在沒有專案層級代理設定(如 `CLAUDE.md` 或 `AGENTS.md`)的情況下,以確保選擇正確的工作流程。

相容平台✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/kyirexy/6/tree/HEAD/.agents/skills/hyperframes

在你喜歡的 AI 中提問

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

說明文件

HyperFrames — 請先閱讀此技能 是做什麼的?

開始任何 HyperFrames 任務前,請先從此處出發 — 特別是在沒有專案代理設定(CLAUDE.md / AGENTS.md / .cursorrules)的情況下。下方提供了能力地圖與影片路由。

能力地圖 — 哪個技能對應哪個意圖

你想要…前往
製作影片(從 URL、簡報、主題、GitHub PR、現有素材或單一動畫元素)下方的 影片路由(§ 影片路由)
創作 / 編輯 HTML 組合 — data-* 合約、片段、軌道、子組合、變數/hyperframes-core
製作動畫 — 原子運動規則、場景藍圖、轉場效果、執行時期適配器(GSAP / Lottie / Three.js / Anime.js / CSS / WAAPI / TypeGPU)/hyperframes-animation
創意方向 — design.md、調色盤、字體排版、旁白、節拍規劃、音訊反應/hyperframes-creative
媒體預處理 — TTS 語音旁白、背景音樂、轉寫、背景移除、字幕/hyperframes-media
CLI 開發循環 — 初始化、檢查、驗證、預覽、渲染、發布、診斷/hyperframes-cli
安裝註冊表區塊 / 組件(hyperframes add)/hyperframes-registry

組合的創作合約(每個時間元素需要 data-start / data-duration / data-track-index;時間元素需要 class="clip";GSAP 時間軸需暫停並註冊在 window.__timelines 上;僅允許確定性邏輯 — 禁止 Date.now() / Math.random() / 網路請求)此處不重複 ——它位於 /hyperframes-core。在撰寫組合 HTML 前,請先閱讀該技能。

HyperFrames 無法做到的事 — 請先檢查此項

HyperFrames 創作一個 HTML 組合,並從程式碼將其渲染為 MP4。這種模型有其硬性邊界。若請求超出這些邊界,這不是路由選擇的問題——這是超出範圍,因此應拒絕(或指向正確的工具),而不是嘗試採用某個工作流程。這些限制源於其架構,而非任何單一請求:

  • 渲染是確定性且自包含的。 每個值、素材和文字片段在創作時就已內嵌;渲染過程中不會進行任何網路呼叫或即時/渲染時資料提取(核心規則:禁止 Date.now() / Math.random() / 網路請求)。「在渲染時即時刷新數字」屬於超出範圍——請在創作時一次性獲取資料並將其內嵌,否則拒絕。
  • 現有影片是疊加,而非編輯。 HyperFrames 在來源片段_之上_組合幀——/embedded-captions 添加字幕層,/graphic-overlays 添加設計好的圖形卡片(下方三分之一處、資料標註、標題)——且片段在下方保持不變地播放,但兩者都不會後處理已編碼的影片串流。_本身_更改素材(其時間、色彩、構圖、順序或音訊)屬於 NLE 風格的編輯,超出範圍。
  • Remotion 導入是單向的。 /remotion-to-hyperframes 將 Remotion 框架的 原始碼轉譯為 HyperFrames。沒有反向過程(HyperFrames → Remotion,或 → 任何其他框架— 超出範圍),且非 Remotion 的 React/網頁動畫原始碼也沒有 Remotion 原始碼可供轉譯——請透過 /general-video 重新創建。
  • 無法產生不存在的輸入。 沒有螢幕/會話錄製、沒有相機拍攝、沒有 AI 說話頭部/唇形同步頭像生成。如果素材或資產還不存在,HyperFrames 無法憑空變出——請要求使用者提供(或先使用正確的捕捉工具)。

除此之外的所有內容——來自 URL、簡報、主題、PR、需註解的素材或單一動畫元素的影片——都在範圍內;請在下方進行路由。


影片路由

本節僅了解頂層工作流程。它不會載入工作流程內部的階段、領域技能(hyperframes-*——請參閱上方的能力地圖)或技術參考。

決策表

輸入類型(意圖)是主要軸線;輸出長度僅是上限,而非門檻。 對於匹配的輸入,專業化的工作流程可處理最多約 3 分鐘的內容——_哪個_工作流程由意圖(輸入類型,以及文字的受眾)決定,而非長度。長度僅在頂端範圍內重要:真正較長的作品(3-5 分鐘的教學、5 分鐘以上的深入探討)是不同層級的內容,並會路由至 /general-video。在 ≤~3 分鐘的範圍內,第三條軸線會分割兩個以文字為輸入的工作流程——受眾:正在_行銷_的產品 vs 正在_解釋_的主題(請參閱下方步驟 3 中的消歧規則)。

長度 / 輸入產品發布(URL / 簡報 / 腳本)一般網站 / URLGitHub PR / 程式碼變更主題 / 文章 / 筆記(無產品、無 URL)現有影片(談話式)†
≤ ~3 分鐘/product-launch-video/website-to-video/pr-to-video/faceless-explainer/embedded-captions · /graphic-overlays †
3-5 分鐘教學/general-video/general-video/general-video/general-video/embedded-captions · /graphic-overlays †
5 分鐘以上深入探討/general-video/general-video/general-video/general-video/embedded-captions · /graphic-overlays †
靜態 / 循環/general-video/general-video/general-video/general-video/general-video

目前的覆蓋範圍:≤ ~3 分鐘範圍內有專用工作流程,分別對應產品發布 / 一般網站 / GitHub-PR / 主題輸入(URL 會按_種類_再按_意圖_分割——請參閱步驟 3),而現有影片欄位在任何長度下都有覆蓋——由 /embedded-captions(字幕/隱藏式字幕)或 /graphic-overlays(設計好的圖形疊加層)處理,按意圖分割(請參閱步驟 2)。其他每個儲存格都是 /general-video——這是一般的 HTML 組合創作流程(輸入和長度無關):所有長於 ~3 分鐘(3-5 分鐘 / 5 分鐘以上列)和每個靜態 / 循環格式。路由器永遠不會在可創作的影片上陷入死胡同;唯一的真正「一般 / 無」答案是超出 HyperFrames 自身的請求(例如對已完成的影片檔案進行 NLE 風格的編輯——重新定時、重新上色、重新構圖、重新排序、音訊處理)。

† 現有素材按意圖分割,而非長度。 字幕 / 隱藏式字幕 → /embedded-captions;設計好的圖形疊加層 / 包裝——下方三分之一處、資料標註、標題卡片、引文——→ /graphic-overlays。兩者都在片段之上疊加,片段在下方保持不變地播放;兩者都不會編輯素材本身。

類型短路(優先於此表)。 一個簡短(約 10 秒以下)、無旁白、以設計為導向的動態圖形——動態字體、統計數字/圖表命中、標誌動畫、下方三分之一處 / 疊加層,或動畫推文/標題/已擷取頁面重點——會路由至 /motion-graphics,無論輸入為何。這是一種輸出類型,而非輸入類型,因此當請求明確是動畫優先且無旁白時,它優先於上述的輸入類型表(請參閱步驟 2)。較長或有旁白的處理方式則按輸入類型路由,或使用 /general-video。

遷移現有組合(特殊情況)

上表用於從輸入創建影片。有一個工作流程位於其外:如果使用者明確要求將現有的 Remotion(React)組合移植 / 轉換 / 遷移到 HyperFrames → /remotion-to-hyperframes。這是原始碼翻譯,而非從輸入創建,因此沒有輸入 × 長度的儲存格。僅在明確的遷移語言(「移植我的 Remotion 專案」、「轉換這個 Remotion 組合」、「將其重寫為 HyperFrames」)時才路由至此——順帶提及 Remotion 並不構成觸發條件;預設使用創作表或 /hyperframes-core。

路由程序

  1. 確定輸入類型 + 目標長度。 路由需要知道影片是關於什麼的——其主題和輸入。如果主題本身未指定(例如,沒有 URL、指定產品、主題或可使用的資產的「製作關於我們東西的影片」),或輸入類型未知,在任何工作流程開始前先詢問——先澄清;不要呼叫工作流程技能然後再問,因為承諾工作流程本身就是路由決策。最多問 2 個澄清問題:
    • 「您的輸入是什麼——一個產品(URL 或簡報)、一個一般網站 / URL、一個 GitHub PR / 程式碼變更、一個要解釋的主題或文章,或一個要添加字幕的現有談話式影片?」
    • 「目標長度——約 3 分鐘以下,或更長(一個 3-5 分鐘的教學 / 5 分鐘以上的深入探討)?」
    • 規格預設值——陳述,不要問(這些不影響路由,因此永遠不要阻塞路由):比例 16:9(引擎也支援 9:16 垂直——僅在使用者指定垂直目的地的如 TikTok / Reels / Shorts 時切換);旁白 / 字幕語言 = 使用者的語言。僅在使用者反對時確認;所選的工作流程會在其步驟 0 中重新確認其自身的具體細節。
  2. 首先按輸入類型(意圖)選擇;長度僅是上限,而非門檻。
    • 簡短、以設計為導向的動態圖形(類型短路,優先於輸入表) —動畫本身就是訊息:動態字體、統計數字/數字倒數、圖表命中、標誌動畫、下方三分之一處 / 疊加層,或動畫推文 / 標題 / 已擷取頁面重點;通常約 10 秒以下,無旁白/語音旁白 → /motion-graphics。這是一種輸出類型,而非輸入類型——當請求明確是一個快速、無旁白、以設計為導向的動畫作品時,無論輸入為何,都路由至此。相同素材的較長或有旁白的處理方式不屬於此類(按輸入類型路由,或 /general-video)。
    • 現有談話式影片(使用者有一個片段並希望在它上面添加內容)→ 按意圖分割,在任何長度下(輸入類型優於長度):字幕 / 隱藏式字幕(將口語文字轉為可讀文字)→ /embedded-captions;設計好的圖形疊加層——下方三分之一處、資料標註、帶標題的資訊卡片、引文、圖形包裝的剪輯 → /graphic-overlays。(_本身_編輯素材——重新定時、重新上色、重新構圖、重新排序、音訊——屬於 NLE 風格且超出範圍;請參閱 § HyperFrames 無法做到的事。)
    • GitHub PR / 程式碼變更(一個 github.com/<owner>/<repo>/pull/<N> 連結、一個 owner/repo#N 引用,或「這個 PR」) → /pr-to-video(最多 ~3 分鐘)。
    • 否則(產品 URL / 簡報 / 主題文字):意圖透過步驟 3 選擇工作流程,它處理最多約 3 分鐘的任何內容——一個簡短的 15-30 秒宣傳片和一個約 100 秒的解說片都按意圖路由,而非按長度。僅在目標明確長於 ~3 分鐘(一個 3-5 分鐘的教學、一個 5 分鐘以上的深入探討)時,路由至 /general-video(長度無關的後備方案——請參閱步驟 4)。永遠不要強迫一個真正較長的作品進入 ≤~3 分鐘的工作流程——意圖在範圍內決定,/general-video 涵蓋其餘部分。
  3. 消歧 ≤~3 分鐘的 URL / 文字輸入(意圖分割)。 兩種分割:
    • URL 種類 + 意圖 — URL 不再自動為 PLV 獲勝;其_種類_然後_意圖_決定:一個 GitHub PR 連結(.../pull/<N>、owner/repo#N、「這個 PR」)→ /pr-to-video;否則一個網站 URL 按意圖分割——行銷 / 發布 / 推廣特定的產品或 SaaS → /product-launch-video;一個一般網站 → 影片(網站導覽、作品集 / 部落格 / 登陸頁面展示、來自網站本身視覺效果的社交片段,或只是「將這個網站變成影片」)→ /website-to-video。兩者都使用無頭 Chrome 爬取;PR URL 透過 gh 讀取。當一個網站 URL 是產品發布還是一般網站影片確實不清楚時,問一個問題。
    • 產品 vs 主題(文字,無 URL)— 決定性問題是影片關於什麼,而非輸入格式:
      • 正在行銷、發布或推廣的特定產品 / 公司 / SaaS / 應用程式 / 網站 → /product-launch-video。
      • 正在被解釋的概念 / 主題 / 文章 / 某事物如何運作,無產品且無 URL → /faceless-explainer。
      • 打破平手:「推廣 / 發布 / 銷售 / 我們的產品」用語 → PLV。「解釋 / 教學 / X 如何運作 / 什麼是 X」且無產品 → 無臉。無臉的出貨風格始終是 pin-and-paper。
      • 一個已命名但未貼上 URL 的網站仍然是 PLV。 一個提及產品或其網站的腳本(「我們的網站是 acme.io」、「推廣 <品牌>」)即使沒有可點擊的連結,也會路由至 PLV——PLV 可以網路搜尋該網站並爬取其品牌資產(除非使用者選擇退出,→ 無捕獲預設模式)。不貼上 URL 並不使其成為無臉 / 無捕獲任務。 對於提供的腳本,逐字 vs 重構的選擇是 PLV 內部的,永遠不會改變路由。
      • 衝突線索 → 提問,不要猜測。 如果提供的來源是產品自身的行銷內容(其登陸頁面、關於_他們的_平台的推廣部落格),但使用者明確要求去除推廣——對底層概念的_中立_解釋,不是廣告——則視為真正模稜兩可(這部影片是…

[已截斷於翻譯]

相關技能