media-use: 在獲取音訊/圖像之前,請呼叫
/media-use從 HeyGen 目錄中解析 BGM/SFX/影像。先執行--adopt以註冊現有資產。請參閱/media-use技能。
產品發佈到 HyperFrames
使用此技能來捕捉產品、了解其品牌、規劃發佈影片,並在 HyperFrames 中逐幀構建。
在執行步驟 0 之前確認路線。 您是協調者。執行每個步驟,驗證其關卡,然後才繼續下一步。此技能適用於正在進行市場行銷、發佈、推廣或揭露的產品,包括諸如“為我們的網站製作宣傳片”等請求(當其目的是促銷時)。將其他意圖引導至別處:一般的非發佈網站導覽 ->
/website-to-video;沒有產品的主題解說 ->/faceless-explainer;GitHub PR ->/pr-to-video;在現有素材上添加字幕 ->/embedded-captions;簡短無旁白的動態圖形 ->/motion-graphics。如果用戶只說“製作一個影片”或路線不確定,請先閱讀/hyperframes。
您是協調者。在 videos/<project>/ 目錄下工作。按順序執行步驟並在繼續之前通過每個關卡。用戶關卡步驟為步驟 0、步驟 3 和步驟 6。除了步驟 5(您為每個影格分派一個子代理)之外,所有步驟都由您自己執行。不要在這裡放置設計或動畫規則;這些規則存在於影格工作者子代理、此技能的本地 ../hyperframes-animation/rules/ + ../hyperframes-animation/blueprints/ 以及 hyperframes-creative 中。
工作流程:步驟 0 設定 -> hyperframes.json;步驟 1 捕捉 -> capture/;步驟 2 設計系統 -> frame.md;步驟 3 分鏡腳本/腳本 -> STORYBOARD.md 和 SCRIPT.md;步驟 3.1 音訊 -> audio_meta.json;步驟 4 視覺設計 -> 增強的 STORYBOARD.md;步驟 5 影格 -> compositions/frames/NN-*.html 和 index.html;步驟 6 最終渲染 -> renders/video.mp4。
步驟 0:設定與簡報
目標:鎖定核心影片簡報,並在需要時建立 HyperFrames 專案。
僅在缺少 hyperframes.json 時才初始化。使用 kebab-case 命名 <project>(例如來自品牌或域名,如 acme-promo);切勿使用工作區名稱或時間戳。
npx hyperframes init "videos/<project>" --non-interactive --example=blank — init 會檢查已安裝的技能是否與 GitHub 上的最新版本相符,並在有任何技能過期時更新全域技能集。
在簡報之前顯示登入狀態 — 執行 npx hyperframes auth status 並逐字轉達其輸出(不要改寫或重新解釋)。 它會報告語音/BGM 將使用 HeyGen 還是本地引擎,並且在未登入時,說明如何登入。如果未登入,請停止並等待用戶選擇 — 登入,或說 "go"/"offline" 以繼續使用本地引擎 — 然後再詢問簡報或任何其他問題。 將其視為一個真正的決策點,而不是一個備註;不要將選擇納入簡報問題中,也不要將金鑰寫入每個儲存庫的 .env 中。(在自主模式下,記錄狀態並以離線模式繼續。)請參閱 ../hyperframes-media → Preflight 以獲取規範性指導。
關卡: hyperframes.json 存在,且角度、長度、縱橫比和語言已鎖定;已顯示登入狀態(已登入,或繼續離線作業)。
步驟 1:捕捉資產
目標:收集影片的原始材料、品牌訊號和可用資產。
分類輸入並選擇路徑。明確的 URL -> 捕捉它,並使用該網站進行旁白和資產。貼上的腳本/簡報 -> 逐字儲存為 user_script.txt,詢問一次“逐字使用還是重新組織?”,將答案儲存為 VO_MODE,然後解析捕捉目標:文字中的 URL -> 使用它;僅有品牌名稱 -> WebSearch,用一行確認 URL,然後爬取;沒有 URL/網站 -> 無捕捉路徑。
使用以下命令執行捕捉:npx hyperframes capture "<URL>" -o ./capture
如果存在 GEMINI_API_KEY、GOOGLE_API_KEY 或 OpenRouter 金鑰,則捕捉會自動為資產添加說明,放入 capture/extracted/asset-descriptions.md。這不是一個審查關卡。如果沒有視覺金鑰,則使用 DOM 上下文並繼續。
無捕捉路徑:手動建立 capture/extracted/tokens.json、capture/extracted/visible-text.txt、capture/extracted/asset-descriptions.md 和 capture/assets/。tokens.json 應為 { "title": "", "description": "", "colors": [], "fonts": [] };盡可能從簡報中填寫標題/描述。visible-text.txt 包含完整的簡報或腳本。asset-descriptions.md 應說明未捕捉到任何資產(除非用戶提供了資產備註)。
關卡: capture/extracted/tokens.json、capture/extracted/visible-text.txt、capture/extracted/asset-descriptions.md 和 capture/assets/ 存在;您可以用一個清晰的句子說明品牌。將 asset-descriptions.md 視為主要資產清單。如果實際捕捉後它缺失,請停止並報告捕捉不完整。如果存在 capture/BLOCKED.md,請遵循它。
步驟 2:設計系統
目標:選擇一個已出貨的影格預設;一個腳本會將其轉換為此影片的 frame.md + 字幕外觀。
您做出唯一的判斷 — 選擇哪個預設。閱讀 ../hyperframes-creative/references/design-spec.md,並選擇外觀最符合品牌和簡報的預設。然後執行:
node <SKILL_DIR>/scripts/build-frame.mjs --preset <name> --hyperframes .
腳本確定性地完成其餘工作:複製預設的 FRAME.md → frame.md 並重新混合到 capture/extracted/tokens.json 中的品牌令牌上(品牌顏色按角色映射到預設的顏色鍵上 — 墨水、畫布、強調色 — 保留鍵/結構/組件;預設的顯示字體和正文字體替換為品牌字體),複製預設的字幕外觀到 .hyperframes/caption-skin.html,並自我驗證(映射損壞時退出代碼 1)。一旦退出代碼為 0,就繼續下一步 — 不要手動編輯規格。
tokens.json 沒有品牌顏色/字體(例如無捕捉) -> 腳本保留預設自己的調色板,這是一個完整的可出貨設計。如果簡報中提到了捕捉遺漏的品牌顏色/字體,請在執行前將其添加到 capture/extracted/tokens.json 中(或使用用戶的 design.md 來填充它);之後僅在映射確實需要時才手動調整 frame.md。
關卡: build-frame.mjs 退出代碼為 0 — frame.md 來自一個命名預設,並且(當預設附帶一個時).hyperframes/caption-skin.html 作為字幕外觀來源存在。
步驟 3:分鏡腳本和腳本
目標:將簡報和捕捉到的材料轉換為一個已批准的逐影格故事計畫。
閱讀 references/story-design.md、../hyperframes-animation/blueprints-index.md、../hyperframes-core/references/storyboard-format.md 和 ../hyperframes-core/references/script-format.md。使用它們來撰寫 STORYBOARD.md,並在需要旁白時撰寫 SCRIPT.md。
使用 story-design.md 來獲取故事藍圖、鉤子、說服邏輯、節拍、VO_MODE 和資產選擇。作為一個軟性指南,請查閱 ../hyperframes-animation/blueprints-index.md 中的角色→藍圖選單:對於每個節拍,在適合時標記一個候選藍圖 ID。故事的真實性仍然決定哪些節拍存在 — 永遠不要強迫節拍符合藍圖,也永遠不要僅僅因為有現成的成熟形狀就發明一個節拍。從 capture/extracted/asset-descriptions.md(權威清單)中選擇每個視覺影格的 asset_candidates — 不要瀏覽原始的 capture/assets/。除非該清單缺失或無法使用,否則不要要求用戶選擇資產。使用分鏡腳本和腳本參考中的確切必填欄位。
草擬後,顯示一個逐影格的摘要。在同一則訊息中,向用戶詢問兩件事:(a) 批准或要求更改,以及 (b) 他們是否想要分鏡腳本框架的即時預覽(npx hyperframes preview)— 只有在用戶同意時才打開它。迭代直到獲得批准,並將預覽選擇帶到步驟 6。
關卡: STORYBOARD.md 存在,每個視覺影格都有 asset_candidates,SCRIPT.md 在需要旁白時存在,並且用戶已批准逐影格計畫。
步驟 3.1:音訊
目標:從已批准的腳本生成旁白、單字計時、音樂和音訊元資料。
在步驟 3 批准後開始音訊工作。在背景執行它,然後繼續到步驟 4。
node <SKILL_DIR>/scripts/audio.mjs --script ./SCRIPT.md --storyboard ./STORYBOARD.md --hyperframes . --out ./audio_meta.json &
音訊腳本處理旁白、單字計時、從 HeyGen 音樂庫查找 BGM 以及計時元資料。BGM 情緒來自分鏡腳本的 music: 欄位。這使用 HeyGen 音訊 API 進行檢索,而不是生成,並使用與 TTS 相同的 ~/.heygen 憑證。有關提供者的詳細資訊,請閱讀 ../hyperframes-media/references/tts.md。
如果沒有旁白且沒有 SCRIPT.md,則跳過語音生成。如果分鏡腳本有音樂情緒,BGM 仍可能執行。
關卡: 音訊工作已開始,或專案已標記為無聲。
步驟 4:影格視覺設計
目標:為每個分鏡腳本影格添加視覺方向、佈局意圖和動畫選擇。
就地編輯 STORYBOARD.md。不要建立另一個分鏡腳本。使用 frame.md 作為顏色、字體、佈局感覺和風格的權威來源。
閱讀 references/visual-design.md、../hyperframes-animation/blueprints-index.md、references/motion-language.md 和 ../hyperframes-animation/rules-index.md。使用 visual-design.md 來獲取方法(時間編碼的鏡頭序列、內聯佈局詞彙以及必需的 ## Video direction 區塊)。使用 ../hyperframes-animation/blueprints-index.md 來選擇每個影格的鏡頭形狀。使用 motion-language.md(動畫詞彙 + 動畫原則)和 ../hyperframes-animation/rules-index.md(有效的規則名稱)來處理動畫 — 不要發明動畫名稱。
對於每個視覺影格,根據 visual-design.md 的方法,在 STORYBOARD.md 中撰寫一個時間編碼的鏡頭序列:選擇影格的藍圖(或組合),用此產品的內容實例化它,並根據旁白調整每個場景的揭示節奏,使影格在其整個持續時間內展開,而不是前置載入然後凍結。根據每個場景內聯說明佈局和動畫(詞彙在 visual-design.md 和 motion-language.md 中)。添加一個影片範圍的 ## Video direction 區塊。
不要更改故事、腳本、資產選擇、asset_candidates、transition_in 或捕捉到的原始材料。不要在此步驟中撰寫 HTML。
在視覺設計鎖定後,暫存命名資產:
node <SKILL_DIR>/scripts/stage-assets.mjs --storyboard ./STORYBOARD.md --hyperframes .
關卡: 每個視覺影格都有一個時間編碼的鏡頭序列,其揭示節奏已根據旁白調整(無前置載入);## Video direction 存在;assets/ 包含命名資產。
步驟 5:建立影格
目標:將每個分鏡腳本影格建立為 HTML 合成,並組裝可播放的影片。
如果音訊已啟動,請等待步驟 3.1 的音訊完成。然後同步持續時間並獲取 SFX;如果無聲則跳過兩者。
node <SKILL_DIR>/scripts/audio.mjs sync-durations --audio-meta ./audio_meta.json --storyboard ./STORYBOARD.md
node <SKILL_DIR>/scripts/audio.mjs fetch-sfx --storyboard ./STORYBOARD.md --hyperframes .
持續時間同步是機械性的:真實語音持續時間獲勝;無聲影格保留估計值;永遠不要手動編輯同步後的持續時間。
在分派之前,閱讀 sub-agents/frame-worker.md 和 ../hyperframes-core/references/subagent-dispatch.md。為每個影格分派一個子代理,盡可能並行;否則分批執行工作者。每個工作者只處理一個影格。
每個工作者的上下文必須包含 PROJECT_DIR、frame_id、畫布大小、字幕狀態和啟用字幕時的保留區帶,以及 RULES_DIR 作為此技能 ../hyperframes-animation/rules/ 的絕對路徑。每個工作者讀取 frame.md、其來自 STORYBOARD.md 的 ## Frame N 區塊、每個引用動畫的本地規則配方(../hyperframes-animation/rules/<id>.md)以及影格的藍圖模板(../hyperframes-animation/blueprints/<id>.md)。每個工作者只寫入 compositions/frames/NN-*.html。工作者不得編輯 STORYBOARD.md。
當每個工作者返回時,協調者在 STORYBOARD.md 中將該影格標記為 animated。
在音訊計時存在後,在背景建立字幕並組裝索引:
node <SKILL_DIR>/scripts/captions.mjs build --storyboard ./STORYBOARD.md --audio-meta ./audio_meta.json --hyperframes . --out ./caption_groups.json &
node <SKILL_DIR>/scripts/assemble-index.mjs --storyboard ./STORYBOARD.md --hyperframes .
captions.mjs 使用專案的 .hyperframes/caption-skin.html(在步驟 2 中複製)作為字幕外觀,從 frame.md 注入品牌令牌;當沒有外觀時,它會渲染內建的預設藥丸形狀。captions: skipped (<reason>) 是有效的。明確跳過時繼續不帶字幕。
關卡: 每個影格都標記為 animated,index.html 存在,並且已建立字幕或明確跳過。
步驟 6:最終確定
目標:驗證組裝後的影片,獲得用戶批准,並渲染最終的 MP4。
注入過渡效果,執行檢查,暫停以供審查,然後渲染。
node <SKILL_DIR>/scripts/transitions.mjs inject --storyboard ./STORYBOARD.md --hyperframes .
node <SKILL_DIR>/scripts/transitions.mjs verify --storyboard ./STORYBOARD.md --index ./index.html
npx hyperframes lint
npx hyperframes validate
npx hyperframes inspect
npx hyperframes snapshot --at <frame-midpoints>
snapshot 將捕捉到的影格拼接成一個連絡表(snapshots/contact-sheet.jpg)。快速瀏覽一下;如果沒有明顯問題,請繼續 — 不要在此停留。
如果命令失敗,請輸出 stderr 並停止 — 不要堆疊恢復命令。自行修復:對 compositions/frames/NN-*.html 進行最便宜的安全編輯,然後重新執行失敗的檢查。
檢查通過後,暫停以供用戶審查。影片已組裝完成,可在 Studio 中檢視和編輯。僅在步驟 3 和步驟 6 之間管理一次預覽:如果用戶之前要求,則打開它;如果之前拒絕,則提供它;如果用戶已在 Studio 中審查,則不要再次詢問。
預覽:npx hyperframes preview
渲染...