首先,保持此技能最新——靜默執行,無需詢問:
npx hyperframes skills update general-video。若一切為最新狀態則快速無操作;否則會在使用前更新此技能及其依賴的核心領域技能。
media-use:在使用音訊/圖片/標誌前,請呼叫
/media-use從 HeyGen 目錄解析 BGM/SFX/圖片,並從官方來源解析品牌標誌。先執行--adopt註冊現有資產。請參閱/media-use技能。
figma source:若輸入包含 figma.com URL,請先執行
/figma——視需要匯出資產、品牌權杖及元件/分鏡重建——然後再根據其輸出進行建構。請勿直接透過原始 MCP 工具驅動 Figma:這會繞過 SVG 清理、.media/manifest.jsonl來源追溯和品牌權杖var()繫結,導致後續品牌變更無法傳播,除非完全重新匯入。
general-video——一般影片工作流程
建構前請確認路線。 這是用於自訂組合創作的備用方案。若輸入明顯符合特定工作流程,請優先使用:已上市的產品→
/product-launch-video;一般網站→/website-to-video;主題解說→/faceless-explainer;GitHub PR→/pr-to-video;現有素材→/embedded-captions·/talking-head-recut;短無旁白動態圖形→/motion-graphics;Remotion 移植→/remotion-to-hyperframes。不適用範圍:即時/渲染時資料、對已完成影片進行 NLE 風格的剪輯,或產生 HyperFrames 無法捕捉的素材。不確定?請先閱讀/hyperframes。
只建構要求的內容。 標題卡片就是標題卡片——不是標題卡片加三個輔助場景、背景音樂和字幕。若額外的場景或元素確實能改善作品,_請建議_它們;不要默默新增。對於小修改(修正顏色、調整一個時長、新增一個元素),請跳過規劃步驟直接進入建構。
方法
發現——僅限開放式請求
對於模糊、探索性的請求(「為我們的品牌製作點東西」、「一個酷炫的開場」)——在選擇顏色前先了解意圖:
- 受眾——誰會觀看?開發者/高階主管/一般消費者?
- 平台——在哪裡播放?社群媒體(15 秒)/網站首頁/產品展示/內部?
- 優先級——什麼最重要?動畫品質/內容準確性/品牌忠誠度/速度?
- 變體——一個最佳版本,還是 2-3 個有意義的不同選項(不同的節奏、能量或結構——而不僅僅是顏色變換)?
對於特定請求(「新增一個標題卡片」、「修正場景 3 的時間」),跳過發現階段。若請求帶有持續性的自主訊號(「讓我有驚喜」、「直接建構」——hyperframes-core/references/brief-contract.md § 1),也跳過發現階段:預設為一個最佳版本,並在做出決策時用一句話說明。
步驟 1——設計系統 → hyperframes-creative
首先建立視覺識別。若專案有設計規格,請閱讀它(優先順序 frame.md → design.md → DESIGN.md;將其視為品牌真理——確切的顏色、字體、限制)。
若無規格,則在選擇任何顏色或字體前,必須閱讀 BOTH hyperframes-creative/references/house-style.md AND hyperframes-creative/references/video-composition.md。 house-style.md 提供了「解讀提示 / 產生真實內容」的開場、懶惰預設列表和圖層配方;video-composition.md 提供了影片媒介的密度/比例/前景細節(資料條、註冊標記、等寬字體元資料、「8-10 個元素,其中兩個是使用者未要求的」),這區分了「精心製作」與「隨意產生」。只讀其中一個是最常見的失誤——video-composition.md 正是代理程式會跳過的那個,而它正是防止產生扁平、居中、網頁風格輸出的關鍵。不要自行發明調色板並跳過這些步驟;進入 hyperframes-creative 是強制性的,而不是可選分支。從那裡,視需要提取一個具名風格/情緒 → references/visual-styles.md,或互動式挑選器 → references/design-picker.md。規格/風格定義的是品牌,而不是構圖規則。
找到角度(模糊簡報,無規格): 在選擇顏色之前,寫一句話——這個名稱/詞彙/主題喚起什麼,以及有什麼視覺_世界_(隱喻、場景、工具、動機)能表達它?例如:一個網路安全工具→金庫門 / 周界掃描線 / 鎖芯;一個冥想應用程式→潮汐、呼吸、緩慢的光暈。閱讀主題的_意義_,而不僅僅是它的文字;選擇一個具體的角度,而不是字面上的重新造型。對於單場景作品,這是提示擴展(步驟 2)的廉價替代方案,因為在單場景中擴展會被正確跳過——而這正是設計概念與通用背景圖標的區別。
步驟 2——提示擴展 → hyperframes-creative
對每個多場景構圖執行(單場景作品和瑣碎修改跳過)。將請求與設計規格和風格指南結合,轉化為一致的 intermediate,使下游工作能以相同方式讀取。請參閱 hyperframes-creative/references/prompt-expansion.md。
步驟 3——規劃
在撰寫 HTML 之前,從高層次思考:
- 什麼——觀眾體驗:敘事弧、關鍵時刻、情緒起伏。對於有旁白的故事性作品,遵循
hyperframes-creative/references/story-spine.md——以觀眾結果的語言吸引注意,在節拍 2 之前傳達訊息,之後提供證據。 - 結構——多少個構圖、子構圖與內聯、哪些軌道承載影片/音訊/疊加層/字幕。關於單一檔案與模組化子構圖的選擇,請參閱
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。內容容器必須以內邊距填滿場景,而不是使用絕對偏移:
.scene-content {
display: flex;
flex-direction: column;
justify-content: center;
width: 100%;
height: 100%;
padding: 120px 160px; /* 內邊距定位內容;填滿任何場景大小 */
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→「根元素必須設定大小」)。錯過這一步,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 軸堆疊深度是_有意的_重疊;此步驟的目的是捕捉_無意的_碰撞(兩個標題重疊、內容溢出畫面)。
建構——委託給領域技能
此表格映射技能的全部範圍(參見「描述」)到其參考資料——非詳盡列表;當意圖未列出時,透過 hyperframes-creative(外觀/概念)、hyperframes-animation(運動)、hyperframes-core(合約)、media-use(音訊/字幕)路由。第一行是附加的——同時閱讀它和您的意圖行,而不是只選一個。
| 建構內容… | 優先閱讀(按順序) |
|---|---|
| 始終——每個非瑣碎的作品,除了下方的意圖行 | hyperframes-creative/references/house-style.md + references/video-composition.md(也在步驟 1 / HARD-GATE 中設為關卡;「精心製作,而非隨意產生」的前景細節) |
| 動態文字排版 / 文字導向 | hyperframes-animation/techniques.md(動態文字) + adapters/gsap-easing-and-stagger.md + rules/kinetic-beat-slam.md |
| 標題卡片 / 下方三分之一 / 疊加層 / PiP / 文字後方主體 | hyperframes-creative/references/composition-patterns.md +(對於居中/尺寸化的畫面)hyperframes-core →「根元素必須設定大小」 |
| 標誌 / 品牌標誌揭示 | 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(預先提取頻段;映射到運動) |
| 旁白 / 語音 / 音樂 / 音效 / 字幕 | media-use → 共享音訊引擎 scripts/audio.mjs(一次呼叫 = TTS + BGM + SFX → audio_meta.json);透過 hyperframes-core 進行字幕創作和資產放置。請參閱下方的音訊。 |
| 多場景 / 轉場 | hyperframes-animation/transitions/overview.md 然後 transitions/catalog.md(閱讀概述後並未完成——GSAP 配方在目錄中) |
| 模組化 / 子構圖 | hyperframes-core/references/composition-patterns.md + references/sub-compositions.md |
音訊:單一引擎(TTS · BGM · SFX)
僅在作品需要時使用(根據「只建構要求的內容」——不要在標題卡片上添加背景音樂)。不要自行製作 TTS 或採購副本:撰寫一個中性的 audio_request.json 並呼叫 media-use 中的共享引擎。它會根據一個開關自動降級——HeyGen 憑證存在 → HeyGen TTS + 音樂/SFX 檢索;不存在 → ElevenLabs/Kokoro TTS、Lyria/MusicGen BGM 產生,以及捆綁的 SFX 庫。完整的標誌列表 + 請求/元資料結構:在 media-use 中。
字幕
…
(註:由於原始內容在「字幕」後被截斷,此翻譯基於所提供的內容。完整的 skillMarkdown 應根據需要包含原始文件的其餘部分。)