motion-graphics — 分派入口
請在步驟 0 之前確認路線。 此技能用於製作簡短、以設計為主導且無旁白的動態圖形(動態即訊息;約 10 秒以下,無旁白)。較長、多場景或有旁白的作品 →
/general-video;有旁白的網站影片 →/website-to-video;主題解說 →/faceless-explainer;產品宣傳片 →/product-launch-video;為現有素材添加字幕 →/embedded-captions。超出範圍:即時/渲染時資料,或無法捕捉的素材。不確定是動畫優先還是有旁白?請先閱讀/hyperframes。
一個簡短的、以設計為主導的動態圖形。資產優先:在設計鏡頭之前,決定資產策略並取得真實素材,然後圍繞已取得的素材設計鏡頭,最後透過重複使用目錄功能來進行組合。所有成品都存放於 PROJECT_DIR = videos/<project-name>/(在步驟 0 建立);以下所有路徑都是相對於此目錄。
| 階段 | 執行方式 | 主要成品 | 詳細流程 |
|---|---|---|---|
| 初始化 | Bash | hyperframes.json | 步驟 0 |
| 規劃 | 子代理 — 決定是否搜尋? + 分類 + 資產策略 | shot-plan.json(草稿:類別, asset_needs 查詢, 簡報) | agents/director.md(第 1 部分) |
| 素材來源 ◇ | Bash — 媒體使用解析(若 asset_needs 為空則跳過) | assets/ + assets/index.md | phases/source/guide.md |
| 設計 | 子代理 — 圍繞已解析的資產進行鏡頭設計 | shot-plan.json(最終版:區塊 + 佈局 + 動態 + 定位) | agents/director.md(第 2 部分) |
| 建置 | 子代理 — 重複使用優先的組合 | compositions/index.html | agents/builder.md |
| 渲染 | Bash — hyperframes render(MP4,或使用 --format webm/mov 作為疊加層) | renders/video.mp4 | 步驟 5 |
| 驗證 | Bash — lint / inspect -> 失敗時啟動修復子代理 | (就地修復) | agents/finalize.md |
◇ 素材來源 僅在所選類別宣告需要資產時執行。純程式碼/文字類別(例如 kinetic-type、大多數的 charts/stat)的 asset_needs: [] 會直接從規劃階段跳到設計階段。
類別 — 根據搜尋決策來劃分
規劃階段的第一個決策是:是否需要搜尋? 這個分支將類別分成兩組;然後選出具體類別 — 對於搜尋驅動的類別,根據搜尋結果的內容類型來決定。每個類別都是一個 categories/<id>/module.md(包含其規劃和建置規則);共享的動態詞彙庫位於 references/motion-vocabulary.md(→ hyperframes-animation 規則/藍圖 + 註冊區塊)。
形式類別 — 無需搜尋;由使用者提供內容:
| 類別 | 意圖 | 主要依賴 |
|---|---|---|
kinetic-type | 有力的台詞 / 引文 / 標題,動態優先的文字 | caption-* 區塊 + 動畫規則 |
stat | 單一主數字 / 計數器 + 環狀圖 | apple-money-count / rules/{counting-dynamic-scale, stat-bars-and-fills} |
charts | 長條圖 / 折線圖 / 圓餅圖 / 競賽圖 / 來自資料的百分比 | data-chart 區塊 |
logo-reveal | 標誌動畫 / 品牌組合(使用者標誌) | logo-outro / rules/svg-path-draw |
lower-thirds | 姓名 / 標題列、提示框、社交媒體疊加層 | caption-* + 註冊表疊加層區塊 |
搜尋驅動類別 — 先搜尋,再根據內容類型進行動畫處理(RWA 路徑):
| 回傳的內容 | 類別 | 動畫處理 |
|---|---|---|
| 網頁 / 連結 | webpage | 網頁 / UI 動畫(滾動、揭示、游標、提示框) |
| 新聞文章 | news | 標題揭示 + 來源卡片 + 關鍵事實提示框 |
| 推文 | tweet | 動畫化推文卡片 |
| 圖片 / 實體 | asset-fusion | 資產的幾何形狀變成圖表(RWA 融合) |
建置順序:一次一個,以覆蓋率優先(粗略即可)。kinetic-type 從原型移植過來;其餘類別遵循此模式。
先決條件
macOS Apple Silicon 或 Linux x64。系統工具:brew install node ffmpeg。執行一次 npx hyperframes doctor。macOS GPU 渲染:export PRODUCER_BROWSER_GPU_MODE=hardware。
可選金鑰(若未設定則使用本地備用方案)— 僅在需要透過媒體使用(media-use)來來源/產生資產的類別中使用:
| 金鑰 | 用途 | 備用方案 |
|---|---|---|
GEMINI_API_KEY / GOOGLE_API_KEY | 圖片生成(媒體使用解析) | 跳過生成 / 僅搜尋 |
| (asset_scout / 搜尋提供者) | webpage/news/tweet + asset-fusion 真實資產搜尋 | 類別降級為無資產 |
流程
步驟 0 — 初始化
當前工作目錄是代理工作區根目錄;所有成品都寫入 PROJECT_DIR = videos/<project-name>/。:使用使用者提供的目錄,否則根據意圖使用簡短的 kebab-case 名稱(<subject>-motion)。不要使用工作區根目錄名稱或時間戳。
僅當 $PROJECT_DIR/hyperframes.json 不存在時:
PROJECT_DIR="${MOTION_GRAPHICS_DIR:-videos/<project-name>}"
mkdir -p "$(dirname "$PROJECT_DIR")"
npx hyperframes init "$PROJECT_DIR" --non-interactive --example=blank
init 會檢查已安裝的技能與 GitHub 上的最新版本,並在發現任何過期技能時更新全域集合。
限制: 永遠不要在 workspace 根目錄執行 hyperframes init;永遠不要在 PROJECT_DIR 內巢狀存放另一個 hyperframes/ 目錄;每個 Bash 命令(主代理 + 子代理)都是在 (cd "$PROJECT_DIR" && ...) 的子 shell 中執行 — 永遠不要使用裸 cd。
步驟 1 — 規劃(子代理:導演 第 1 部分)
分派一個子代理。提示詞 = 完整的 agents/director.md + ## 分派上下文(SKILL_DIR / PROJECT_DIR / 使用者的請求 / Schema: <SKILL_DIR>/references/shot-plan-ir.md)。它必須:
- 決定:是否需要搜尋?(第一個分支)
- 否 → 選擇一個形式類別(kinetic-type / stat / charts / logo-reveal / lower-thirds);內容由使用者提供;
asset_needs: []。 - 是 → 將一個搜尋計劃輸出到
asset_needs[](新聞 / 網頁 / 推文 / 圖片;雙極查詢)。具體的搜尋驅動類別(webpage / news / tweet / asset-fusion)將由步驟 2 中回傳的內容類型確認,並在步驟 3 中最終確定。
- 否 → 選擇一個形式類別(kinetic-type / stat / charts / logo-reveal / lower-thirds);內容由使用者提供;
- 撰寫一個草稿
shot-plan.json(包含包絡 + 所選形式類別 或 搜尋意圖 +asset_needs+ 一段落描述鏡頭的簡報)。Schema:references/shot-plan-ir.md。
驗證:[ -s "$PROJECT_DIR/shot-plan.json" ] && echo ok || echo missing。
步驟 2 — 素材來源 ◇(Bash:媒體使用,有條件)
如果 shot-plan.json.asset_needs 非空,則解析資產(搜尋 / 產生 / 擷取 → 凍結的專案本地路徑 + 分類帳)。請參閱 phases/source/guide.md(封裝了 media-use resolve;搜尋驅動類別使用新聞/網頁/推文/圖片搜尋)。如果 asset_needs 為空,則跳到步驟 3。
# 僅供說明 — 請參閱 phases/source/guide.md
(cd "$PROJECT_DIR" && node <SKILL_DIR>/phases/source/resolve.mjs --plan ./shot-plan.json --out ./assets)
優雅降級:如果搜尋/提供者不可用,該類別將回退為無資產(在 context.log 中記錄)。
步驟 3 — 設計(子代理:導演 第 2 部分)
分派一個子代理(提示詞 = agents/director.md 第 2 部分 + 分派上下文,包含已解析的 assets/index.md(如果步驟 2 已執行)+ catalog-map.md)。它根據可用的資產來設計鏡頭:選擇目錄區塊 + hyperframes-animation 規則/藍圖、佈局、動態、節拍,以及(對於 asset-fusion)element_positions + 滴管調色板。最終確定 shot-plan.json(content.block + content.customize + 每個類別的內容)。
步驟 4 — 建置(子代理:建置者,重複使用優先)
分派一個子代理。提示詞 = 完整的 agents/builder.md + 分派上下文(shot-plan.json、catalog-map.md、該類別的 module.md、references/motion-vocabulary.md、references/builder-contract.md)。重複使用優先:npx hyperframes add <block> + 就地自訂;僅手動編寫空白部分 + asset-fusion 的輔助功能。輸出 compositions/index.html,需符合 HF 合約(在 window.__timelines 上的暫停 GSAP 時間軸、class="clip" + 穩定的 ID、tl.seek(0)、確定性)。
步驟 5 — 渲染(Bash)
(cd "$PROJECT_DIR" && npx hyperframes render . --skill=motion-graphics -q draft -o ./renders/video.mp4)
# 透明疊加層變體:--format webm (或 mov)
步驟 6 — 驗證(Bash → 失敗時啟動修復子代理)
(cd "$PROJECT_DIR" && npx hyperframes lint . && npx hyperframes inspect .)
exit 0 → 完成。若 lint/inspect 出現錯誤,則分派修復子代理(agents/finalize.md:快照 QA + 一次就地修復 + 重新渲染)。修復期間絕不更改固定時長。
報告 + 可選預覽
報告最終輸出(renders/video.mp4,或 .webm / .mov 疊加層變體)+ 時長。在執行期間不要開啟預覽。 僅在請求時提供,並在渲染後啟動,以便提供最終檔案:
(cd "$PROJECT_DIR" && npx hyperframes preview) # Studio 使用者介面;或使用 `npx hyperframes play` 獲取可分享連結
標誌位存在於 hyperframes-cli 技能中(references/preview-render.md)。
恢復表
| 狀態 | 從何處繼續 |
|---|---|
沒有 shot-plan.json | 步驟 1(規劃) |
shot-plan.json 有 asset_needs,但沒有 assets/ | 步驟 2(素材來源) |
shot-plan.json 已最終確定,但沒有 compositions/index.html | 步驟 3/4(設計+建置) |
compositions/index.html 存在,但沒有 renders/video.mp4 | 步驟 5(渲染)+ 步驟 6 |
renders/video.mp4 存在 | 報告 + 停止 |
設計筆記(維護者 — 執行時不會讀取此部分)
- 資產優先的理由: 素材來源被提前執行,並為鏡頭設計提供資訊(RWA 流程:分析 → 搜尋 → 審閱 → 組合)。搜尋驅動類別(
webpage/news/tweet)和asset-fusion都依賴於媒體使用搜尋(新聞/網頁/推文/圖片),這是媒體使用有記錄的 RWA 傳統。 - 重複使用優先: 生態系統中與 LLM 生成的模板相對應的是「組合目錄區塊 +
hyperframes-animation規則」。HF 的暫停 GSAP 時間軸 ≙ Remotion 的useCurrentFrame。 - 類別模組合約: 一個
categories/<id>/module.md(規劃 + 建置),共享references/motion-vocabulary.md(+ 可選評估)。新增一個類別 = 放下資料夾 + 在agents/director.md中註冊其分類器行 + 在catalog-map.md中註冊其行;階段管道保持不變。 - 目錄結構:
videos/<project-name>/ hyperframes.json context.log shot-plan.json # 中間表示(導演輸出) assets/ assets/index.md # 媒體使用輸出(如果有來源) compositions/index.html # 建置者輸出 renders/video.mp4 - 註冊: 在
hyperframes路由器中 — 新增「以設計為主導的簡短動態圖形」意圖 + 工作流程描述;從/general-video中劃出 motion-graphics 觸發條件;新增反向「請勿使用」邊緣。請參閱motion-graphics-genre.md§5-7。