media-use: 在獲取音訊/圖片之前,請先呼叫
/media-use以從 HeyGen 目錄中取得背景音樂/音效/圖片。先執行--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)——每個拍子的結構化證據區塊
- 完成定義檢查清單(步驟 6)——包括動畫對應、每個警告的 WCAG 驗證、音訊/動畫播放
- 誠實揭露章節(步驟 6)——「我未驗證的項目」必須出現在你的最終摘要中
如果你發現自己在推理:「自動模式說偏向行動,所以我應該跳過 X」——而 X 是驗證關卡,不是偏好問題——那麼這個推理是錯誤的。偏向行動的原則適用於決定 要建構什麼,而不是決定 是否要驗證。
步驟 0:捕捉與理解品牌
閱讀: references/step-0-capture.md
捕捉網站,然後讀取提取的資料以理解 品牌和產品——它的功能、目標受眾、說話的語氣、以及它所處的氛圍。捕捉到的素材是稍後使用的品牌工具包,而不是構成影片的基礎元件。
在撰寫簡報之前顯示登入狀態——執行 npx hyperframes auth status 並 逐字轉述其輸出(不要改寫或重寫)。 它會回報語音/背景音樂將使用 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。
關卡: 每個 compositions/beat-N.html 都已由主代理根據 DESIGN.md 和 STORYBOARD.md 從頭到尾讀取完畢。每個拍子的檢查清單位於 step-5-build.md。
步驟 6:驗證與交付
閱讀: references/step-6-validate.md
進行 lint、驗證、根據影片長度按比例拍攝快照(公式: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 Stories, 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 技能中) |