外掛安裝: 在執行設定或最新命令之前,若此技能位於 HyperFrames 外掛內,請遵循外掛執行規則。獨立安裝則保留下方的更新說明。
首先,保持此技能最新 — 先與使用者確認後再執行:
npx hyperframes skills update product-launch-video。如果一切已是最新狀態,則為快速無操作指令;否則,在您依賴此技能及其依賴的核心領域技能之前,它會先進行刷新。
media-use:在獲取音訊/圖片/標誌之前,請呼叫
/media-use來從 HeyGen 目錄解析 BGM/SFX/圖片,並從其官方來源獲取品牌標誌。首先執行--adopt以註冊現有素材。請參閱/media-use技能。
figma 來源:如果來源是 figma.com 的 URL,請先執行
/figma— 進行素材匯出、品牌代幣、以及組件/分鏡重建(如有需要),然後從其輸出建構此工作流程。不要直接透過原始的 MCP 工具驅動 Figma:這會繞過 SVG 清理、.media/manifest.jsonl來源追蹤、以及品牌代幣var()綁定,導致後續的品牌變更無法傳播,除非完全重新匯入。
產品上市至 HyperFrames
使用此技能來捕捉產品、了解其品牌、規劃上市影片,並在 HyperFrames 中逐幀建構。
前門是
/hyperframes。 您是編排者。執行每個步驟,驗證其門檻,然後才繼續下一步。此技能適用於正在進行行銷、上市、推廣或揭露的產品,包括當請求目的是推廣時的「為我們的網站製作宣傳片」等請求。網站導覽 / 展示請求也留在此處處理:BRIEF.md承載「如實呈現」的意圖,而捕獲的螢幕截圖成為影片展示的素材。任何其他意圖、單純的「製作影片」、或任何不確定性 → 請先閱讀/hyperframes— 意圖層負責所有路線決策,而一個沒有BRIEF.md就直接到達此處的全新建案無論如何都會通過它(設置的開場規則)。
您是編排者。在 videos/<project>/ 中工作。按順序執行步驟,並在繼續之前通過每個門檻。使用者門檻步驟為步驟 0、步驟 3 和步驟 6。在步驟 0 之前閱讀 ../hyperframes/references/brief-contract.md — 它定義了門檻類型,以及 BRIEF.md 的 flow/storyboard 如何推導出管理步驟 3/4/6 門檻的模式。除步驟 5 外,請自行執行每個步驟;在步驟 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 專案,並使簡報持久化。
簡報由意圖層確認,而非此處提出的問題。 開場規則,依序:(1) BRIEF.md 存在 → 讀取它,不問任何問題 — 簡報已確定,其 flow/storyboard 推導出模式(簡報合約 § 1)。(2) 沒有 BRIEF.md,但專案存在(磁碟上有 hyperframes.json / STORYBOARD.md)→ 從分鏡的前置資料和記錄的偏好繼續;永遠不要重新盤問一個半成品專案。(3) 兩者都沒有 — 一個直接到達此處的全新建案請求 → 閱讀 /hyperframes 並執行其意圖層(references/intent-interview.md):它檢查配方和記錄的預設值,進行此路線的問題詢問(../hyperframes/references/routes/product-launch-video.md),並回傳鎖定的簡報。編輯請求則跳過所有這些步驟 — 直接進行編輯。
僅在 hyperframes.json 缺失時才進行初始化。以中橫線命名法(kebab-case)從品牌或網域命名 <project>,例如 acme-promo;切勿使用工作區名稱或時間戳記。
npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=product-launch-video — init 會檢查已安裝的技能與 GitHub 上的最新版本是否一致,並在有任何技能過期時更新全域集。
初始化後,讓 <PROJECT_ROOT> 為 videos/<project>,並以該目錄作為工作目錄執行所有後續的相對路徑命令。在以下的命令中,. 表示 <PROJECT_ROOT>;永遠不要將 .media、capture 或輸出檔案寫入呼叫者目錄。
在初始化後立即撰寫 BRIEF.md(切勿在此之前 — init 會拒絕非空目錄):意圖層鎖定的簡報,其格式遵循 ../hyperframes/references/brief-format.md。將 <MEDIA_DIR> 解析為已安裝的 /media-use 技能目錄。然後使用 node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes . 記錄每個偏好支援的答案(brief-format.md 指定了子集)。如果意圖層採用了一個配方,則執行 node <MEDIA_DIR>/scripts/recipe.mjs use --hyperframes . --name <name>;它會將配方的 frame.md 複製到專案中(步驟 2 將被跳過),並回傳步驟 3 將據以草擬的骨架。配方填寫答案,而非核准;審查門檻仍會執行。
在繼續設定之前顯示登入狀態 — 執行 npx hyperframes auth status 並逐字傳達其輸出。它會報告語音/BGM 將使用 HeyGen 還是本地引擎,以及在未登入時如何登入。請注意退出碼合約:auth status 在未登入時(以及當儲存的憑證被拒絕時)退出碼為 1 — 這個非零退出是正常的未登入狀態,並非命令失敗,因此不要將其視為錯誤,不要重試它,也不要將其與 &&/set -e 串聯,以免中止工作流程。採用一個分支:
- 協作模式: 等待使用者登入或明確選擇
offline/go。 - 自主模式: 報告狀態並繼續使用可用的本地引擎。
當沒有可用的離線提供者時,不要默默遺漏一個必要功能;應指出障礙。不要將此決定合併到另一個問題中,也不要將金鑰寫入每個儲存庫的 .env 檔案中。認證所有權和離線備援:請參閱 /media-use references/setup-providers.md § Providers。
門檻: hyperframes.json 和 BRIEF.md 存在;偏好支援的答案已記錄(簡報合約 § 2);登入狀態已顯示(已登入,或繼續以離線模式進行)。
步驟 1:捕獲素材
目標:收集影片的來源素材、品牌信號和可用的素材。
對輸入進行分類並選擇路徑。明確的 URL -> 捕獲它,並使用該網站進行旁白和素材。貼上的腳本/簡報 -> 逐字儲存為 user_script.txt;VO_MODE(逐字或重構)來自 BRIEF.md — 當腳本到達時,意圖層會詢問此項(只有在簡報缺乏此項時,才在此處詢問一次)。然後解析捕獲目標:文字中的 URL -> 使用它;僅品牌名稱 -> 使用 WebSearch,在一行中確認 URL,然後爬取;沒有 URL/網站(或簡報說不要抓取)-> 無捕獲路徑。
使用以下命令執行捕獲:npx hyperframes capture "<URL>" -o ./capture --json。除非呼叫者擁有較短的截止日期,否則保留預設的導航後預算;在這種情況下,傳遞一個正數的 --capture-budget <毫秒>,以為後續工作留出時間。--timeout 僅控制頁面導航。只有在選擇性停用圖片說明時才使用 --skip-vision。
立即檢查命令結果和輸出目錄。非零退出碼、JSON ok: false、或 capture/BLOCKED.md 存在是捕獲路徑的硬停:報告記錄的原因,不要使用部分的螢幕截圖、DOM、代幣或素材。在 URL 捕獲失敗後,不要自行製造一個合成的無捕獲備援方案。僅當原始簡報提供了來源素材,或者使用者明確在失敗後切換到提供的螢幕截圖或簡報時,才繼續執行無捕獲路徑。
諸如「文字內容非常少」的警告加上空的素材目錄,並不能證明頁面可用。對於網站導覽或如實呈現的簡報,需要可信的捕獲結構或提供的螢幕截圖;如果兩者都不存在,請停止。不要僅僅因為捕獲不可用就發明或重建頁面。
對於網站導覽或如實呈現的簡報,捕獲的頁面是視覺真相來源。使用真實的螢幕截圖,而不是重建完整的網站 HTML。如果截圖需要內部移動,則將截圖保留為底層,並在測量到的位置上疊加真實的捕獲素材,或者僅重建移動的那一個組件。對於捲動截圖,在 capture/screenshots/full-page.png 上對視口進行動畫 — 這是整個文件的 1 倍圖層,對於一個沿著它向下移動的 1920 寬視口來說是像素精確的。當頁面太高無法一次性捕獲時,該檔案會缺失;請改為使用同一目錄中重疊的捲動位置截圖作為備援。超過 1:1 的放大需要該區域自己的 2 倍捕獲,因為 1 倍圖層沒有高於 1 倍的餘裕。僅當使用者明確要求風格化解釋時,才重建整個頁面;僅有不可用的捕獲本身並非授權。
如果存在 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": [] };盡可能從簡報中填寫 title/description。visible-text.txt 包含完整的簡報或腳本。asset-descriptions.md 應說明未捕獲任何素材,除非使用者提供了素材說明。
門檻: 捕獲 JSON 報告 ok: true;capture/BLOCKED.md 不存在;capture/extracted/tokens.json、capture/extracted/visible-text.txt、capture/extracted/asset-descriptions.md 和 capture/assets/ 存在;並且您能用一句清晰的句子說明品牌。將 asset-descriptions.md 視為主要的素材庫存。如果在實際捕獲後它缺失,請停止並報告捕獲不完整。僅在此結構性門檻仍然通過時,關於降級的可選階段的警告才是可接受的。
步驟 2:設計系統
目標:選擇一個已提供的影格預設;一個腳本將其轉換為此影片的 frame.md + 字幕外觀。
當 BRIEF.md 指定了 style_preset — 使用者在意圖層從展示中挑選的 — 則使用它;僅當簡報未指定時,您才需要進行判斷。然後您需要做出一個決定 — 選擇哪個預設:閱讀 ../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 作為字幕外觀來源存在;所選的預設已記錄為偏好(--key style_preset --workflow <此工作流程>,簡報合約 § 2)。
步驟 3:分鏡和腳本
目標:將簡報和捕獲的素材轉化為已核准的逐幀故事計劃。
閱讀 ../hyperframes-creative/references/story-spine.md(鉤子語言、價值先於證據、以提案形式呈現的故事板、有來源可追溯的視覺素材)、references/story-design.md、../hyperframes-animation/blueprints-index.md、../hyperframes/references/storyboard-format.md 和 ../hyperframes/references/script-format.md。使用它們來撰寫 STORYBOARD.md,並在需要旁白時撰寫 SCRIPT.md。將前置資料 duration: 設定為簡報的 length — 一個粗略的期望;組合時會報告最終剪輯與之相比的實際長度。
使用 story-design.md 進行故事藍圖、鉤子、說服邏輯、節拍、VO_MODE 和素材選擇。作為一個軟性指南,請參閱 ../hyperframes-animation/blueprints-index.md 中的角色→藍圖選單:對於每個節拍,當有合適的藍圖時,記下一個候選藍圖 id。故事真相仍然決定哪些節拍存在 — 永遠不要強迫一個節拍去適應一個藍圖,也永遠不要僅僅因為有一個可用的經過驗證的形狀就發明一個節拍。從 capture/extracted/asset-descriptions.md(規範庫存)中選擇每個視覺影格的 asset_candidates — 不要瀏覽原始的 capture/assets/。除非該庫存遺失或不可用,否則不要要求使用者選擇素材。使用來自分鏡和腳本參考文件的確切必填欄位。
草擬後,執行審查循環的計劃階段 — ../hyperframes/references/review-loop.md § 1:將計劃作為提案呈現,並提出兩個問題 — 核准或修改,以及先看草稿(建議)或跳過。反饋以聊天回覆的形式到達;循環直到核准。這是一個檢查點門檻(簡報合約 § 1):在自主模式下,…
[因原始內容截斷,此處為完整翻譯]