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 → 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 限時動態、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 技能中) |