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 並如實轉述其輸出(不要改寫或重寫)。 它會報告語音/背景音樂是使用 HeyGen 還是本地引擎,以及當未登入時如何登入。如果未登入,請停止並等待使用者選擇 — 是登入,還是說「繼續」/「離線」以繼續使用本地引擎 — 然後再詢問簡報或其他任何事情。 將其視為一個真正的決策點,而非一個隨意的備註;不要將選擇合併到簡報問題中,也不要將密鑰寫入每個儲存庫的 .env 檔案中。(在自主模式下,記錄狀態並繼續以離線方式進行。)請參閱 ../hyperframes-media → Preflight 以獲取權威指導。
閘門: 已列印網站摘要 — 先在資產/顏色/字型清單之前,以策略為先(產品功能、目標客群、品牌語調);已顯示登入狀態(已登入,或繼續以離線方式進行)。
步驟 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
執行 Lint、驗證、根據影片長度調整比例拍攝快照(公式:max(beats × 3, ceil(duration_seconds / 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 — Lint、驗證、快照(按影片長度調整比例)、預覽 |
| techniques.md | 步驟 3 和 5 — 13 種基本動畫技巧與程式碼模式(改編使用,不要複製貼上) |
| html-in-canvas-patterns.md | 步驟 5 — 用於 Canvas 中 HTML 效果的完整程式碼模式(存在於 hyperframes 技能中) |