プラグインインストール: セットアップまたは更新コマンドの前に、このスキルがHyperFramesプラグイン内にある場合は、プラグイン実行ルールに従ってください。スタンドアロンインストールの場合は、以下の更新手順を維持してください。
最初に、このスキルを最新に保つためにユーザーに確認してから実行:
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)は、実行形状に関する質問なしでここに直接ルーティングします。このような短い作品にストーリーボードやコンパニオンセッションを追加しても意味はほとんどありません。レンダリングは依然としてユーザーゲートです:チェックとプルーフスナップショットが合格した後、Studioプレビューを開き、../hyperframes/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リゾルブ(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 | 単一のヒーロー数字/カウントアップ + リング | 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 を一度実行。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>:ユーザーが指定したディレクトリを使用するか、指定がない場合は意図から短いケバブケース名を使用します(<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 — 計画(サブエージェント:ディレクターパート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 / maps)。コンテンツはユーザー提供。
asset_needs: []。 - はい → 検索計画を
asset_needs[]に出力(ニュース/ウェブ/ツイート/画像、2極クエリ)。具体的な検索駆動カテゴリ(webpage / news / tweet / asset-fusion)は、ステップ2で返されるコンテンツタイプによって確認され、ステップ3で確定されます。
- いいえ → フォームカテゴリを選択(kinetic-type / stat / charts / logo-reveal / lower-thirds / maps)。コンテンツはユーザー提供。
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をラップ。検索駆動カテゴリはニュース/ウェブ/ツイート/画像検索を使用)を参照してください。asset_needsが空の場合は、ステップ3にスキップします。
グレースフルデグラデーション:検索/プロバイダーが利用できない場合、カテゴリはアセットなしにフォールバックします(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 — 構築(サブエージェント:ビルダー、再利用優先)
共有のモーション原則をビルダーのディスパッチコンテキストに含めてください。charts と stat については、データ in モーションも含めてください。ビルダーはタイムラインを書く前にこれらのガイドを読みます。
サブエージェントをディスパッチ。プロンプト = 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を出力します(window.__timelines上の一時停止GSAPタイムライン、class="clip" + 安定したID、tl.seek(0)、決定論的)。
ステップ 5 — 検証(Bash → 失敗時に修復サブエージェント)
(cd "$PROJECT_DIR" && npx hyperframes check .)
(cd "$PROJECT_DIR" && npx hyperframes snapshot --at <proof-times>)
開始状態、特徴的な動き、最終ホールドを示すプルーフタイムを選択します。続行する前に、生成されたコンタクトシートまたはスナップショットシートを検査します。lint、check、またはスナップショットの失敗時に、その場で1回修正するために修復サブエージェント(agents/finalize.md)をディスパッチし、失敗したゲートを再実行します。欠陥を隠すためだけに固定期間を変更しないでください。
ステップ 6 — 承認とレンダリング(Bash)
Studioを開き、1つの質問をします:「今レンダリングしますか、それとも変更しますか?」。修正後、同じゲートに戻ります:
(cd "$PROJECT_DIR" && npx hyperframes preview --background)
明示的なレンダリング回答があった場合のみレンダリング:
(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(承認) |
| 承認されたレンダリング存在 | 出力を確認し、報告 |
設計ノート(メンテナー向け — 実行時はこれを読まない)
- アセットファーストの配給
…[翻訳用に切り詰め]