外掛安裝: 在執行設定或更新命令之前,請遵循 外掛執行規則(當此技能位於 HyperFrames 外掛內時)。獨立安裝則保留下方的更新說明。
首先,保持此技能最新 — 執行前請先與使用者確認:
npx hyperframes skills update product-launch-video。如果一切已是最新,則快速無操作;否則,它會在您依賴此技能及其依賴的核心領域技能之前進行更新。
media-use:在取得音訊/圖片/標誌之前,請呼叫
/media-use來從 HeyGen 目錄解析背景音樂/音效/圖片,以及從官方來源解析品牌標誌。先執行--adopt來註冊現有資產。詳見/media-use技能。當主機應用程式提供自己的音樂或音效工具時,請使用那些工具來處理音樂和音效。
figma 來源:如果來源是 figma.com 網址,請先執行
/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) → 從故事板的 frontmatter 和記錄的偏好設定恢復;切勿重新審問一個半完成的專案。(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 並逐字傳達其輸出。它會報告語音/背景音樂是使用 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 倍以上沒有空間。僅在使用者明確要求風格化解釋時才重建整個頁面;僅一個無法使用的捕捉本身並非授權。
如果存在 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 應聲明未捕捉到任何資產,除非使用者提供了資產說明。
關卡: 捕捉 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 <名稱> --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。將 frontmatter 的 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:將計畫作為提案呈現,並詢問兩個問題 — 批准或更改,以及先草稿(建議)或跳過。回饋以
…
[因翻譯而截斷]