首先,讓此技能保持最新狀態 — 靜默執行,無需詢問:
npx hyperframes skills update motion-graphics。如果一切皆為最新,則為快速無操作;否則,它會在你依賴此技能及其依賴的核心領域技能之前,進行更新。
figma 來源:如果要建構的標誌/資產/動畫來自 figma.com 的 URL,請先執行
/figma— 匯出資產、品牌標記,如果該圖形是 Figma Motion 導入,則進行 Motion→GSAP 轉換 — 然後根據其輸出進行建構。不要直接透過原始 MCP 工具驅動 Figma:這會跳過 SVG 清理、.media/manifest.jsonl來源追溯以及品牌標記var()綁定,因此後續的品牌變更無法在不完全重新導入的情況下傳播。
motion-graphics — 分派入口
正門是
/hyperframes。 此技能製作一個簡短、以設計為主導、無旁白的動態圖像(動態即訊息;約少於10秒,無畫外音)。任何較長、有旁白或多場景的內容 — 或不確定性 → 請先閱讀/hyperframes:意圖層掌管所有路徑決策。
此工作流程本質上為自主設計 — 最多一個澄清問題(agents/director.md),然後在建構後直接進行驗證,無需中間審查。意圖層(/hyperframes → references/intent-interview.md)會直接將其路由至此,而無需詢問運作形狀問題;對於這樣短的片段,故事板和同伴會話幫助不大。渲染仍由使用者控制:在檢查和驗證快照通過後,從 ../hyperframes-core/references/brief-contract.md 詢問標準的「預覽或渲染?」問題。當存在 BRIEF.md 時,請在導演提問之前閱讀它。
一個簡短、以設計為主導的動態圖像。資產優先:在設計鏡頭之前,先決定資產策略並取得真實素材,然後根據你所擁有的素材來設計鏡頭,最後透過重複使用目錄能力來進行組合。所有產出物都放在 PROJECT_DIR = videos/<project-name>/(在第0步建立);以下所有路徑均相對於此目錄。
| 階段 | 執行方式 | 主要產出物 | 詳細流程 |
|---|---|---|---|
| init | Bash | hyperframes.json | 第0步 |
| plan | 子代理 — 決定是否搜尋? + 分類 + 資產策略 | shot-plan.json(草稿:類別、asset_needs 查詢、簡報) | agents/director.md(第1部分) |
| source ◇ | Bash — media-use 解析(如果 asset_needs 為空則跳過) | assets/ + assets/index.md | phases/source/guide.md |
| design | 子代理 — 根據已解析的資產進行鏡頭設計 | shot-plan.json(最終版:區塊 + 版面 + 動態 + 位置) | agents/director.md(第2部分) |
| build | 子代理 — 優先重複使用組合 | compositions/index.html | agents/builder.md |
| verify | Bash — lint、check、驗證快照;失敗時修復 | snapshots/contact-sheet.jpg | 第5步 |
| approve | 詢問預覽或渲染;等待回答 | 明確的渲染批准 | 第6步 |
| render | Bash — hyperframes render(MP4,或 --format webm/mov 用於疊加) | renders/video.mp4 或透明疊加 | 第6步 |
◇ source 僅在所選類別宣告資產時執行。純程式碼/文字類別(例如 kinetic-type、大多數 charts/stat)的 asset_needs: [],並直接從規劃跳到設計。
類別 — 根據搜尋決策拆分
plan 的第一個決策是:是否需要搜尋? 這個分支將類別分為兩組;然後選擇具體類別 — 對於搜尋驅動的類別,根據搜尋返回的內容類型來決定。每個類別都是一個 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-* + 註冊表疊加區塊 |
maps | 地理動畫 — 突顯區域、連接地點、縮放至特定位置(向量圖層,或烘焙底圖圖層) | us-map / world-map 系列 + bake-basemap.mjs |
搜尋驅動的類別 — 先搜尋,然後根據內容類型進行動畫製作(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 | 圖片生成(media-use 解析) | 跳過生成 / 僅搜尋 |
| (asset_scout / 搜尋提供者) | webpage/news/tweet + asset-fusion 真實資產搜尋 | 類別降級為無資產 |
流程
第0步 — 初始化
cwd 是代理工作區根目錄;將所有產出物寫入 PROJECT_DIR = videos/<project-name>/ 下。<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 --skill=motion-graphics
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[]中(news / web / tweet / image;雙極查詢)。具體的搜尋驅動類別(webpage / news / tweet / asset-fusion)將在第2步中由返回的內容類型確認,並在第3步中最終確定。
- 否 → 選擇一個表單類別(kinetic-type / stat / charts / logo-reveal / lower-thirds);內容由使用者提供;
- 撰寫草稿
shot-plan.json(信封 + 所選表單類別 或 搜尋意圖 +asset_needs+ 一段簡短的鏡頭簡報)。架構:references/shot-plan-ir.md。
驗證:[ -s "$PROJECT_DIR/shot-plan.json" ] && echo ok || echo missing。
第2步 — 來源化 ◇(Bash:media-use,條件式)
如果 shot-plan.json.asset_needs 非空,則解析資產(搜尋 / 生成 / 擷取 → 凍結的專案本地路徑 + 帳本)。請參閱 phases/source/guide.md(包裝 media-use resolve;搜尋驅動的類別使用 news/web/tweet/image 搜尋)。如果 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 lint .)
(cd "$PROJECT_DIR" && npx hyperframes check .)
(cd "$PROJECT_DIR" && npx hyperframes snapshot --at <proof-times>)
選擇能顯示初始狀態、標誌性動作和最終停留的驗證時間點。在繼續之前,檢查生成的聯繫表或快照表。在 lint、check 或快照失敗時,分派修復子代理(agents/finalize.md)進行一次就地修復,然後重新執行失敗的關卡。切勿僅為了隱藏缺陷而更改固定時長。
第6步 — 批准和渲染(Bash)
詢問一個問題:「先預覽,還是渲染?」如果使用者選擇預覽,則打開 Studio 並在修訂後返回同一個批准關卡:
(cd "$PROJECT_DIR" && npx hyperframes preview)
僅在收到明確的渲染答案後才進行渲染:
(cd "$PROJECT_DIR" && npx hyperframes render . --skill=motion-graphics -q high -o ./renders/video.mp4)
# 透明疊加變體:--format webm(或 mov)
驗證輸出是否存在、非空且具有預期時長。最終交接時需命名產出物、實際時長、合成或影格 ID、驗證時間點以及已檢查的聯繫表或快照表。標誌位存在於 /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 存在,缺乏驗證快照 | 第5步(驗證) |
| 檢查和驗證快照通過,無已批准的渲染 | 第6步(批准) |
| 已批准的渲染存在 | 驗證輸出,然後報告 |
設計備註(維護者 — 執行時不讀取此內容)
- 資產優先的理由: 來源化前置,並為鏡頭設計提供資訊(RWA 流程:分析 → 搜尋 → 審查 → 組合)。搜尋驅動的類別(
webpage/news/tweet)和asset-fusion都依賴 media-use 搜尋(news/web/tweet/image),這是 media-use 有文件記錄的 RWA 血統。 - 優先重複使用: 生態系統內類比於 LLM 生成的模板是「組合...