general-video — 通用合成創作
在開始建構前,請先確認路線。 此為自訂合成創作的後備方案。若輸入內容明顯適合某個專門工作流程,請優先使用:行銷產品 →
/product-launch-video;一般網站 →/website-to-video;主題解說 →/faceless-explainer;GitHub PR →/pr-to-video;現有片段 →/embedded-captions·/graphic-overlays;簡短無旁自動畫 →/motion-graphics;Remotion 遷移 →/remotion-to-hyperframes。超出範圍:即時/渲染時資料、對完成影片進行 NLE 風格剪輯,或製作 HyperFrames 無法捕捉的片段。不確定?請先閱讀/hyperframes。
嚴格按照要求建構。 標題卡就是標題卡 — 不是標題卡 + 三個輔助場景 + 環境音樂 + 字幕。如果額外的場景或元素能確實提升作品品質,請_提議_加入;但不要默默添加。對於小型編輯(修正顏色、調整一個持續時間、新增一個元素),請跳過規劃步驟,直接進入建構階段。
方法
發現階段 — 僅限開放式請求
對於模糊、探索性的請求(「為我們的品牌做點東西」、「一個酷炫的開場」)— 在選擇顏色之前,先了解意圖:
- 觀眾 — 誰會觀看?開發人員 / 高階主管 / 一般消費者?
- 平台 — 在哪裡播放?社群(15秒)/ 網站主視覺 / 產品示範 / 內部使用?
- 優先級 — 哪個最重要?動畫品質 / 內容準確性 / 品牌忠誠度 / 速度?
- 變化版本 — 要一個最佳版本,還是 2-3 個有意義的不同選項(不同的節奏、能量或結構 — 而不僅僅是換色)?
對於具體請求(「加入一個標題卡」、「修正場景 3 的時間點」),請跳過發現階段。
步驟 1 — 設計系統 → hyperframes-creative
首先建立視覺識別。如果專案有設計規範,請閱讀它(優先順序 frame.md → design.md → DESIGN.md;將其視為品牌真相 — 確切的顏色、字體、限制)。
如果沒有設計規範,在選擇任何顏色或字體之前,你必須閱讀「兩者」:hyperframes-creative/references/house-style.md 和 hyperframes-creative/references/video-composition.md。 house-style.md 提供了解釋提示/產生真實內容的開場、懶惰預設列表和圖層配方;video-composition.md 則提供了影片媒介的密度/規模/前景細節化(資料條、註冊標記、等寬字體後設資料、「8-10 個元素,其中兩個使用者沒要求的」),這正是區分「製作完成」與「產生出來」的關鍵。只閱讀其中一個是最常見的遺漏 — video-composition.md 正是代理(agents)會跳過的那個,而它正是防止產生扁平、置中、看起來像網頁的輸出的關鍵。不要自己發明色版並跳過這些步驟;進入 hyperframes-creative 這裡是強制性的,而不是可選分支。接著,根據需要,從中提取一個命名的風格/氛圍 → references/visual-styles.md,或互動式選擇器 → references/design-picker.md。設計規範/風格定義的是品牌,而不是構圖規則。
找出切入點(模糊簡報,無規範): 在選擇顏色之前,寫「一句話」— 這個名字/詞彙/主題會喚起什麼,以及哪個視覺世界(隱喻、場景、工具、動機)能表達它?例如:一個網路安全工具 → 保險庫門 / 周界掃描線 / 鎖頭;一個冥想應用程式 → 潮汐、呼吸、緩慢的光暈。閱讀主題的_含義_,而不僅僅是其文字;選擇一個具體的切入點,而不是字面上的重新設計。這是在單場景作品中,對提示擴充(步驟 2)的廉價替代方案(擴充在此處應被正確地跳過)— 也是設計概念與通用標誌加漸層背景之間的差異。
步驟 2 — 提示擴充 → hyperframes-creative
每個多場景構圖都需執行(單場景作品和瑣碎編輯則跳過)。將請求與設計規範 + 內部風格相結合,轉化為一個一致的中間表示,使下游工作能以相同方式讀取。請參閱 hyperframes-creative/references/prompt-expansion.md。
步驟 3 — 規劃
在編寫 HTML 之前,先進行高層次思考:
- 內容 — 觀眾體驗:敘事弧、關鍵時刻、情感節奏。
- 結構 — 多少個構圖、子構圖 vs 內聯、哪些軌道承載影片/音訊/疊加層/字幕。關於單一檔案 vs 模組化子構圖的抉擇,請參閱
hyperframes-core/references/composition-patterns.md的 § 兩種架構(經驗法則:≥3 個硬切場景,或任何重複使用的場景 → 模組化;一個短的單場景作品保持一個檔案)。 - 節奏 — 在實作之前先命名模式(例如
fast-fast-SLOW-SHADER-hold);請參閱hyperframes-creative/references/beat-direction.md。 - 時間點 — 哪個剪輯片段驅動持續時間、轉場落在哪裡、節奏為何。
- 佈局 — 先建構最終狀態(見下文)。
- 動畫 — 然後透過
hyperframes-animation加入動態。
先佈局,後動畫
將每個元素放置在其最顯眼的時刻所在的位置 — 完全進入、正確放置、尚未退出。先將其編寫為靜態 HTML + CSS。尚不需要 GSAP。
原因: 如果你將元素放置在它們的動畫起始狀態(畫面外、縮放到 0、透明度 0)並補間到你_認為_它們會到達的位置,那你就是在猜測最終佈局 — 重疊部分在渲染之前都會保持不可見。先建構最終狀態,你就能在加入動畫之前看到並修正佈局問題。
- 為每個場景找出主畫面 — 最多元素同時可見的時刻。這就是你要建構的佈局。
- 為該畫面編寫靜態 CSS。內容容器必須使用內邊距(padding)來填滿場景,而不是絕對偏移:
.scene-content {
display: flex;
flex-direction: column;
justify-content: center;
width: 100%;
height: 100%;
padding: 120px 160px; /* padding 定位內容;可填滿任何場景大小 */
gap: 24px;
box-sizing: border-box;
}
永遠不要對內容容器使用 position: absolute; top: Npx — 當內容比空間高時,它會溢出。保留絕對定位給裝飾性元素。
⚠ 上述的
width/height: 100%只有在每個祖先元素都有已解析的高度時才有效。 根元素<div data-composition-id>以及它與.scene-content之間的任何包裝元素都必須設定尺寸(在根元素上設定position: relative; width: 1920px; height: 1080px— 請參閱hyperframes-core→ “Root must be sized”)。跳過這個步驟,flex 容器會收縮到大約 0,內容會堆疊在左上角,第一個字元會在 x=0 處被裁剪 — 而lint/inspect仍然報告 0 個問題。並且永遠在.scene-content上保持padding(≥80px):它是標題安全邊距。永遠不要用單純的gap來取代它。
- 添加入場動畫 — 使用
gsap.from()從畫面外/隱藏狀態動畫到 CSS 位置(在子構圖中,偏好使用gsap.fromTo()以使起始狀態明確;請參閱hyperframes-core/references/sub-compositions.md)。CSS 位置是基本事實;補間是到達目標的旅程。 - 退場由轉場處理 — 根據
hyperframes-animation/transitions/中的場景轉場規則,只有最終場景會將元素動畫移出;場景之間的轉場本身就是退場。
跨時間的共享空間: 如果元素 A 在元素 B 進入同一區域之前退場,兩者仍然需要在其各自的關鍵畫面中有正確的 CSS 位置 — 時間軸排序確保它們不會共存,而佈局步驟則能捕捉無意的重疊。分層光暈/陰影和 z 軸堆疊深度是_有意的_重疊;這個步驟的目的是捕捉_無意的_碰撞(兩個標題疊在一起、內容溢出畫面)。
建構 — 委派給領域技能
此圖表映射了此技能的完整範圍(請參閱 description)到其參考資料 — 非詳盡列表;當意圖未列出時,請透過 hyperframes-creative(外觀/概念)、hyperframes-animation(動態)、hyperframes-core(合約)、hyperframes-media(音訊/字幕)進行路由。第一行是附加的 — 請閱讀它 AND 你的意圖行,而不是二選一。
| 建構… | 優先閱讀(按順序) |
|---|---|
| 總是 — 每個非瑣碎的作品,加上你下方的意圖行 | hyperframes-creative/references/house-style.md + references/video-composition.md(也已在步驟 1 / 硬性門檻中設定;這是「製作完成,而非產生出來」的前景細節化) |
| 動態文字排版 / 文字為主 | hyperframes-animation/techniques.md(動態文字)+ adapters/gsap-easing-and-stagger.md + rules/kinetic-beat-slam.md |
| 標題卡 / 下方三分之一 / 疊加層 / PiP / 主體後文字 | hyperframes-creative/references/composition-patterns.md +(對於置中/已設定尺寸的畫面)hyperframes-core → “Root must be sized” |
| 標誌 / 品牌標記揭示 | hyperframes-animation/rules/svg-path-draw.md(繪製)+ rules/3d-text-depth-layers.md + rules/scale-swap-transition.md |
| 資料 / 統計 / 數字 | hyperframes-animation/rules/counting-dynamic-scale.md + rules/stat-bars-and-fills.md + hyperframes-creative/references/data-in-motion.md |
| 產品 / 應用程式 / UI 示範 | hyperframes-animation/rules/3d-page-scroll.md + rules/cursor-click-ripple.md + rules/press-release-spring.md |
| 音訊反應 / 音樂驅動 | hyperframes-creative/references/audio-reactive.md(預先提取頻段;對應到動畫) |
| 旁白 / 配音 / 字幕 / 隱藏字幕 | hyperframes-media(tts、transcribe、字幕創作)→ 透過 hyperframes-core 放置素材 |
| 多場景 / 轉場 | hyperframes-animation/transitions/overview.md 然後 transitions/catalog.md(閱讀概覽後還沒結束 — GSAP 配方在目錄中) |
| 模組化 / 子構圖 | hyperframes-core/references/composition-patterns.md + references/sub-compositions.md |
輸出檢查清單 → hyperframes-cli
-
npx hyperframes lint和npx hyperframes validate通過(阻止結果) - 若存在設計規範(
frame.md/design.md),則驗證設計遵循度 — 檢查清單在hyperframes-creative/references/design-adherence.md -
npx hyperframes inspect通過,或每個溢出都被有意標記 - 處理對比度警告;對於多場景作品,檢閱動畫對應表(
hyperframes-animation/scripts/animation-map.mjs) - 交付預覽;僅在明確要求時才渲染為 MP4
- 僅在交接時呈現預覽(這是最終穩定的預覽);不要在構建過程中彈出預覽 — 構建階段的快照不應顯示
不屬於此工作流程
- 正在行銷、發布或推廣的特定產品 / 公司 / SaaS / 網站 →
/product-launch-video - 正在解說的概念 / 主題 / 文章 / 如何運作,無關產品 →
/faceless-explainer - GitHub PR / 程式碼變更 →
/pr-to-video - 要添加字幕的現有談話頭影片 →
/embedded-captions - 移植現有的 Remotion 構圖 →
/remotion-to-hyperframes - 像 NLE 一樣剪輯/編輯完成的影片檔案 → 超出範圍(HyperFrames 將 HTML 和媒體組合成一個確定性的時間軸;它不編輯片段)