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 / 簡報 / 腳本) | 一般網站 / URL | GitHub 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。
路由程序
- 確定輸入類型 + 目標長度。 路由需要知道影片是關於什麼的——其主題和輸入。如果主題本身未指定(例如,沒有 URL、指定產品、主題或可使用的資產的「製作關於我們東西的影片」),或輸入類型未知,在任何工作流程開始前先詢問——先澄清;不要呼叫工作流程技能然後再問,因為承諾工作流程本身就是路由決策。最多問 2 個澄清問題:
- 「您的輸入是什麼——一個產品(URL 或簡報)、一個一般網站 / URL、一個 GitHub PR / 程式碼變更、一個要解釋的主題或文章,或一個要添加字幕的現有談話式影片?」
- 「目標長度——約 3 分鐘以下,或更長(一個 3-5 分鐘的教學 / 5 分鐘以上的深入探討)?」
- 規格預設值——陳述,不要問(這些不影響路由,因此永遠不要阻塞路由):比例 16:9(引擎也支援 9:16 垂直——僅在使用者指定垂直目的地的如 TikTok / Reels / Shorts 時切換);旁白 / 字幕語言 = 使用者的語言。僅在使用者反對時確認;所選的工作流程會在其步驟 0 中重新確認其自身的具體細節。
- 首先按輸入類型(意圖)選擇;長度僅是上限,而非門檻。
- 簡短、以設計為導向的動態圖形(類型短路,優先於輸入表) —動畫本身就是訊息:動態字體、統計數字/數字倒數、圖表命中、標誌動畫、下方三分之一處 / 疊加層,或動畫推文 / 標題 / 已擷取頁面重點;通常約 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涵蓋其餘部分。
- 簡短、以設計為導向的動態圖形(類型短路,優先於輸入表) —動畫本身就是訊息:動態字體、統計數字/數字倒數、圖表命中、標誌動畫、下方三分之一處 / 疊加層,或動畫推文 / 標題 / 已擷取頁面重點;通常約 10 秒以下,無旁白/語音旁白 →
- 消歧 ≤~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 內部的,永遠不會改變路由。
- 衝突線索 → 提問,不要猜測。 如果提供的來源是產品自身的行銷內容(其登陸頁面、關於_他們的_平台的推廣部落格),但使用者明確要求去除推廣——對底層概念的_中立_解釋,不是廣告——則視為真正模稜兩可(這部影片是…
- 正在行銷、發布或推廣的特定產品 / 公司 / SaaS / 應用程式 / 網站 →
- URL 種類 + 意圖 — URL 不再自動為 PLV 獲勝;其_種類_然後_意圖_決定:一個 GitHub PR 連結(
[已截斷於翻譯]