media-use:在獲取音訊/音效前,請先呼叫
/media-use以從 HeyGen 目錄中取得 BGM/音效/圖片。先執行--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 → 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。
關卡: 主代理已根據 DESIGN.md 和 STORYBOARD.md 從頭到尾閱讀每個 compositions/beat-N.html。逐拍檢查清單位於 step-5-build.md 中。
第 6 步:驗證與交付
閱讀: references/step-6-validate.md
進行 Lint、驗證、根據影片長度拍攝縮圖(公式:max(節拍數 × 3, ceil(時長_秒 / 2))),並逐一審查。在交付前修復問題。交付 localhost Studio 專案網址 —— 僅在使用者明確要求時才渲染成 MP4。僅在交接時才提供 Studio 網址 —— 它是最終的穩定預覽;建構階段的縮圖是無頭的,所以不要在構建過程中彈出預覽。
交付一份讓你自豪的作品。 在交接前,捫心自問:我會把這個貼在社交媒體上並署上我的名字嗎?如果不會,那就修正問題。
關卡: npx hyperframes lint 和 npx hyperframes validate 以零錯誤通過,且最終回應包含活躍的 Studio 專案網址。
快速參考
影片類型
依影片類型劃分的典型限制 —— 作為起點,而非公式。節拍數應來自於內容和旁白,而非來自目標範圍。
| 類型 | 典型時長 | 時長驅動因素 | 旁白 |
|---|---|---|---|
| 社交廣告(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 步 —— 用於 HTML-in-Canvas 效果的完整程式碼模式(位於 hyperframes 技能中) |