Plugin 安裝： 在執行設定或更新命令之前，當此技能位於 HyperFrames plugin 內部時，請遵循 plugin 執行規則。獨立安裝則保留下方更新說明。
一般影片
在開始時執行 npx hyperframes usage --json，除非工作流程剛讀取過，然後在重要里程碑（例如草稿完成後和渲染前）再次檢查。讀取可用的執行次數和重設時間。如果使用情況未知，請告知而不猜測配額；將範圍和工作流程選擇留給使用者。
在依賴此工作流程之前，請執行：
npx hyperframes skills update general-video
成功的無操作表示技能是最新的。如果更新失敗，請顯示失敗訊息，而不是依賴記憶。
1. 套用跨領域來源轉接器
- 媒體： 對於任何音訊、圖片、圖示、標誌、配音、色調、LUT、效果、字幕或媒體操作需求，請載入
/media-use並遵循../media-use/references/resolve.md（解析、採用、重複使用）和../media-use/references/setup-providers.md（提供商、驗證）。模糊的素材回饋和已命名的樣式在編輯前應使用../media-use/references/media-treatments.md；不要使用 CSS/SVG/透明度即興創作支援的媒體效果。在首次經過驗證的提供商操作之前，請執行npx hyperframes auth status並逐字轉述其輸出。如果已登出，請套用../hyperframes/references/brief-contract.md中的閘道：協作模式等待登入或明確的離線選擇；自主模式則說明狀態並透過可用的離線提供商繼續。當沒有離線提供商能滿足必要功能時，顯示阻礙訊息。僅本地採用不需要驗證閘道。 - Figma： 如果任何輸入是
figma.comURL，請先執行/figma。從其匯出的資源、代碼、元件或分鏡畫格建置。不要使用原始的 Figma 連接器呼叫，因為它們會跳過 SVG 清理、媒體來源和品牌代碼綁定。
這些轉接器不會改變 /hyperframes 選定的工作流程。
2. 從專案狀態開始
套用第一個符合的列；不要評估較低狀態列：
| 狀態 | 動作 |
|---|---|
| 特定編輯 | 進行編輯，保留現有專案決定，然後重新執行受影響的檢查。不要重新開啟探索階段。 |
BRIEF.md 存在 | 讀取它。如果 workflow 指定了另一個工作流程且 flow 不是 companion，則交接。不要詢問簡報問題。 |
無簡報，但存在 hyperframes.json 或 STORYBOARD.md | 從檔案和記錄的偏好設定恢復。僅根據已知事實回填 BRIEF.md。 |
| 全新創作 | 執行 /hyperframes 及其意圖層。僅在 workflow: general-video 或 flow: companion 時返回此處。 |
對於新專案，從簡報中選擇一個 kebab-case 目錄名稱，並在編寫簡報前建立脚手架：
npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=general-video
然後使用 ../hyperframes/references/brief-format.md 在專案根目錄編寫 BRIEF.md。在現有專案中，根目錄是包含 hyperframes.json 的目錄。僅記錄簡報格式指定的、經確認的偏好支援欄位，使用 node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes <PROJECT_ROOT>；切勿記錄推斷的預設值。此處 <MEDIA_DIR> 是已安裝的 /media-use 技能目錄，<PROJECT_ROOT> 是包含 hyperframes.json 的目錄。如果意圖層採用了配方，立即使用 node <MEDIA_DIR>/scripts/recipe.mjs use --hyperframes <PROJECT_ROOT> --name <name> 套用，且不要再次詢問。
3. 解讀執行形狀
僅使用來自 ../hyperframes/references/brief-contract.md 的標準術語：
| 欄位 | 意義 | 效果 |
|---|---|---|
flow | 誰主導 | automation：選擇並執行路線。companion：在對話中共同創作。 |
storyboard | 在建立前進行規劃、草稿和審查 | yes：執行規劃和草稿審查（storyboard.html）。no：直接建立，不經過此步驟。 |
衍生 mode | 檢查點閘道的行為方式 | 遵循簡報合約。切勿要求使用者命名模式。 |
不要為這些狀態發明同義詞。持續的「直接建立」信號由意圖層處理，並以 flow: automation、storyboard: no 的形式到達。
- 對於
flow: automation，選擇路線並在第一個進度更新中用一行說明。 - 對於特定編輯，進行編輯，不要發明新的路線。
對於現有素材的硬切、修剪、拼接或重新排序，將同一個影片來源複製到多個剪輯元素中。在每個副本上，使用 data-media-start 和 data-duration 設定來源範圍，然後使用 data-start 設定創作放置/順序。每個影片片段保留其聲音：聲音保留在剪輯上（data-has-audio="true"），因此剪輯影片的同時也會剪掉其聲音。/hyperframes-core 負責此時間編輯；/hyperframes-keyframes 僅用於視覺屬性動畫，例如在內部包裝器上的縮放、打孔、平移、裁切、遮罩或 clip-path。從 ../hyperframes-core/references/creator-editing-recipes.md 複製完整合約。
協作流程
當 flow: companion 時：
- 讀取
BRIEF.md並將已接受的## Assets和## Customizations與專案成品進行比對。完成仍待處理的已接受工作；保留已完成的工作；不要再次提供已接受的功能，好像它是新的一樣。 - 以導演而非承包商的角色到來。 選擇協作的使用者選擇了參與和品質；誠實的回應是你能設計的最佳版本，而不是你能辯護的最小版本。第一個計劃是天花板方案：故事弧線（借用最近的類型鏡頭 — 菜單 § 類型鏡頭）、設計規格、每個場景的動態處理名稱（§ 5 的計劃規範）、轉場、音訊識別 — 音樂和聲音標記，或刻意沉默 — 使用者材料的放置，以及設計好的開場和結束。用一行說明每個層次增加什麼；標出昂貴的層次（渲染時間、登入、計費）。使用者會削減處理；他們永遠不應該需要一個一個地批准來拼湊一個方案。
- 天花板屬於概念，而非工具箱。 每個層次都必須服務於簡報的訊息 — 一個可以同樣裝扮任何影片的處理只是裝飾。工藝應達到天花板；內容永遠不會超出要求（§ 6）。
- 在檢查點之間，
../hyperframes/references/capability-menu.md有兩種作用。作為觸發列表：當使用者提到某個功能的輸入或建置達到其需求時，提供相關功能。作為每次迭代的升級通道：計畫、草稿或建置檢查點可能會攜帶一兩個針對使用者正在查看的材料的有針對性的提議（「場景 3 的靜態畫面想要倒數計時處理」）。在提供之前閱讀它；切勿傾瀉整個目錄。 - 在使用者接受某個功能後，立即產生其成品並在
BRIEF.md的相應正文部分記錄決定。僅當使用者明確更改某個前端欄位時，才重寫該欄位並記錄已確認的偏好。 - 保持相同的分鏡、驗證、最終預覽和渲染批准閘道。協作改變的是誰來掌舵，而不是需要什麼品質。
4. 在每個階段前載入必要知識
當條件符合時，這些讀取是強制性的：
| 條件 | 在採取行動前讀取 |
|---|---|
| 任何組合 HTML 或場景佈局 | /hyperframes-core；對於其佈局合約，使用 references/determinism-rules.md |
| 任何非平凡的創作或視覺處理 | /hyperframes-creative → references/house-style.md 和 references/video-composition.md |
| 任何動態、動畫或場景轉場 | /hyperframes-animation；遵循其路由到匹配的規則、轉接器、藍圖或轉場參考 |
storyboard: yes | ../hyperframes/references/storyboard-format.md 和 ../hyperframes/references/review-loop.md |
| 任何媒體資產或操作，包括旁白、背景音樂、音效、字幕、調色或變形 | /media-use（主機應用程式自己的音樂和音效工具優先）；對於框架播放和放置，也請讀取 /hyperframes-core → references/variables-and-media.md |
| 多場景組合 | ../hyperframes/references/production-loop.md |
flow: companion，在第一個計劃之前 | /hyperframes-creative → references/story-spine.md 和 references/house-style.md；最近的類型鏡頭和完整的 ../hyperframes/references/capability-menu.md — 天花板方案是根據這些設計的，而不是憑記憶回想 |
| 一個協作功能提供、捕獲、節拍網格、生成式影片、地圖、發布或跨工作流程功能 | ../hyperframes/references/capability-menu.md |
| 設計規格存在，在最終批准前 | /hyperframes-creative → references/design-adherence.md |
不要用回憶取代這些讀取。漸進式揭露僅在實際載入匹配參考時節省上下文。
5. 執行組合
使用此依賴順序。僅在其輸入不存在時跳過某個階段。
- 計劃。 說明觀看者弧線、結構、節奏和時長驅動因素。對於簡短的單一場景使用一個檔案；對於三個或以上硬場景切換或任何重複使用的場景，使用子組合。讀取
/hyperframes-creative→references/story-spine.md了解敘事弧線，references/beat-direction.md了解節奏，和/hyperframes-core→references/composition-patterns.md了解結構。對於開放式多場景簡報，透過/hyperframes-creative→references/prompt-expansion.md擴展提示。多場景計劃引用每個場景的形狀：當匹配時，來自/hyperframes-animation→blueprints-index.md的藍圖 ID，或當無匹配時，來自rules-index.md的其所組成的命名規則 — 動態名稱來自這些索引，從不發明。故事的真實性決定哪些場景存在；引用則裝扮它們。在你計劃自己建立任何具名外觀之前，請搜尋即時目錄：對於簡報中提及的每個外觀、效果、處理或轉場 — 「CRT 掃描線」、「故障」、「底片顆粒」、「閃爍掃掠」、「五彩紙屑爆發」 — 執行npx hyperframes catalog --query "<the look, in plain English>" --json並在計劃命名該外觀如何建置之前讀取頂部結果。此搜尋不需要安裝任何東西：不需要專案、不需要事先add、不需要帳戶。它從任何目錄對整個託管註冊表（約 400 個區塊和元件）進行排名，因此也適用於使用者在建置過程中要求的外觀。計劃中命名的區塊在第 3 階段安裝；僅在搜尋後沒有找到合適的結果時，才手動撰寫外觀。多場景計劃也會記錄為分派成品：在STORYBOARD.md中每個場景一個## Frame N區塊 —status: outline、一個宣告的src:、藍圖/規則引用，一個…