外掛安裝: 在執行設定或更新命令之前,當此技能位於 HyperFrames 外掛內部時,請遵循外掛執行規則。獨立安裝則保留下列更新指示。
首先,保持此技能為最新版本 — 請先與使用者確認後再執行:
npx hyperframes skills update product-launch-video。如果一切已是最新,則快速無操作;否則,它會在使用者依賴此技能及相關核心領域技能之前,更新它們。
media-use: 在取得音訊/圖片/標誌之前,請呼叫
/media-use以從 HeyGen 目錄解析 BGM/SFX/圖片,並從官方來源取得品牌標誌。先執行--adopt以註冊現有資產。請參閱/media-use技能。
figma source: 如果來源是 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(您為每一幀分派一個子代理),請親自執行每個步驟。不要在此放置設計或動畫規則;這些規則位於幀工作子代理、此技能的本地 ../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 或輸出檔案。
在 init 之後立即寫入 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 § 提供者。
關卡: 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 <milliseconds>,為下游工作留出時間。--timeout 僅控制頁面導航。僅當可選的圖片標題被故意停用時,才使用 --skip-vision。
立即檢查命令結果和輸出目錄。非零退出、JSON ok: false 或 capture/BLOCKED.md 是捕捉路徑的硬停:報告記錄的原因,不要使用部分螢幕截圖、DOM、代幣或資產。在 URL 捕捉失敗後,不要製造一個合成的無捕捉後備方案。僅當原始簡報提供了來源材料,或者使用者明確在失敗後切換到提供的螢幕截圖或簡報時,才繼續使用無捕捉路徑。
像是「文字內容非常少」這類警告,同時資產目錄為空,並不能證明頁面可用。對於網站導覽或如實呈現的簡報,需要可信的捕捉結構或提供的螢幕截圖;如果兩者都不存在,請停止。不要僅僅因為捕捉不可用就發明或重建頁面。
對於網站導覽或如實呈現的簡報,捕捉的頁面是視覺真相來源。使用真實的螢幕截圖,而不是在 HTML 中重建完整的網站。如果鏡頭需要內部移動,請將螢幕截圖作為基底,並在測量好的位置疊加真實的捕捉資產,或僅重建移動的元件。對於滾動截圖,在 capture/screenshots/full-page.png 上對視口進行動畫處理 — 這是整個文檔的 1x 圖板,像素精確地用於在其上移動的 1920 寬視口。當頁面太高無法一次捕捉時,它會缺失;改為使用同一目錄中重疊的滾動位置截圖。當推入超過 1:1 時,需要該區域自身的 2x 捕捉,因為圖板沒有超過 1x 的餘量。僅當使用者明確要求風格化解釋時,才重建整個頁面;不可用的捕捉本身並不是授權。
如果存在 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。從簡報的 length 設定前置設定的 duration: — 這是一個粗略的期望;組裝報告會說明最終剪輯與其的對比。
使用 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):在自主模式下,您可以繼續到步驟 4/5 中的一個節奏試映,但必須在進入步驟 6 最終渲染之前收到批准。在協作模式下,在此處等待明確的批准。
如果簡報要求旁白,則建立 audio_meta.json。
關卡: STORYBOARD.md 存在且完整(所有必要的欄位已填充);SCRIPT.md 在需要時存在;計畫已獲得批准或已獲得開始試映的授權。
步驟 4:視覺設計
目標:將批准的STORYBOARD.md 轉變為最終的視覺設計,包括每一幀的佈局、樣式和資產指定。
閱讀 ../hyperframes-creative/references/visual-design-rules.md。每幀現在都應指定其精確的視覺元素:背景(螢幕截圖、純色、漸層、影片)、文字疊加、按鈕、圖示、過渡效果,以及與 frame.md 中定義的設計系統連結。使用 capture/extracted/asset-descriptions.md 作為資產選擇的權威來源。
此步驟的輸出是一個增強的 STORYBOARD.md,其中 frame_design 部分已完全填充。如果「先看草圖」在步驟 3 中被批准,建立一個或多個概念驗證 HTML 草稿來展示關鍵畫面的視覺方向;獲得批准後,將其納入最終的幀設計。
關卡: 增強的 STORYBOARD.md 存在,所有 frame_design 條目都已填充;如果適用,草圖已獲得批准。
步驟 5:建構幀
目標:將每幀的設計實現為獨立的 HTML 檔案,準備進行動畫和組裝。
對於 STORYBOARD.md 中的每一幀,分派一個子代理,為該特定幀產生一個 HTML 檔案。子代理使用 frame.md 作為全域設計系統,並使用 STORYBOARD.md 中該幀的 frame_design 作為具體實作指南。子代理在 compositions/frames/NN-<slug>.html 中輸出其工作,其中 NN 是幀號(零填充)。
閱讀 ../hyperframes-animation/rules/ 和 ../hyperframes-animation/blueprints/ 以了解可用的動畫模式和實作規則。閱讀 compositions/ 以了解如何將所有已完成的幀組合成一個交互式預覽。
確保每個 HTML 檔案都是獨立的(但可以從 frame.md 載入共享的 CSS/JS),並且遵循 HyperFrames 動畫約定。在每一幀中對文字和按鈕使用 .hyperframes/caption-skin.html 中定義的字幕外觀。
關卡: 每個在 STORYBOARD.md 中定義的幀在 compositions/frames/ 中都有一個對應的 HTML 檔案;compositions/index.html 存在並正確地包含所有幀。
步驟 6:最終渲染
目標:將所有組合幀渲染為最終的影片檔案。
執行渲染命令:npx hyperframes render --input compositions/index.html --output renders/video.mp4。在渲染之前,如果需要,請與使用者確認最終的創意方向。這是第二個檢查點關卡。
關卡: renders/video.mp4 存在;使用者已批准最終輸出,或自主模式已繼續。