一般影片 (General Video) 是做什麼的?
在依賴此工作流程之前,請執行:
npx hyperframes skills update general-video
成功的空操作表示技能已是最新。若更新失敗,請直接顯示錯誤訊息,不要根據記憶繼續執行。
1. 套用跨領域的資料來源轉接器 (Apply cross-cutting source adapters)
- 媒體 (Media): 對於任何音訊、圖片、圖示、標誌、語音、調色、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的 URL,請先執行/figma。根據其導出的素材、令牌、元件或分鏡畫面來建構。請勿直接呼叫 Figma 連接器,因為它們會繞過 SVG 清理、媒體來源追溯和品牌令牌繫結。
這些轉接器不會改變 /hyperframes 所選定的工作流程。
2. 從專案狀態開始 (Start from project state)
套用第一個符合的狀態列;不要評估較低優先級的狀態列:
| 狀態 (State) | 行動 (Action) |
|---|---|
| 特定編輯 (Specific edit) | 進行編輯,保留現有的專案決策,然後重新執行受影響的檢查。不要重新開啟探索階段。 |
BRIEF.md 存在 | 讀取它。如果 workflow 指向另一個工作流程且 flow 不是 companion,則移交控制權。不要詢問簡報問題。 |
無簡報,但 hyperframes.json 或 STORYBOARD.md 存在 | 從檔案和記錄的偏好設定中恢復。僅根據已知事實回溯填寫 BRIEF.md。 |
| 全新建立 (Fresh creation) | 執行 /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. 解讀執行形狀 (Interpret the run shape)
僅使用 ../hyperframes-core/references/brief-contract.md 中的規範術語:
| 欄位 (Field) | 含義 (Meaning) | 效果 (Effect) |
|---|---|---|
flow | 由誰驅動 (Who drives) | automation: 選擇並執行路徑。companion: 在對話中共同創作。 |
storyboard | 分鏡版是否為審查介面 (Whether the board is a review surface) | yes: 執行計畫與草稿審查。no: 不透過分鏡版直接建構。 |
派生 mode | 檢查點閘門的行為 (How checkpoint gates behave) | 遵循簡報合約。切勿要求使用者命名模式。 |
請不要為這些狀態發明同義詞。持續的「只管建構」訊號由意圖層處理,並以 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)
當 flow: companion 時:
- 讀取
BRIEF.md,並將已接受的## Assets和## Customizations與專案當前產出進行比對。完成已接受但仍待處理的工作;跳過已完成的工作;不要將已接受的功能再次當作新提議提出。 - 以導演的身份到來,而非承包商。 選擇協作模式的用戶選擇了參與度和品質;誠實的回應是你所能設計的最佳版本,而非最易於辯護的最小版本。第一個計畫應該是天花板方案:故事弧線(借用最近的類型鏡頭——選單 § 類型鏡頭)、設計規格、每個場景引用其名稱的動作處理(§ 5 的計畫規範)、轉場、音訊識別——音樂和聲音標記,或刻意的沉默——放置用戶的素材,以及設計好的開場和結尾。用一句話說明每個層級增加什麼;標註昂貴的部分(渲染時間、登入、計費)。用戶是修剪方案,而不是逐項批准地拼湊方案。
- 天花板屬於概念,而非工具箱。 每個層級都必須服務簡報的訊息——一個可以以相同方式裝扮任何影片的方案只是裝飾。工藝應達到天花板;內容絕不能超出所要求的範圍(§ 6)。
- 在檢查點之間,
../hyperframes/references/capability-menu.md有兩種作用方式。作為觸發列表:當用戶提及某個功能的輸入,或建構過程達到其需求時,提供相關的功能。作為每次迭代的升級通道:一個計畫、草稿或建構檢查點可能附帶一兩個追蹤到的提議,指向用戶正在觀看的材料(「場景 3 的統計資料想要計數處理」)。在提供之前先閱讀它;切勿傾倒整個目錄。 - 用戶接受某個功能後,立即產出成果,並將決策記錄到匹配的
BRIEF.md正文部分。僅當用戶明確變更時,才重寫 frontmatter 欄位並記錄已確認的偏好設定。 - 保持相同的分鏡版、驗證、最終預覽和渲染核准閘門。協作模式改變的是誰掌舵,而不是品質需要什麼。
4. 在每個階段前載入必需的知識 (Load required knowledge before each stage)
當條件匹配時,這些讀取是強制性的:
| 條件 (Condition) | 在行動前讀取 (Read before acting) |
|---|---|
| 任何組合 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/variables-and-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. 執行組合 (Execute the composition)
使用以下依賴順序。僅當某階段的輸入不存在時才跳過它。
-
計畫 (Plan). 陳述觀眾的觀看弧線、結構、節奏和持續時間驅動因素。對於簡短的單一場景,使用一個檔案;對於三個或更多硬場景切換或任何重複使用的場景,使用子組合。閱讀
/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組合而成的具名規則——動作名稱必須來自這些索引,絕不能發明。故事的真相決定了哪些場景存在;引用只是為它們「穿上衣服」。多場景計畫也會被記錄為調度產出:在STORYBOARD.md中為每個場景建立一個## Frame N區塊——status: outline,一個聲明的src:,藍圖/規則引用,以及節拍文字——即使當storyboard: no時也是如此。該區塊是調度單位;分鏡版僅是審查介面。 -
應要求審查計畫 (Review the plan when requested). 對於
storyboard: yes,透過這些區塊執行共享的審查循環。對於storyboard: no,繼續執行而不開啟分鏡版。如果無論如何發生了計畫暫停,將子代理委派授權(步驟 4 的調度需要)合併到該暫停中,而不是稍後再次停止。 -
解析依賴項 (Resolve dependencies). 在並行工作前安裝註冊表區塊。暫存用戶素材,採用現有媒體,僅解析簡報要求的內容。當音訊時序驅動持續時間時,及早啟動音訊。
-
建構場景 (Build scenes). 對於簡短的單一場景作品,在加入動畫之前,先在其實現最顯眼的時刻實現場景(當存在已確認的線框時,該線框就是最終狀態,不得重繪),然後根據引用的藍圖或規則進行動畫——在撰寫動畫之前閱讀完整的配方主體(
/hyperframes-animation→blueprints/<id>.md,rules/<id>.md)。僅在大規模場景下,調度才物有所值。 編寫數據包和預熱新的工作上下文需要花費實際的分鐘數和令牌數:一部最多約 6 個短場景的電影,在此上下文中,一個接一個地內聯建構會更快(實測:5 個短場景 ≈ 9...
...(原文已截斷)