外掛安裝： 在設定或新鮮度命令之前，當此技能位於 HyperFrames 外掛內部時，請遵循外掛安裝規則。獨立安裝則保留下方更新說明。
通用影片
在開始時執行 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.com的 URL，請先執行/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：執行規劃與草稿審查（boards/storyboard.html，格式請見 ../hyperframes-creative/references/storyboard-recipe.md）。no：直接建立。 |
衍生的 mode | 檢查點閘門的行為如何 | 遵循簡報合約。永遠不要要求使用者命名模式。 |
不要為這些狀態發明同義詞。持續的「直接建立」訊號由意圖層處理，並以 flow: automation、storyboard: no 的形式呈現。
- 對於
flow: automation，選擇路線並在第一個進度更新中用一行說明。 - 對於特定編輯，進行編輯，不要發明新路線。
若要對現有素材進行硬剪、修剪、拼接或重新排序，請將相同的影片來源複製到多個片段元素中。在每個副本上，使用 data-media-start 加上 data-duration 設定來源範圍，然後使用 data-start 設定創作者指定的位置/順序。每個影片段落保留其聲音：聲音保留在片段上（data-has-audio="true"），因此剪輯影片也會剪輯其聲音。/hyperframes-core 擁有此時間編輯權；僅在需要視覺屬性動畫（如縮放、重擊、平移、裁切、遮罩或內部包裝器上的 clip-path）時使用 /hyperframes-keyframes。從 ../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 "<效果，用簡單英文描述>" --json並在計劃命名該效果如何建構之前讀取頂部結果。搜尋不需要安裝任何東西：不需要專案、不需要事先add、不需要帳戶。它會從任何目錄對整個託管註冊表（約 400 個區塊和元件）進行排序，因此它也會套用...