製作影片 - 從新手到完成 MP4 的技能
兩個階段,八個順序關卡。每個關卡都會產生一個具體的產物,供下一個關卡使用。不要跳過關卡。
何時使用此技能 - 以及何時轉交
使用此技能時機:
- 使用者是 HyperFrames 新手,從一個概念、劇本或大綱開始
- 他們想要的是完整的逐步解說,而不是框架參考資料
- 他們尚未決定影片格式
轉交時機:
- 使用者貼上一個 URL 並想要從該網站製作影片 → 調用
/website-to-hyperframes - 使用者明確要求製作 9:16 直式、含頭像鏡頭(face-cam)與場景疊加(scene overlays)的談話性影片 → 在此處執行關卡 1–4,然後從關卡 5 開始調用
/short-form-video - 使用者詢問的是框架規則,而不是影片 → 調用
/hyperframes
路由注意事項(AI 編輯影片流程): 當此技能從專案簡報啟動時,編輯提示中的 STYLE DESIGN 和 PHONG CÁCH DỰNG(影片風格)區段會覆蓋下面的訪談預設值 - 請勿 重複詢問簡報中已回答的風格問題。
兩個階段
- 階段 1 - 訪談 (關卡 1–4): 一次對話式的傳遞,旨在觸及程式碼之前 收集所有資訊。包括意圖、格式、劇本、聲音、風格、素材、節奏。將其整合成一份
BRIEF.md並等待明確核准。 - 階段 2 - 建置 (關卡 5–8): 腳手架(scaffold)→ 故事板 → 組合(compositions)→ 程式碼檢查(lint)→ Studio 預覽 → 草稿渲染 → 視覺驗證 → MP4 預覽 → 最終渲染。
關卡 1 · 意圖與格式
透過 AskUserQuestion 一次問一個問題,儘可能使用選擇題。
- 這個影片的用途是什麼?(宣傳 · 社交廣告 · 產品發布預告 · 產品示範 · 教學 · 解說 · 開場/結束卡 · 其他)
- 目標觀眾是誰?(開放式問題)
- 目標時長?(10–20 秒短片 · 20–45 秒廣告 · 45–90 秒解說 · 1.5–3 分鐘課程 · 自訂)
- 長寬比?(16:9 1920×1080 · 9:16 1080×1920 · 1:1 1080×1080)
- 幀率?(30 預設 · 60 用於清晰 UI · 24 電影感)
- 平台 / 傳遞限制?(檔案大小 · 截止日期 · 將在何處播放)
關卡門檻: 六個項目全部捕捉。如果答案是 9:16 + 頭像鏡頭,計劃在關卡 5 轉交給 /short-form-video。
完整的問題庫:Read: references/interview-questions.md
關卡 2 · 劇本與聲音
- 劇本來源?(貼上 · 大綱 → 我來草擬 · 我來錄製 · 從文字轉語音 (TTS) · 無旁白)
- 如果是 TTS:語音偏好。提供來自
npx hyperframes tts --help的選項。也要捕捉語速。hyperframes tts(Kokoro) 僅支援英文 - 越南語旁白需改為系統的/api/tts(Gemini TTS 或 VieNeu)。 - 如果有頭像鏡頭:錄製路徑 · 全螢幕或角落放置 · 需要轉錄嗎?(
npx hyperframes transcribe <file> --model small.en --json- 僅支援英文;越南語請使用 noti-tiktok-vn 技能中的 faster-whisper) - 字幕?(關閉 · 炫目 · 正式 · 逐字卡拉OK · 極簡)
關卡門檻: 已捕捉劇本 (或已草擬)、已捕捉音訊計畫、已捕捉字幕計畫。
關卡 3 · 風格收集
在詢問使用者任何問題之前,先盤點現有素材。 檢查 <workspace-root>/assets/ 和任何專案 assets/ 資料夾。不要詢問已經存在的東西。
然後逐步詢問 - 使用者不需要回答所有這些問題:
- 風格指南或品牌文件?(貼上/路徑 · 沒有)
- 調色盤?(十六進位色碼 · 無 - 使用 MOTION_PHILOSOPHY 預設值)
- 字型?(Google Fonts 名稱 · 檔案路徑 · 無 - 使用 Inter + JetBrains Mono 預設值)
- Logo 檔案?(路徑 · 無). 如果指名了品牌但未提供檔案:在
assets/brand-logos/中尋找,或使用POST /api/brand-logos {"name":"..."}擷取 - 只有在收到404 BRAND_LOGO_NOT_FOUND後才允許使用文字字標。絕不能自行繪製或生成 Logo。 - 參考影片作為風格參考?(URLs/路徑 · 無)
- 其他素材?(螢幕截圖 · 產品照片 · B-roll · 音樂 - 列出路徑)
- MOTION_PHILOSOPHY 美學(黑色畫布 · 金屬字體 · 透視網格 · 鞭子轉場)或不同的感覺?
- 節奏?(快速 1–2 秒 · 平衡 2–3 秒 · 緩慢 3–5 秒)
- 音樂?(無 · 環境音墊 0.15 · 背景音樂 0.4 · 滿音量 0.8 - 如果他們有檔案則提供路徑)
- 結尾 / 行動呼籲文字?
切勿對使用者強加品牌。 僅在使用者明確拒絕提供風格時,才回退到 MOTION_PHILOSOPHY 預設值。
完整的風格流程 + MOTION_PHILOSOPHY 預設值:Read: references/style-intake.md
關卡 4 · 簡報綜合(建置前的硬關卡)
- 讀取
MOTION_PHILOSOPHY.md(如果存在於工作區根目錄)- 如果存在則為強制。如果缺少,則使用references/style-intake.md中的預設值,並在簡報中註明缺失。 - 詢問專案存放位置(如果不明顯):
- 如果存在
video-projects/→ 使用video-projects/<slug>/ - 否則 → 詢問使用者
- 如果存在
- 撰寫
<project-folder>/BRIEF.md:- slug · 意圖 · 目標觀眾 · 尺寸 · fps · 時長
- 劇本(完整或大綱)
- 語音選擇 · 字幕計畫 · 頭像鏡頭計畫
- 風格設定檔:調色盤(hex)、字型、logo 路徑、參考影片
- 節奏
- 素材清單與路徑
- 結尾 / CTA 文字
- 顯示簡報。等待明確核准。 在得到明確的「好的,開始建置」之前,不要進入關卡 5。
關卡 5 · 腳手架與故事板
首先檢查轉交條件
如果簡報描述的是 9:16 直式、含頭像鏡頭與場景疊加的談話性影片,則立即調用 /short-form-video 並移交簡報。其 4 層腳手架專為該格式設計。
否則繼續:
腳手架
mkdir <project-folder>- 如果存在格式相似的相鄰專案,提議複製其
hyperframes.json+meta.json作為模板。否則,在資料夾內執行:npx hyperframes init - 編輯
meta.json,填入使用者的 slug、尺寸、fps。 - 將提供的素材複製到
<project-folder>/assets/。 - 根據關卡 3 建立
<project-folder>/assets/style-profile.md- 作為調色盤/字型/logo 的唯一事實來源。
故事板
使用 references/storyboard-template.md 中的模板生成 <project-folder>/STORYBOARD.md。每個拍子(beat)都會有:
拍子 N - 標題 (開始–結束, 時長) - 一句話概念
視覺元素:[每個元素, 大小, 動畫, 時間]
動態語言:[動態的種類]
使用的緩動函數:[3–4 個不同的 GSAP 緩動函數]
退出:[轉場到下一個拍子]
音訊:[VO 台詞 / SFX / 音樂層]
檔案頂部:一個包含場景 · 開始 · 時長 · 組合(composition)檔案的計時表。
提出一個三幕式結構:
- 第一幕(鉤子)≈ 時長的 20%
- 第二幕(主體)≈ 55%
- 第三幕(收尾 + 含 4–6 秒停留的結尾)≈ 25%
(MOTION_PHILOSOPHY §0 法則 9, §1.)
將使用者意圖對應到目錄區塊: Read: references/catalog-intent-map.md
關卡門檻: 顯示故事板 + 計時表。反覆修改直到使用者核准。
關卡 6 · 建置組合(Compositions)
調用 /hyperframes 以獲取框架規則。此技能負責腳手架和紀律;/hyperframes 負責執行規則。
為每個子組合搭建腳手架
<div data-composition-id="scene-name" data-start="..." data-duration="...">
<style>[data-composition-id="scene-name"] { /* 局部作用域 */ }</style>
<!-- DOM -->
<script>
(function(){
const SLOT_DURATION = ...;
const tl = gsap.timeline({ paused: true });
// ... 補間動畫 ...
tl.to({}, { duration: SLOT_DURATION }, 0); // 錨點 - MOTION_PHILOSOPHY 法則 11
window.__timelines["scene-name"] = tl;
})();
</script>
</div>
完整樣板 + 字幕模式 + 環境背景模式:Read: references/composition-scaffold.md
建置規則
- 環境背景放在
data-track-index="0",持續整個組合的時長。 - 動感文字開場: 逐字間隔 0.06–0.10 秒。
- 字幕作為
index.html中根組合(root composition)的 body 層級兄弟元素,每個帶有data-track-index ≥ 20。絕不能放在場景時間線內(MOTION_PHILOSOPHY §3.13)。 - 目錄區塊透過
npx hyperframes add <name>安裝。立即將該區塊的 CSS 作用域限定在[data-composition-id="..."]- 目錄區塊預設帶有html, body { ... }規則,當作為子組合載入時會滲入父文件。 - 直式 + 頭像鏡頭: 將原生 1920×1080 的臉部用轉換(
translate+scale)包起來,用於下半部或全螢幕模式。(如果你最終來到這裡而不是/short-form-video,請強烈考慮轉交。) - 僅應用使用者提供的內容。 他們的調色盤、他們的字型、他們的 logo。不要注入任何其他東西。如果他們選擇了 MOTION_PHILOSOPHY 預設值,則從
references/style-intake.md中提取調色盤 + 字型配對。
確定性
沒有 Math.random(),沒有 Date.now(),沒有渲染時的 fetch()。使用種子隨機數生成器(seeded PRNGs)或諧波 sin 雜湊(MOTION_PHILOSOPHY §3.10)。
關卡 7 · 程式碼檢查 → Studio 預覽(預覽關卡 1 - 強制)
npx hyperframes lint- 修復所有錯誤,分類警告。- 在背景執行
npx hyperframes preview。 - 等待在
http://localhost:3002上顯示「Studio 正在執行」。 - 將 URL 以及 個別組合的 URL(
http://localhost:3002/?comp=<id>)交給使用者。如果專案包含 WebGL 著色器區塊,請優先提供個別 URL - 軟體 WebGL 回退可能會拖慢主組合。 - 等待明確的「看起來不錯,渲染一個草稿」 然後再繼續。沉默不等於核准。
熱重載已開啟 - 編輯內容會即時顯示。
關卡 8 · 草稿渲染 → 視覺驗證 → MP4 預覽 → 最終
草稿渲染
npx hyperframes render --quality draft --output renders/<slug>-draft.mp4
視覺驗證(傳遞前強制)
程式碼檢查通過 ≠ 設計正常。提取畫面並檢視它們。
mkdir -p renders/frames- 對於每個拍子的關鍵時刻以及每個轉場:
ffmpeg -y -ss <t> -i renders/<slug>-draft.mp4 -frames:v 1 -q:v 2 renders/frames/t<t>.png - 對每個 PNG 調用
Read工具。 Read 工具會將圖像載入上下文 - 不要只是列出檔名。 - 逐幀確認:沒有裁切到臉部、每個場景的臉部模式正確、文字可讀且符合調色盤、沒有溢出、轉場落在預期的文字上、沒有空白幀。
- 如果有任何問題:修正 → 重新渲染 → 重新驗證。絕對不能發布有問題的草稿。
MP4 預覽(預覽關卡 2 - 強制)
npx serve renders -p 8080 -n
請勿使用 Python 的 http.server - 它不支援 HTTP Range 請求,因此會導致進度條拖動失效。
將 http://localhost:8080/<slug>-draft.mp4 交給使用者。等待明確的簽核,確認播放和音訊同步無誤。
最終渲染
npx hyperframes render --quality standard --output renders/<slug>-final.mp4
在 AI 編輯影片流程中,這不是結束:繼續使用 video-pipeline 技能(QC → 透過渲染佇列組合最終版本 → outputs/<id>-v<N>.mp4 → 更新 meta.json → 縮圖/發布)。在流程外獨立使用時:報告輸出路徑。完成。
完整的出發前與交付前檢查清單:Read: references/build-checklist.md
不可妥協的事項(承重牆 - 不可淡化)
- 不要跳過預覽關卡 1(Studio)或預覽關卡 2(已渲染的 MP4)。 每次建置兩個關卡,必做。
- 不要宣稱渲染完成,直到畫面已提取並透過 Read 工具讀取。
- 不要在專屬的專案資料夾之外的地方建置。 絕不能將
index.html放在工作區根目錄。 - 在盤點使用者工作區之前,不要向使用者詢問素材。
- 不要省略每個子組合時間線末尾的
tl.to({}, { duration: SLOT_DURATION }, 0)錨點補間。 MOTION_PHILOSOPHY 法則 11。 - 不要在渲染邏輯中使用
Math.random()/Date.now()。 僅使用種子雜湊。 - 不要為
<video>標籤添加class="clip"。 這會破壞它們。 - 不要對使用者強加品牌。 先詢問;僅在使用者明確拒絕時才回退到 MOTION_PHILOSOPHY 預設值。
參考資料
references/interview-questions.md- 按關卡劃分的完整問題庫references/style-intake.md- 風格訪談 + MOTION_PHILOSOPHY 預設值references/catalog-intent-map.md- "使用者說 X → 安裝 Y"references/storyboard-template.md- 逐拍模板 + 範例references/composition-scaffold.md- 局部作用域樣式 + IIFE GSAP 樣板references/build-checklist.md- 出發前 + 交付前關卡
外部(工作區層級):
MOTION_PHILOSOPHY.md- 此技能假設存在的唯一外部參考。美學基準。如果檔案遺失,備案存在於references/style-intake.md。
相關技能
/hyperframes- 框架規則,在關卡 6 調用/hyperframes-cli- init · lint · preview · render · transcribe · tts/hyperframes-registry- 安裝目錄區塊/gsap- GSAP 動畫參考/short-form-video- 在關卡 5 轉交,用於 9:16 談話性頭像鏡頭格式/website-to-hyperframes- 如果起始輸入是 URL,則在關卡 1 轉交