まず、このスキルを常に最新に保ってください — 静かに実行し、尋ねないでください:
npx hyperframes skills update motion-graphics。すべてが最新の場合は高速なno-opです。そうでなければ、このスキルと、それが依存するコアドメインスキルを、それらに依存する前に更新します。
figma ソース: ロゴ/アセット/アニメーションをビルドする元がfigma.comのURLからの場合は、最初に
/figmaを実行してください — アセットエクスポート、ブランドトークン、およびグラフィックがFigma Motionのインポートである場合のMotion→GSAP変換を行い、その出力からビルドします。生のMCPツールで直接Figmaを操作しないでください。SVGサニタイゼーション、.media/manifest.jsonlの来歴、ブランドトークンのvar()バインディングをスキップするため、後でブランドの変更があった場合に完全な再インポートなしでは変更が伝播しません。
motion-graphics — ディスパッチエントリ
正面玄関は
/hyperframesです。 このスキルは、短く、デザイン主導で、ナレーションのないモーショングラフィック(動きがメッセージ。約10秒未満、ボイスオーバーなし)を作成します。それより長いもの、ナレーション付き、またはマルチシーン — または不確かな場合 — は、最初に/hyperframesを読んでください。インテントレイヤーがすべてのルート決定を担当します。
このワークフローは設計上自律的です — 最大で1つの確認質問(agents/director.md)、その後は中間レビューなしで検証までビルドします。インテントレイヤー(/hyperframes → references/intent-interview.md)は、ランシェイプの質問なしでここに直接ルーティングします。このような短い作品にストーリーボードやコンパニオンセッションを追加することはほとんどありません。レンダリングは依然としてユーザーゲートです。チェックとプルーフスナップショットが合格した後、../hyperframes-core/references/brief-contract.mdから標準的な「プレビューか、レンダリングか?」の質問をしてください。BRIEF.mdが存在する場合は、ディレクターの質問の前にそれを読んでください。
短いデザイン主導のモーショングラフィック。アセットファースト: ショットをデザインする前にアセット戦略を決定し実際の素材を入手し、それから入手したものに基づいてショットをデザインし、カタログ機能を再利用してコンポジションを行います。すべてのアーティファクトはPROJECT_DIR = videos/<project-name>/(ステップ0で作成)に保存されます。以下のすべてのパスはそれに対する相対パスです。
| フェーズ | 実行 | 主要なアーティファクト | 詳細フロー |
|---|---|---|---|
| 初期化 | Bash | hyperframes.json | ステップ0 |
| 計画 | サブエージェント — 検索を決定? + 分類 + アセット戦略 | shot-plan.json(ドラフト: カテゴリ, asset_needs クエリ, ブリーフ) | agents/director.md(パート1) |
| ソース ◇ | Bash — media-use resolve(asset_needsが空の場合はスキップ) | assets/ + assets/index.md | phases/source/guide.md |
| デザイン | サブエージェント — 解決されたアセットを中心にショットをデザイン | shot-plan.json(最終: ブロック + レイアウト + モーション + 位置) | agents/director.md(パート2) |
| ビルド | サブエージェント — 再利用ファーストのコンポジション | compositions/index.html | agents/builder.md |
| 検証 | Bash — lint、check、プルーフスナップショット; 失敗時は修復 | snapshots/contact-sheet.jpg | ステップ5 |
| 承認 | プレビューまたはレンダリングを尋ねる; 回答を待つ | 明示的なレンダリング承認 | ステップ6 |
| レンダリング | Bash — hyperframes render(MP4、またはオーバーレイ用--format webm/mov) | renders/video.mp4 または透明なオーバーレイ | ステップ6 |
◇ ソースは、選択されたカテゴリがアセットを宣言している場合にのみ実行されます。純粋なコード/テキストカテゴリ(例:kinetic-type、ほとんどのcharts/stat)はasset_needs: []を持ち、計画から直接デザインにスキップします。
カテゴリ — 検索判断で分割
planの最初の判断は: これに検索が必要か? この分岐でカテゴリは2つのグループに分かれます。その後、具体的なカテゴリが選択されます — 検索駆動の場合は、検索が返すコンテンツのタイプによって。各カテゴリは1つのcategories/<id>/module.md(計画とビルドルール)です。共有のモーションボキャブラリはreferences/motion-vocabulary.md(→ hyperframes-animationルール/ブループリント + レジストリブロック)にあります。
フォームカテゴリ — 検索なし。ユーザーがコンテンツを提供:
| カテゴリ | インテント | 依存元 |
|---|---|---|
kinetic-type | パンチの効いた行/引用/タイトル、モーションファーストのテキスト | caption-* ブロック + アニメーションルール |
stat | 1つのヒーロー数字/カウントアップ + リング | 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ダイジェティックフュージョン) |
ビルド順序: 一度に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 resolve) | 生成をスキップ / 検索のみ |
| (asset_scout / 検索プロバイダ) | webpage/news/tweet + asset-fusion 実アセット検索 | カテゴリはアセットフリーに劣化 |
フロー
ステップ 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 --skill=motion-graphics
initはインストールされているスキルをGitHub上の最新版と照合し、古いものがあればグローバルセットを更新します。
制約: ワークスペースルートでhyperframes initを決して行わないでください。PROJECT_DIR内に別のhyperframes/をネストしないでください。すべてのBashコマンド(マスター + サブエージェント)は(cd "$PROJECT_DIR" && ...)サブシェルです — 裸のcdは絶対に使用しないでください。
ステップ 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[]に出力(news / web / tweet / image; 2極クエリ)。具体的な検索駆動カテゴリ(webpage / news / tweet / asset-fusion)はステップ2で返されるコンテンツタイプによって確認され、ステップ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。
ステップ 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 — デザイン(サブエージェント: Director パート2)
サブエージェントをディスパッチします(プロンプト = agents/director.md パート2 + ステップ2が実行された場合は解決されたassets/index.mdを含むディスパッチコンテキスト + catalog-map.md)。利用可能なアセットを中心にショットをデザインします: カタログブロック + hyperframes-animationルール/ブループリント、レイアウト、モーション、ビート、そして(asset-fusionの場合は)element_positions + スポイトパレットを選択します。shot-plan.jsonを最終決定します(content.block + content.customize + カテゴリごとのコンテンツ)。
ステップ 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)、決定論的)。
ステップ 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)を1回のインプレース修正パスのためにディスパッチし、失敗したゲートを再実行します。欠陥を隠すためだけに固定の持続時間を変更しないでください。
ステップ 6 — 承認とレンダリング(Bash)
1つの質問をします: 「プレビューを先に、それともレンダリングしますか?」ユーザーがプレビューを選択した場合、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生成テンプレートの類似物は、"compose"することです