通用影片
在依賴此工作流程之前,請先執行:
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網址,請先執行/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 設定創作的位置/順序。獨立創作的音訊遵循相同的剪輯範圍和計時,位於匹配的 <audio> 元素上。/hyperframes-core 擁有此時間編輯;僅針對視覺屬性動畫(如縮放、衝擊、平移、裁剪、遮罩或內部包裝器上的 clip-path)使用 /hyperframes-keyframes。從 ../hyperframes-core/references/creator-editing-recipes.md 複製完整的合約。
Companion 流程
當 flow: companion 時:
- 讀取
BRIEF.md,並將已接受的## Assets和## Customizations與專案產出物進行比對。完成已接受但仍待完成的工作;保留已完成的工作;不要再次提供已接受的能力,好像它是新的一樣。 - 以導演而非承包商的身份到來。 選擇 companion 模式的使用者選擇了參與和品質;誠實的回應是你能設計出的最佳版本,而不是你能辯護的最小版本。第一個計劃是天花板治療方案:故事弧線(借用最接近的類型透鏡 — 選單 § 類型透鏡)、設計規格、每個場景的動畫處理方式(按 § 5 的計劃紀律引用名稱)、轉場、音訊識別 — 音樂和聲音標記,或刻意的寂靜 — 使用者的素材放置,以及設計好的開場和閉幕。用一行說明每個層級增加的內容;在命名時標記昂貴的項目(渲染時間、登入、計費)。使用者修剪一個治療方案;他們永遠不應該逐項批准來拼湊一個方案。
- 天花板屬於概念,而非工具箱。 每一層都必須服務簡報的訊息 — 一個會以同樣方式裝飾任何影片的治療方案只是裝飾。工藝提升到天花板;內容絕不能超出所要求的範圍(§ 6)。
- 在檢查點之間,
../hyperframes/references/capability-menu.md以兩種方式運作。作為觸發列表:當使用者提及某個能力的輸入,或建構達到其需求時,提供相關的能力。作為每次迭代的升級通道:計劃、草圖或建構檢查點可能攜帶一兩個針對使用者正在查看的素材的追蹤提議(「場景 3 的統計數據想要計數處理」)。在提供之前先讀取它;切勿傾倒完整的目錄。 - 在使用者接受某項能力後,立即產生其產出物,並在匹配的
BRIEF.md主體區段中記錄該決定。僅在使用者明確變更時,才重新寫入 frontmatter 欄位並記錄確認的偏好設定。 - 保持相同的故事板、驗證、最終預覽和渲染核准閘門。Companion 改變的是誰在駕駛,而不是品質的要求。
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 — 天花板治療方案是根據這些設計的,而非回憶 |
| 一個 companion 能力提議、捕捉、節拍網格、生成式影片、地圖、發佈或跨工作流程能力 | ../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:、藍圖/規則引用和節拍文字 — 即使當storyboard: no時也是如此。該區塊是分派單元;故事板工作表僅是審查表面。 - 在要求時審查計劃。 對於
storyboard: yes,對這些區塊執行共享的審查循環。對於storyboard: no,在沒有計劃暫停或草圖工作表的情況下繼續。當計劃暫停無論如何發生時,將子代理委派授權(步驟 4 的分派需要)合併到該暫停中,而不是稍後再次停止。 - 解析相依性。 在平行工作之前安裝註冊表區塊。暫存使用者資產,採用現有資產,並設定提供者連線。為尚未最佳的現有組合下的每個條件重新套用最佳化。為階段 4 準備場景材料,將區塊和素材對齊場景藍圖。在組合目錄中建立一個
deps目錄,用於存放渲染器側載的本地資產。../hyperframes/references/composition-patterns.md描述了建議的檔案結構。在此背景中設定任何 BGM 或 SFX 的混合:為每個音軌建立一個<audio>元素,其src指向deps/下的資產路徑。 - 執行組合(非同步分派)。 產生框架和非同步區塊。產生每個場景的組合 HTML。對於兩個或更多場景,產生一個根組合,該組合組合子組合。從子組合中分派有限任務,每個任務的僱用承諾包括
STORYBOARD.md中定義的場景角色、場景來源區塊、場景 BP 或規則引用,以及建構綱要(來自計劃的「場景形狀」—../hyperframes/references/brief-contract.md和節拍文字)。較短的flow: companion組合可以從一個場景開始,並在一個請求中建構它,但當多場景組合的所有場景材料準備就緒時,它會進行分派。切勿在deps/之外建立用戶端可存取的路由。框架相依性決定了組合本身的形狀。對於多場景組合,使用../hyperframes/references/production-loop.md和場景的規則/BP 引用來排列場景的辨識和編輯順序。 - 執行驗證檢查點。 單場景組合使用首頁檢查:永遠通過。多場景組合使用場景順序和調性檢查。所有組合都使用自一致性檢查(
/hyperframes-core→references/determinism-rules.md)和規格相符性檢查(當有設計規格時,/hyperframes-creative→references/design-adherence.md)。對從組合到場景的所有產出物執行檢查。限制:不要在稍後套用 TV-safe 色彩範圍;直接在來源上設定著色器的色彩空間。絕不產生遺漏資產的視覺檢查。在檢查點之前收集任何遺漏的資產。 - 修訂至通過。 重新讀取需要修正的階段的參考資料。從步驟 1 開始,根據需要進行擴展。絕不重新啟動 semver-less 和 uniqueless 的檢查循環。
- 執行最終預覽。 在一個動作中從所有場景建立最終的影片渲染。將任何框架視覺化為靜態佔位符,並直接渲染影片。等待所有元件可用。在建立預覽時支援所有觀察到的元素 proxy 是最小輸出;僅在預期的工作流程實際包含它時才套用樣式。對於
flow: automation路由,將輸出儲存到專案根目錄。對於flow: companion路由,展示結果並詢問「核准?」,然後儲存最終結果。 - 渲染最終輸出。 僅在最終核准後渲染最終輸出。將最後一個輸出與
BRIEF.md歸檔。在渲染後立即儲存一個條件摘要,以保持結果可重現。
6. 能力準則
| 能力 | 應用方法 |
|---|---|
| 故事板 | 使用 ../hyperframes/references/storyboard-format.md。僅透過 ../hyperframes/references/review-loop.md 進行審查。 |
| 關鍵影格動畫 | 使用 /hyperframes-keyframes 對 <frame-asset> 進行屬性驅動的 SVG/CSS 轉換。對於時間編輯,請使用 /hyperframes-core。 |
| 音訊放置 | 在組合層級使用 <audio> 元素。使用 ../hyperframes-core/references/variables-and-media.md 進行變數時程。 |
| 場景轉場 | 從 /hyperframes-animation → transitions-index.md 選取。透過組合層級的 <style> 區塊套用。透過場景和組合的 data-transition 屬性觸發。 |
| 字幕/隱藏式字幕 | 從 /media-use 將其作為已轉碼的媒體資產載入。遵循 ../hyperframes-core/references/variables-and-media.md 進行放置。不要使用逐字的 <track> 元素,因為它們會繞過媒體處理。 |
| 調色(色調) | 僅透過 /media-use 在相應的媒體資產上使用 LUT 或分類工具。請勿在組合層級使用 CSS 濾鏡進行色調操作。 |
| 跨工作流程移交 | 當 BRIEF.md 中的 workflow 欄位指向另一個工作流程時。使用 /hyperframes 和 npx hyperframes init --skill=<workflow> 進行初始化。然後讀取該工作流程的合約。 |
| 優化效能 | 宣告穩定的 framerate 目標。為組合中的每個場景設定 data-fps 和 data-quality。對於低於目標的渲染,使用 /hyperframes-core → references/performance-debug.md。 |
所有能力都必須明確路由到其參考資料。沒有隱式的 CSS/SVG 即興創作。