您可能正在品牌儲存庫內操作,或是從外部情境開始工作。
請勿任意猜測品牌識別。請分析程式碼庫,或研究提供的網址。
執行管線
步驟 1 — 收集情境資訊
⛔ 停止。向使用者提問以下兩個問題:
-
「我們現在是在您品牌的儲存庫內嗎?或者您願意提供一個網址(例如您的行銷網站),讓我在線上研究您的品牌?」
-
「您希望產生背景音樂嗎?如果需要,您的環境中需要有
ELEVEN_LABS_API_KEY。您可以前往 https://elevenlabs.io → 個人資料 → API 金鑰 取得金鑰。」
等待使用者回覆這兩個問題。
請勿嘗試自行讀取 .env 檔案或驗證金鑰。
請信任使用者的回覆。
如果使用者提供網址,請在步驟 3 中使用該網址進行品牌研究,而非分析程式碼庫。 如果使用者婉拒音樂,請跳過步驟 4 和步驟 5。
步驟 2 — 確保 Helios 執行時期相依性
安裝所需的套件:
npm install @helios-project/core @helios-project/renderer @helios-project/cli
您將使用 DOM 模式進行渲染。
步驟 3 — 從儲存庫萃取品牌智慧
如果使用者提供的是一個網址而非儲存庫,請擷取該網址並從該即時網站中萃取 相同的品牌訊號。跳過與程式碼庫相關的項目 (Tailwind 設定、設計系統代號等),並專注於可見的品牌元素。
分析:
• Tailwind 設定或 CSS 變數 • 全域樣式表 • 設計系統代號 • Logo 素材 • 網站圖示 • 文件結構 • 功能描述 • 入門流程 • 說明文字與微文案 • 資訊架構 • UI 元件 • 現有的動畫使用方式
建構內部的品牌檔案:
• 核心價值主張 • 目標受眾 • 語調(指導性、支持性、權威性) • 視覺密度 • 主要色板 • 強調色板 • 字體特徵 • 資訊階層模式 • 解說風格(視覺優先 vs 文字豐富)
所有創意決策都必須與此保持一致。
步驟 4 — 產生原創音樂(如果不需要音樂則跳過)
使用現有的 ELEVEN_LABS_API_KEY 與 ElevenLabs。
產生符合以下條件的純樂器曲目:
• 平靜、支持性的調性 • 穩定的進展,無劇烈高峰 • 微妙的背景存在感(不得與旁白競爭) • 目標播放時間
將音訊儲存於本地端。
步驟 5 — 使用 ffmpeg 分析音訊(如果不需要音樂則跳過)
萃取:
• BPM • 節拍時間戳記 • 強拍 • 能量峰值
建立節拍時間對應圖。
章節轉換應與強拍對齊。 螢幕上文字的顯現應與節拍對齊。
步驟 6 — 閱讀動態設計規則
在產出創意規格書之前,請先閱讀並內化:
skills/guided/motion-design-rules
該技能中的每一條規則對於此組合來說都是強制性的。
步驟 7 — 產出創意規格書
您是位資深創意總監與教學設計架構師,正在使用 motion.dev 為 Helios 進行設計。
輸入範例: 在 60 秒內解釋我們的結帳流程如何運作
輸出:
• 一份結構化的創意規格書 • 包裹在單一程式碼區塊中 • 區塊外不附任何說明
規格書必須包含:
• 時長 • 長寬比 (16:9) • 品牌摘要 • 敘事弧線(引言 → 問題 → 解決方案 → 運作方式 → 行動呼籲) • 動態語言(謹慎、從容、漸進) • 與節拍同步的章節分解 • 每個章節的準確時間戳記 • 旁白腳本(對話式、清晰) • 螢幕上文字(章節標題、功能標籤、步驟編號) • 視覺構成(乾淨排版、充裕留白) • 明確的 motion.dev 動畫行為 • 轉場邏輯(章節間平滑淡入淡出、內容滑入) • 圖層順序 • 音訊方向 • 素材需求 • 步驟指示器或進度標記
僅使用與 motion.dev 相容的術語。
敘事結構要求:
• 開場鉤子(前 5 秒) • 問題識別 • 解決方案介紹 • 逐步解說 • 總結與行動呼籲
步驟 8 — 實作基於 DOM 的 Helios 組合
根據創意規格書:
建立一個 composition.html 檔案,其:
• 使用 HTML + CSS + motion.dev • 使用 WAAPI / CSS / motion.dev 實作動畫 • 將章節轉換與強拍對齊 • 使用帶有步驟編號的清晰章節標題 • 包含產生的音訊檔案 • 具有精確的時長 • 優先考慮可讀性與視覺清晰度
暴露 Helios 執行時期:
import { helios } from "@helios-project/core";
window.helios = helios;
helios.bindToDocumentTimeline({
autoSyncAnimations: true
});
要求:
• 必須定義 window.helios
• 必須呼叫 helios.bindToDocumentTimeline()
• 必須啟用 autoSyncAnimations: true
• 所有 CSS 與 WAAPI 動畫必須正確同步
• 無隨機性
• 確定性計時
• 文字必須在螢幕上停留足夠的閱讀時間(每個關鍵訊息至少 3 秒)
步驟 9 — 使用官方 Helios CLI(DOM 模式)進行渲染
使用以下指令渲染:
npx @helios-project/cli render ./composition.html -o output.mp4
要求:
• 16:9 長寬比 • 正確的時長 • 附加音訊 • CSS 與 WAAPI 完全同步 • 高品質 MP4 輸出
輸出檔案必須為:
output.mp4
執行時期規則
如果時長 ≤ 30 秒 壓縮為:鉤子 → 核心概念 → 行動呼籲。
如果未指定時長 預設為 60 秒。
任何時長最多 5 個章節。 每個章節必須有清晰的螢幕標題。 節奏必須讓人能夠理解 — 切勿倉促地傳達資訊。
切勿重述原始提示。 切勿解釋推理過程。 創意規格書必須僅輸出在單一程式碼區塊內。