插件安裝: 在執行設定或更新命令之前,若此技能位於 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 connector 呼叫,因為它們會繞過 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 擁有此時間編輯權;僅在需要對內部包裝器進行視覺屬性動畫(如縮放、推進、平移、裁切、遮罩或 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主體章節中。僅在使用者明確變更時,才重寫 frontmatter 欄位並記錄已確認的偏好。 - 保持相同的分鏡、驗證、最終預覽和渲染批准閘控。協作模式改變的是誰來掌舵,而不是品質要求的標準。
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 scanlines","glitch","film grain","shimmer sweep","confetti burst" — 請執行npx hyperframes catalog --query "<用白話文描述的外觀>" --json並在規劃命名如何建構該外觀之前閱讀頂部結果。此搜尋不需要任何安裝:無需專案、無需事先add、無需帳戶。它會從任何目錄對整個託管註冊表(約 400 個區塊和元件)進行排序,因此也適用於使用者在中途要求的外觀。規劃中命名的區塊將在第 3 階段安裝;只有在搜尋後沒有找到任何合適的結果時,才手動創作一個外觀。多場景規劃也記錄為分發工件:在STORYBOARD.md中每個場景對應一個## Frame N區塊 —status: outline,一個宣告的src:,藍圖/規則引用,一個
…
[為翻譯已截斷]