モーション・グラフィックス — ディスパッチエントリ は何をしますか?
ルート確認はStep 0の前に行ってください。 このスキルは短い、デザイン主導の、ナレーションなしのモーショングラフィック(モーションがメッセージであり、約10秒未満、ボイスオーバーなし)を制作します。より長い、マルチシーン、またはナレーション付きの作品 →
/general-video。ウェブサイトのナレーション付き動画 →/website-to-video。トピック解説 →/faceless-explainer。製品プロモーション →/product-launch-video。既存映像へのキャプション追加 →/embedded-captions。対象外: ライブ/レンダリング時データ、またはキャプチャできない映像。モーションファーストかナレーション付きか不明な場合? 最初に**/hyperframesを読んでください。**
短いデザイン主導のモーショングラフィックです。アセットファースト: ショットをデザインする前にアセット戦略を決定し、実際の素材を調達し、その素材を中心にショットをデザインし、カタログ機能を再利用して構成します。すべてのアーティファクトは PROJECT_DIR = videos/<project-name>/ に保存されます(Step 0で作成)。以下のパスはすべてこのディレクトリを基準とします。
| フェーズ | 実行方法 | 主なアーティファクト | 詳細フロー |
|---|---|---|---|
| init | Bash | hyperframes.json | Step 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 |
| render | Bash — hyperframes render (MP4、またはオーバーレイ用 --format webm/mov) | renders/video.mp4 | Step 5 |
| verify | Bash — lint / inspect -> 失敗時は修復サブエージェント | (修正はその場で) | agents/finalize.md |
◇ source は、選択されたカテゴリがアセットを宣言している場合のみ実行されます。純粋なコード/テキストカテゴリ(例: kinetic-type、ほとんどの charts/stat)は asset_needs: [] を持ち、計画からデザインに直接スキップします。
カテゴリ — 検索判断による分割
plan の最初の判断は「検索が必要か?」 です。この分岐によってカテゴリは2つのグループに分かれます。その後、検索駆動型の場合は検索で返されるコンテンツの種類によって具体的なカテゴリが選択されます。各カテゴリは 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ダイジェティックフュージョン) |
ビルド順序: 一度に1つずつ、カバレッジ優先(ラフで問題ありません)。kinetic-type はプロトタイプから移植。残りも同様に従います。
前提条件
macOS Apple Silicon または Linux x64。システムツール: brew install node ffmpeg。npx hyperframes doctor を1回実行。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 実アセット検索 | カテゴリはアセットなしに劣化 |
フロー
Step 0 — 初期化
cwd はエージェントワークスペースルート。すべてのアーティファクトを PROJECT_DIR = videos/<project-name>/ の下に書き込みます。<project-name>: ユーザーから指定されたディレクトリがあればそれを使い、なければ意図から短いケバブケース名(<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上の最新バージョンと照合し、古いものがあればグローバルセットを更新します。
制約: ワークスペースルートで hyperframes init を実行しないでください。PROJECT_DIR 内に別の hyperframes/ をネストしないでください。すべてのBashコマンド(マスターおよびサブエージェント)は (cd "$PROJECT_DIR" && ...) サブシェルで実行します — 裸の cd は使用しません。
Step 1 — 計画(サブエージェント: Director パート1)
1つのサブエージェントを起動します。プロンプト = agents/director.md 全文 + ## Dispatch context(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)は、Step 2で返されるコンテンツタイプによって確定し、Step 3で最終決定されます。
- 不要 → フォームカテゴリを選択(kinetic-type / stat / charts / logo-reveal / lower-thirds); コンテンツはユーザー提供;
- ドラフト
shot-plan.jsonを書き込みます(エンベロープ + 選択されたフォームカテゴリ または 検索意図 +asset_needs+ 1段落のショット概要)。スキーマ:references/shot-plan-ir.md。
検証: [ -s "$PROJECT_DIR/shot-plan.json" ] && echo ok || echo missing
Step 2 — ソース ◇(Bash: media-use、条件付き)
shot-plan.json の asset_needs が空でない場合、アセットを解決します(検索/生成/取得 → プロジェクトローカルパス + 台帳に確定)。phases/source/guide.md を参照(media-use resolve をラップ; 検索駆動カテゴリはニュース/ウェブ/ツイート/画像検索を使用)。asset_needs が空の場合は、Step 3 にスキップします。
# 例示 — phases/source/guide.md を参照
(cd "$PROJECT_DIR" && node <SKILL_DIR>/phases/source/resolve.mjs --plan ./shot-plan.json --out ./assets)
グレースフルデグラデーション: 検索/プロバイダが利用できない場合、カテゴリはアセットなしにフォールバックします(context.log に記録)。
Step 3 — デザイン(サブエージェント: Director パート2)
サブエージェントを起動します(プロンプト = agents/director.md パート2 + 解決済みの assets/index.md(Step 2が実行された場合)+ catalog-map.md を含むディスパッチコンテキスト)。エージェントは利用可能なアセットを中心にショットをデザインします: カタログブロック + hyperframes-animation ルール/ブループリント、レイアウト、モーション、ビートを選択し、(asset-fusion の場合は)element_positions + スポイトパレットを設定します。shot-plan.json を最終決定します(content.block + content.customize + カテゴリごとのコンテンツ)。
Step 4 — ビルド(サブエージェント: Builder、再利用ファースト)
サブエージェントを起動します。プロンプト = agents/builder.md 全文 + ディスパッチコンテキスト(shot-plan.json、catalog-map.md、カテゴリの module.md、references/motion-vocabulary.md、references/builder-contract.md)。再利用ファースト: npx hyperframes add <block> + その場でカスタマイズ。不足部分とアセットフュージョンアフォーダンスのみ手動で記述します。HFコントラクトを尊重した compositions/index.html を出力します(一時停止されたGSAPタイムライン window.__timelines、class="clip" + 安定したID、tl.seek(0)、決定論的)。
Step 5 — レンダリング(Bash)
(cd "$PROJECT_DIR" && npx hyperframes render . --skill=motion-graphics -q draft -o ./renders/video.mp4)
# 透過オーバーレイのバリアント: --format webm (または mov)
Step 6 — 検証(Bash → 失敗時は修復サブエージェント)
(cd "$PROJECT_DIR" && npx hyperframes lint . && npx hyperframes inspect .)
exit 0 → 完了。lint/inspect エラーが発生した場合、修復サブエージェント(agents/finalize.md: スナップショットQA + 1回のその場修正パス + 再レンダリング)を起動します。修復中に固定された期間を変更しないでください。
レポート + オプションプレビュー
最終出力(renders/video.mp4、または .webm / .mov オーバーレイバリアント)と期間を報告します。実行中はプレビューを開かないでください。 リクエストがあった場合のみ、レンダリング後に開始して最終ファイルを提供します:
(cd "$PROJECT_DIR" && npx hyperframes preview) # Studio UI; または `npx hyperframes play` で共有リンク
フラグは hyperframes-cli スキール(references/preview-render.md)にあります。
再開テーブル
| 状態 | 再開ポイント |
|---|---|
shot-plan.json なし | Step 1 (計画) |
shot-plan.json に asset_needs あり、assets/ なし | Step 2 (ソース) |
shot-plan.json 最終版、compositions/index.html なし | Step 3/4 (デザイン+ビルド) |
compositions/index.html 存在、renders/video.mp4 なし | Step 5 (レンダリング) + Step 6 |
renders/video.mp4 存在 | レポート + 停止 |
設計ノート(メンテナ — 実行時はこれを読みません)
- アセットファーストの根拠: ソーシングは先行して行われ、ショットデザインに情報を提供します(RWAフロー: 分析 → 検索 → レビュー → 構成)。検索駆動カテゴリ(
webpage/news/tweet)とasset-fusionはどちらもmedia-use検索(ニュース/ウェブ/ツイート/画像)に依存しており、これはmedia-useの文書化された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 # IR(Director出力) assets/ assets/index.md # media-use出力(ソースされた場合) compositions/index.html # Builder出力 renders/video.mp4 - 登録:
hyperframesルーター内 — 「デザイン主導の短いモーショングラフィック」意図 + Workflow説明を追加;/general-videoからモーション・グラフィックスのトリガーを切り出す; 逆の「Do NOT use」エッジを追加。motion-graphics-genre.md§5-7 を参照。