插件安裝: 在執行設定或更新命令之前,當此技能位於 HyperFrames 插件內部時,請遵循插件執行規則。獨立安裝則保留下面的更新說明。
HyperFrames 入口點 是做什麼的?
檢查剩餘使用量
在開始創作時,執行 npx hyperframes usage --json。在工作流程的里程碑處再次檢查,例如在草稿完成後、渲染之前,因為使用量在運行期間會發生變化。閱讀可用的時間窗口及其重置時間;之前的讀取並不會保留配額。如果命令失敗、不可用或返回 status: unknown,請報告使用量未知,並且不要猜測。保持範圍和工作流程選擇與使用者溝通。
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,在你回合中的 Project history)括起來。
如果一個新的請求沒有指明主題或輸入,請在路由之前詢問影片的內容。在詢問任何問題之前,先檢查偏好設定和配方(references/intent-interview.md,步驟 1)。一個 figma.com 輸入或命名的配方會改變攝取方式,而不是路由 — 面試的「適應正交輸入」部分處理這兩者。
保持專案的 CLI 為最新
一個已建立基礎的專案會在其 package.json 腳本中固定 hyperframes@<version>,以便渲染保持可重複性;該固定版本永遠不會自行更新,並且執行舊版 CLI 的固定版本時不會列印任何警告。當恢復一個腳本帶有固定版本的專案時,請在第一次影響渲染的命令之前探查一次:
npx hyperframes@latest upgrade --project . --check
該探查是唯讀的,並報告固定版本與最新版本的比較;請保留明確的 . — 在舊版 CLI 上,裸的 --project 後面跟著另一個標誌會將該標誌作為其目錄值。當它報告專案落後時 — 或者任何 CLI 輸出已經顯示(在固定版本腳本的 --json 結果中,stderr 通知 This project pins hyperframes@… (latest …) 或 _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 |
創作者編輯短語是跨領域請求。載入匹配行中命名的每個技能:
| 創作者請求 | 所需領域 |
|---|