media-use: 在尋找音訊/音效/圖片前,請先呼叫
/media-use從 HeyGen 目錄中解決 BGM/SFX/圖片的來源。請先執行--adopt來註冊現有資產。詳見/media-use技能。
網站轉 HyperFrames
抓取一個網站,然後從中產出一支專業影片。
請在步驟 0 之前確認路線。 此技能是爲了一個 一般網站 製作影片。如果使用者真的是要 行銷 / 推出 / 推廣一個產品(即使是從這個網址,即使是「我們網站的宣傳」)→
/product-launch-video。一個 沒有網站的主題解說 →/faceless-explainer;一個 GitHub PR →/pr-to-video;重新剪輯 / 重新調色 / 重新排序一個現有的影片檔案 → 超出範圍。如果使用者含糊地說「製作一個影片」,或者不確定是發布還是一般網站?請先閱讀/hyperframes(完整路由表 + § HyperFrames 無法做到的事)。
使用者會說像這樣的話:
- 「把這個網站變成一支 15 秒的 Instagram 社交短片」
- 「從 https://... 製作一支 30 秒的網站導覽 / 展示影片」
- 「抓取我們的首頁,並用它的視覺元素來構建一支影片」
工作流程有 7 個步驟。每個步驟都會產出一個工件,作為下一步的關卡。預設為協作模式 — 標示 💬 的關卡會停下來詢問使用者。如果使用者表示要採用自動模式(「幫我決定」、「給我驚喜」),則 💬 使用者偏好關卡會被跳過;詳見 step-2-brief.md 了解如何傳播。
自動模式並非「跳過所有關卡」。 自動模式涵蓋使用者偏好問題(TTS 提供商、語音、顏色強調、節拍數量、是否使用音樂、是否使用字幕 — 由代理人代為決定)。它不涵蓋品質驗證關卡。以下項目在自動模式下仍不可跳過:
- 資產審計(步驟 3)— 查看連絡表並為每個資產說明使用/跳過的理由
- 逐拍 HTML 讀取(步驟 5)— 每個拍子需有結構化的證據區塊
- DoD 檢查清單(步驟 6)— 包含動畫對應圖、逐項 WCAG 驗證、音訊/動態播放
- 誠實揭露部分(步驟 6)— 你的最終總結中必須包含「我未驗證的項目」
如果你覺得自己正在推理「自動模式偏向行動,所以我要跳過 X」— 而且 X 是驗證關卡,不是偏好問題 — 那麼這個推理是錯誤的。偏向行動適用於決定 要建構什麼,而不是決定 是否要驗證。
步驟 0:抓取與了解品牌
閱讀: references/step-0-capture.md
抓取網站,然後閱讀提取的資料來了解 品牌和產品 — 它做什麼、為誰而做、用什麼語氣說話、處於什麼氛圍。提取的資產是後續的品牌工具包,而不是影片的建構元件。
在簡報前顯示登入狀態 — 執行 npx hyperframes auth status 並 逐字轉達其輸出(不要改寫或重述)。 它會報告語音/BGM 將使用 HeyGen 還是本地引擎,以及當未登入時如何登入。如果未登入,請停止並等待使用者選擇 — 登入,或說「go」/「offline」以繼續使用本地引擎 — 然後再詢問簡報或其他事情。 將其視為一個真正的決策點,而非一個備註;不要將這個選擇混合到簡報問題中,也不要將金鑰寫入倉庫特定的 .env 檔案中。(在自動模式下,記錄狀態並以離線模式繼續。)請參閱 ../hyperframes-media → 預檢以獲取官方指南。
關卡: 已列印網站摘要 — 先策略(產品做什麼、為誰而做、品牌語氣)再列出資產/顏色/字型庫存;已顯示登入狀態(已登入,或繼續離線)。
步驟 1:品牌識別
閱讀: references/step-1-design.md
撰寫 DESIGN.md — 一個品牌備忘單,涵蓋視覺識別:顏色、字體排印、元件樣式、佈局原則。使用 design-styles.json 獲取精確的計算值。
速度選項: 對於快速節奏的影片(每個拍子一個廣告看板),DESIGN.md 可以是一份 50 行的顏色 + 字型 + 注意事項摘要 — 而不是一份 300 行的文件。步驟 5 的子代理人提示會直接貼上品牌價值,因此 DESIGN.md 的深度僅對複雜構圖重要。
關卡: DESIGN.md 存在(任何長度)且至少包含:顏色調色盤、字型選擇、以及注意事項。
步驟 2:策略與訊息傳遞
閱讀: references/step-2-brief.md, references/capabilities.md(掃描目錄 — 深度章節僅在需要時閱讀)
在討論視覺或資產之前,先與使用者對齊 影片必須傳達的訊息。解析使用者的提示 — 他們很可能已經告訴你影片類型和風格。只詢問缺少的部分:這支影片必須說的「一句話」、敘事弧線、以及目標觀眾。
關卡: 影片類型、時長、格式、以及 — 關鍵地 — 訊息和敘事弧線都已被鎖定。沒有這些,步驟 3 無法撰寫以概念為先的分鏡腳本。
步驟 3:分鏡腳本 + 腳本 💬
閱讀: references/step-3-storyboard.md
以概念為先撰寫分鏡腳本:訊息 → 敘事弧線 → 服務於弧線的拍子 → 每個拍子的技術 → 最後的品牌強調處理。然後撰寫匹配的旁白腳本。向使用者呈現兩者,並附上逐拍摘要。不斷修改直到他們批准。
關卡: STORYBOARD.md + SCRIPT.md 存在 且 使用者已批准該計劃。
步驟 4:配音、計時 + 字幕 💬
如果步驟 2 說不要旁白 — 詢問背景音樂,然後跳到步驟 5。否則:詢問使用者要使用哪個 TTS 提供商(HeyGen TTS、ElevenLabs 或 Kokoro),生成音訊,進行轉錄,將時間戳對應到拍子。然後詢問字幕。
關卡: (a) 沒有要求旁白且分鏡腳本有手動拍子計時,或 (b) narration.wav + transcript.json 存在且拍子計時已用實際時長更新。
步驟 5:建構構圖
閱讀: hyperframes 技能(載入它 — 每個規則都很重要)
閱讀: references/step-5-build.md
根據步驟 3 分鏡腳本中選擇的架構和節奏,建構 index.html 和構圖文件。子代理人在每個拍子上執行 hyperframes lint 和 hyperframes snapshot,然後回報。
關卡: 每個 compositions/beat-N.html 都已由主要代理人根據 DESIGN.md 和 STORYBOARD.md 從頭到尾讀取過。逐拍檢查清單位於 step-5-build.md。
步驟 6:驗證與交付
閱讀: references/step-6-validate.md
進行語法檢查、驗證、根據影片長度調整快照數量(公式:max(拍子數 × 3, ceil(秒數 / 2))),並逐一審查。在交付前修復問題。交付 localhost Studio 專案 URL — 僅在使用者明確要求時才渲染為 MP4。僅在交接時 提供該 Studio URL — 它是最終的、穩定的預覽;建置階段的快照是無頭的,所以不要在構建中途彈出預覽。
交付一個你會引以為傲的成品。 在交接前,問問自己:我會把這個貼到社交媒體上並署上我的名字嗎?如果不會,請修正問題。
關卡: npx hyperframes lint 和 npx hyperframes validate 通過且零錯誤,並且最終回覆中包含有效的 Studio 專案 URL。
快速參考
影片類型
各影片類型的典型限制 — 作為起點,而非公式。拍子數量應根據內容和旁白來決定,而不是根據目標範圍。
| 類型 | 典型時長 | 時長驅動因素 | 旁白 |
|---|---|---|---|
| 社交廣告 (IG/TikTok) | 10–15 秒 | 平台限制 | 可選 |
| 產品示範 | 30–60 秒 | 腳本長度 | 完整旁白 |
| 功能發佈公告 | 15–30 秒 | 功能複雜度 | 完整旁白 |
| 品牌形象片 | 20–45 秒 | 音樂曲目 | 可選,音樂為主 |
| 上市預告片 | 10–20 秒 | 鉤子能量 | 最少 |
此表中刻意不列出拍子數量 — 它應該來自分鏡腳本,而不是來自「社交廣告 = 3-4 拍」。一個針對複雜產品的社交廣告可能需要 5 個精心計時的拍子。一個只有一個強烈視覺論述的品牌形象片可能只需要 3 拍。
格式
- 橫向:1920x1080(預設)
- 直向:1080x1920(Instagram 限時動態、TikTok)
- 方形:1080x1080(Instagram 動態牆)
參考檔案
| 檔案 | 閱讀時機 |
|---|---|
| step-0-capture.md | 步驟 0 — 抓取、了解品牌與產品、撰寫策略優先的網站摘要 |
| step-1-design.md | 步驟 1 — 撰寫 DESIGN.md 品牌備忘單(5 個章節,250-350 行;針對廣告看板風格的社交廣告可用 50 行快速路徑) |
| step-2-brief.md | 步驟 2 — 與使用者對齊訊息、敘事弧線、目標觀眾 |
| capabilities.md | 步驟 2 和 5 — HyperFrames 能力的完整清單(24 個章節)。在簡報期間掃描目錄,在構建期間深入特定章節 |
| step-3-storyboard.md | 步驟 3 — 分鏡腳本 + 腳本(合併)以及使用者審查關卡 |
| step-4-vo.md | 步驟 4 — TTS 提供商選擇、生成、計時 |
| step-5-build.md | 步驟 5 — 建構 index.html + 構圖文件 |
| step-6-validate.md | 步驟 6 — 語法檢查、驗證、快照(根據影片長度調整)、預覽 |
| techniques.md | 步驟 3 和 5 — 13 種基本動畫技術及程式碼模式(採用,不要複製貼上) |
| html-in-canvas-patterns.md | 步驟 5 — HTML 嵌入 Canvas 效果的完整程式碼模式(位於 hyperframes 技能中) |