⚠ 合約狀態:尚未移植至 Remotion
此技術堆疊的輸出框架為 Remotion + React(
/hyperframes-core)。本技能仍描述已淘汰的 HTML +data-*+ 暫停的 GSAP 時間軸 管道,其捆綁的腳本仍會以該合約格式輸出index.html。在移植完成前:
- 請勿 執行
npx hyperframes <anything>——該 CLI 已淘汰。/hyperframes-cli已將每個舊指令對應到其 Remotion 等效指令。- 請勿 將其
data-*標記或 GSAP 時間軸程式碼複製到 Remotion 專案中。- 應 從中汲取其工藝:故事架構、剪輯節奏、視覺設計、以及螢幕上應出現內容的決策。這部分與框架無關,也是本技能保留的原因。
- 應 透過
/hyperframes-core的合約來表達結果:使用<Composition>、<Sequence>以及從useCurrentFrame()衍生的數值。請在您的摘要中說明您何時需要繞過此問題,以便完成移植。
一般影片
在依賴此工作流程之前,請執行:
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-core/references/brief-contract.md中的閘道規則:協作模式下等待登入或明確的離線選擇;自主模式下則陳述狀態並透過可用的離線提供者繼續。當沒有離線提供者能滿足必要功能時,請回報阻礙。單純的本機採用不需要認證閘道。 - Figma: 如果有任何輸入是
figma.com網址,請先執行/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-core/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-core/references/brief-contract.md 中的標準術語:
| 欄位 | 含義 | 效果 |
|---|---|---|
flow | 由誰主導 | automation:選擇並執行路徑。companion:在對話中共同創作。 |
storyboard | 分鏡板是否為審查介面 | yes:執行計畫和草稿審查。no:不透過分鏡板直接建構。 |
衍生的 mode | 檢查點閘道的行為方式 | 遵循簡化合約。切勿要求使用者命名模式。 |
不要為這些狀態創造同義詞。持續的「直接建構」訊號由意圖層處理,並以 flow: automation、storyboard: no 的形式到達。
- 對於
flow: automation,選擇路徑並在第一次進度更新中用一行說明。 - 對於特定編輯,進行編輯,不要創造新的路徑。
對於現有素材的硬剪輯、修剪、拼接或重新排序,請將相同的影片來源複製到多個剪輯元素中。在每個副本上,使用 data-media-start 加 data-duration 設定來源範圍,然後使用 data-start 設定編排的位置/順序。單獨編寫的音訊在匹配的 <audio> 元素上遵循相同的剪輯範圍和時間。/hyperframes-core 負責此時間編輯;僅對視覺屬性動畫(如縮放、推進、平移、裁切、遮罩或內部包裝器上的 clip-path)使用 /hyperframes-keyframes。從 ../hyperframes-core/references/editing-recipes.md 複製完整的合約。
協作流程
當 flow: companion 時:
- 讀取
BRIEF.md,並將已接受的## Assets和## Customizations與專案工件進行比對。完成已接受但仍未完成的工作;保持已完成的工作不變;不要再次提供已接受的功能,就好像它是新的一樣。 - 以導演的身份到來,而不是承包商。 選擇協作模式的使用者選擇的是參與和品質;誠實的回應是你所能設計的最佳版本,而不是最小、最能辯解的版本。第一個計畫就是天花板級處理方案:故事弧線(借用最接近的類型鏡頭——選單 § 類型鏡頭)、設計規格、每個場景的具名動態處理(參見 § 5 的計畫規範)、過場、音訊識別——音樂和聲音標記,或刻意的靜音——使用者素材的放置,以及設計好的開場和結尾。用一句話說明每個層級增加了什麼;在提到它們時,標記昂貴的層級(渲染時間、登入、計費)。使用者是從上往下修剪處理方案;他們絕不應該逐一批准來拼湊一個。
- 天花板屬於概念,而不是工具箱。 每個層級都必須服務簡報的訊息——一個會以同樣方式裝飾任何影片的處理方案只是裝飾。工藝提升至天花板;內容絕不超出被要求的範圍(§ 6)。
- 在檢查點之間,
../hyperframes/references/capability-menu.md有兩種作用。作為觸發列表:當使用者提到某項功能的輸入,或建構過程達到其需求時,提供相關功能。作為每個階段的升級管道:一個計畫、草稿或建構檢查點可能附帶一兩個針對使用者正在查看的材料所提供的功能(「場景3的靜態畫面想要計數效果」)。在提供之前先讀取它;切勿傾倒整個目錄。 - 使用者接受某項功能後,立即產出該功能的工件,並將決策記錄到匹配的
BRIEF.md正文區段中。僅在使用者明確更改時,才改寫 frontmatter 欄位並記錄已確認的偏好設定。 - 保持相同的分鏡板、驗證、最終預覽和渲染審核閘道。協作模式改變的是誰在掌舵,而不是對品質的要求。
4. 在每個階段前載入必要知識
當條件匹配時,這些讀取是強制性的:
| 條件 | 在執行前讀取 |
|---|---|
| 任何合成 HTML 或場景佈局 | /hyperframes-core;使用 references/determinism-rules.md 了解其佈局合約 |
| 任何非平凡的創作或視覺處理 | /hyperframes-creative → references/house-style.md 和 references/video-composition.md |
| 任何動態、動畫或場景過場 | /hyperframes-animation;遵循其路由到匹配的規則、適配器、藍圖或過場參考 |
storyboard: yes | ../hyperframes-core/references/storyboard-format.md 和 ../hyperframes-core/references/review-loop.md |
| 任何媒體資產或操作,包括旁白、背景音樂、音效、字幕、調色或變換 | /media-use;對於框架播放和放置,也請讀取 /hyperframes-core → references/media.md |
| 多場景組合 | ../hyperframes-core/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/project-structure.md以了解結構。對於開放式多場景簡報,透過/hyperframes-creative→references/prompt-expansion.md擴展提示。多場景計畫會引用每個場景的形狀:當有匹配的藍圖時,引用來自/hyperframes-animation→blueprints-index.md的藍圖 ID;當沒有匹配的藍圖時,則引用其組合的具名規則(來自rules-index.md)——動態名稱來自這些索引,絕不憑空發明。故事的真實性決定了哪些場景存在;引用只是為其添上裝飾。多場景計畫也會被記錄為分派工件:在STORYBOARD.md中為每個場景建立一個## Frame N區塊——包含status: outline、一個宣告的src:、藍圖/規則引用和節拍文字——即使storyboard: no也是如此。該區塊是分派單位;分鏡板僅是審查介面。 - 按需求審查計畫。 對於
storyboard: yes,對這些區塊執行共享的審查循環。對於storyboard: no,繼續進行,不開啟分鏡板。如果仍然發生計畫暫停,
……
[為翻譯而截斷]