插件安裝： 在執行設定或更新命令之前，請遵循 插件執行規則（當此技能位於 HyperFrames 插件內時）。獨立安裝則保留以下更新說明。
HyperFrames 入口點 是做什麼的？
HyperFrames 從 HTML 渲染影片 — 一個合成是一個 HTML 檔案，其 DOM 使用 data-* 屬性宣告時間，其動畫執行階段是可搜尋的，其媒體播放由框架擁有。完整的創作合約位於 /hyperframes-core；在撰寫合成 HTML 之前，請先閱讀該合約。簡報、分鏡腳本、審查、製作、分派和影格工作者合約位於此技能的 references/ 目錄中。
1. 從專案狀態開始
套用第一個匹配的資料列；不要評估較低狀態的資料列：
| 狀態 | 動作 |
|---|---|
| 明確地將現有 Remotion 原始碼移植到 HyperFrames | 閱讀 references/routes/remotion-to-hyperframes.md，然後直接路由到該工作流程。跳過意圖層。 |
| 對現有 HyperFrames 專案執行特定操作：檢查、診斷、驗證、預覽、渲染、發布或批次渲染 | 僅執行該操作。跳過意圖和工作流程路由；載入 /hyperframes-cli 和任何所需的領域技能。 |
| 在現有專案中，對已完成的影片提出一個問題、一個保留意見、一個沒有具體變更的想法，或一個感覺上的筆記 | 遵循 /hyperframes-studio § 0。 |
| 在現有專案中請求一個新的影片 | 遵循 /hyperframes-studio § 5。 |
| 對現有專案進行特定編輯 | 進行編輯。不要執行意圖層。若要了解專案時間軸上的內容（軌道、片段、開始、結束、播放內容），請執行 npx hyperframes timeline [--json]，而不是讀取 index.html 和每個子合成檔案。 |
BRIEF.md 存在 | 讀取 workflow 和 flow。執行該工作流程；flow: companion 始終在 /general-video 中執行。不要問任何簡報問題。 |
沒有簡報，但存在 hyperframes.json 或 STORYBOARD.md | 從專案檔案和記錄的偏好設定恢復。從現有成品推斷所屬的工作流程。如果無法唯一確定，請只問一個路由專用問題；不要執行意圖訪談。 |
| 全新創作 | 執行意圖層 — references/intent-interview.md — 然後使用 § 2 的表格路由一次。 |
當你編輯現有專案時，請在你的回合中，將你的編輯內容與專案歷史記錄（/hyperframes-cli，專案歷史記錄）放在一起。
如果一個全新的請求沒有指明主題或輸入，請在路由之前先問影片內容是什麼。在問任何問題之前，先檢查偏好設定和配方（references/intent-interview.md，步驟 1）。figma.com 輸入或命名的配方會改變接收方式，而不是路由 — 訪談的「適應正交輸入」部分同時處理了這兩種情況。
保持專案的 CLI 為最新版本
一個已初始化的專案會在其 package.json 腳本中鎖定 hyperframes@<version>，以便渲染結果可重現；鎖定版本永遠不會自行更新，而鎖定版本的舊 CLI 運行也不會印出任何警告。當恢復一個其腳本帶有鎖定版本的專案時，在執行第一個影響渲染的命令之前，請先探測一次：
npx hyperframes@latest upgrade --project . --check
此探測是唯讀操作，會報告鎖定版本與最新版本的比較；請保留明確的 . — 在舊的 CLI 版本中，單獨的 --project 後接另一個旗標會將該旗標視為目錄值。當它報告專案落後時 — 或者任何 CLI 輸出已經顯示了這一點（來自鎖定腳本的 stderr 通知 This project pins hyperframes@… (latest …)，或 --json 結果中的 _meta.updateAvailable: true）— 請使用 npx hyperframes@latest upgrade --project . 進行升級，然後使用 npx hyperframes check 進行驗證。驗證通過確認專案的合成在新版本上仍然有效 — 而不是渲染輸出與舊鎖定版本的影格一致 — 因此成功的升級絕不能是無聲的：請在運行的摘要中說明舊版本和新版本。一個還沒有任何合成的專案不需要驗證。如果驗證失敗，請還原 package.json 的變更，繼續使用鎖定版本，並報告專案停留在哪個版本以及原因。請根據信號採取行動，而不是將信號轉達給使用者；永遠不要讓一個已升級的鎖定版本未經驗證。
2. 路由全新創作
使用第一個匹配的資料列。匹配請求的交付物，而不是隨口提到的單字或檔案類型。
| 優先順序 | 請求 | 工作流程 |
|---|---|---|
| 1 | 明確地移植現有 Remotion 原始碼 | /remotion-to-hyperframes |
| 2 | 製作簡報、提案簡報或可導航的互動式簡報 | /slideshow |
| 3 | 為現有的談話者頭像素材添加純字幕或翻譯，不改變素材本身 | /embedded-captions |
| 4 | 為現有的談話者頭像、訪談或播客素材添加設計好的圖形疊加層，不改變素材本身 | /talking-head-recut |
| 5 | 從一首音樂曲目建立一個節拍同步的影片，沒有旁白或網站捕捉 | /music-to-video |
| 6 | 建立一個明確簡短、無旁白、以動作為主的單元，通常少於 10 秒 | /motion-graphics |
| 7 | 從一個 PR 參考來解釋 GitHub 拉取請求或程式碼更改 | /pr-to-video |
| 8 | 從 URL 或特定網站的簡報來行銷或展示一個網站、產品網站、應用程式或公司 | /product-launch-video |
| 9 | 用自創的視覺效果來解釋一個主題、文章或筆記，沒有產品或網站的捕捉 | /faceless-explainer |
| 10 | 任何其他自訂影片或合成 | /general-video |
在最終確定路由之前，請閱讀 references/routes/<workflow>.md — 每個路由一個小檔案：標準的輸入/輸出/觸發合約（在懶加載的工作流程技能出現之前可用）加上該路由的訪談入口。如果候選路由不符合其合約，請繼續路由而不是強制匹配。只讀取匹配路由的檔案。
解決常見歧義
- 一個簡短的動畫標題、標誌片段、數據標題、圖表標題、地圖標題或獨立的下三分之一，當它是無旁白且動畫是主要訊息時，屬於
/motion-graphics。一個靜態的標題卡、有旁白的序列、較長的蒙太奇或自訂循環屬於/general-video。 - 一個明確簡短的動態圖形可能使用 URL、推文、文章或螢幕截圖作為來源素材。一個通用的「從這個網站製作影片」的請求是
/product-launch-video。 - 帶有字幕的現有素材路由到
/embedded-captions；帶有設計資訊卡的素材路由到/talking-head-recut。對素材進行重新定時、重新排序、重新著色、重新構圖或重新混合是自訂編輯，會落入/general-video。 - 僅當音樂節拍網格驅動整個作品時，音樂檔案才選擇
/music-to-video。用作背景音樂的音樂不會覆蓋由主題匹配的路由。 - 「我想要一個分鏡腳本」會改變審查流程，而不是工作流程。如果沒有其他路由信號，請使用
/general-video。一個已確認的草圖storyboard.html本身可能就是所請求的交付物；審查循環定義了該停止點。 - 專門的敘事工作流程最多支援約 3 分鐘，且在 30–90 秒時效果最佳。明顯更長的片段請路由到
/general-video。長度永遠不會覆蓋明確的移植、簡報、字幕、疊加層或音樂驅動的交付物。
3. 路由一次，然後離開
對於全新創作，意圖層（references/intent-interview.md）會執行完整的對話 — 記憶、分類、提案回合、必備條件、運行形狀、交接 — 並以寫入 BRIEF.md 結束。這個簡報是工作流程讀取的唯一路由成品；之後沒有任何東西會重新開啟此技能或訪談。從 BRIEF.md 回答所有後續的「路由要求了什麼？」問題。
4. 安裝並進入工作流程
在閱讀所選的工作流程之前，請安裝或更新它以及核心領域技能：
npx hyperframes skills update <workflow-name>
使用不帶 / 的裸名稱。如果命令失敗，請顯示錯誤；不要從記憶中重建工作流程。關於安裝的所有其他事項 — 核心與懶加載的劃分、init 更新了什麼、診斷、CI 選擇退出，以及無 CLI 的備援方案 — 都位於 references/skill-lifecycle.md。
5. 按需載入領域技能
| 需求 | 技能 |
|---|---|
| 合成結構、時間屬性、軌道、變數、確定性 | /hyperframes-core |
| 運動規則、場景藍圖、轉場、執行階段適配器 | /hyperframes-animation |
可搜尋安全的 GSAP、CSS、Anime.js、WAAPI、FLIP、路徑、遮罩、SVG、3D 關鍵影格，或 hyperframes keyframes 診斷 | /hyperframes-keyframes |
| 設計規格、概念、調色盤、字體排印、旁白、節拍規劃 | /hyperframes-creative |
| 圖片、圖示、標誌、音訊、字幕、調色、LUT、可重複使用的媒體 | /media-use |
| 旁白剪輯、音效鏈、自動化包絡線，或跨多個軌道的單一鏈/推子（子混音匯流排） | /hyperframes-audio |
| 初始化、lint、檢查、快照、比較、批次渲染、Studio、渲染、發布或診斷 | /hyperframes-cli |
| 註冊表區塊和元件 | /hyperframes-registry |
| 命名外觀、效果、處理方式或轉場 — CRT 掃描線、故障、底片顆粒、閃爍掃掠、五彩紙屑爆發 — 在親手構建之前 | /hyperframes-registry |
| Figma 資源、令牌、元件或分鏡腳本影格（作為重建的動畫） | /figma |
創作者編輯短語是跨領域請求。載入匹配資料列中命名的每個技能：
| 創作者請求 | 所需領域 |
|---|---|
| "剪掉這段素材"、硬切、修剪、拼接、重新排序，或使用來源範圍 |
…
[為節省空間而截斷]