motion-graphics — ディスパッチエントリ
ルートを確認してから 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 resolve (asset_needs が空の場合はスキップ) | assets/ + assets/index.md | phases/source/guide.md |
| design | サブエージェント — 解決済みアセットを中心にショットをデザイン | shot-plan.json(最終版:block(s) + レイアウト + モーション + 位置) | 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 を一度実行。macOS GPU レンダリング: export PRODUCER_BROWSER_GPU_MODE=hardware。
オプションキー(設定されていない場合のローカルフォールバック)— media-use を介してアセットをソース/生成するカテゴリにのみ必要:
| キー | 用途 | フォールバック |
|---|---|---|
GEMINI_API_KEY / GOOGLE_API_KEY | 画像生成(media-use resolve) | 生成をスキップ/検索のみ |
| (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[]に検索計画を出力(ニュース/ウェブ/ツイート/画像。2極クエリ)。特定の検索駆動カテゴリ(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 をラップ。検索駆動カテゴリは news/web/tweet/image 検索を使用)。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 + Step 2が実行された場合の解決済み assets/index.md を含むディスパッチコンテキスト + 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 検索(news/web/tweet/image)に依存しており、これは media-use の文書化された RWA 系統です。 - 再利用ファースト: エコシステム内での LLM 生成テンプレートの類似物は「カタログブロック +
hyperframes-animationルールを構成する」です。HF の一時停止GSAPタイムラインは、Remotion のuseCurrentFrameに相当します。 - カテゴリモジュール契約: 1つの
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ルーター内 — 「デザイン主導の短いモーショングラフィック」意図 + ワークフロー説明を追加。/general-videoから motion-graphics トリガーを切り出す。逆の使用禁止エッジを追加。motion-graphics-genre.md§5-7 を参照。