プラグインインストール: セットアップやフレッシュネスコマンドの前に、このスキルが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で作成)に配置されます。以下のすべてのパスは、それに対する相対パスです。
| フェーズ | 実行 | 主要成果物 | 詳細フロー |
|---|---|---|---|
| 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 の 最初の判断は:これは検索を必要とするか? この分岐によってカテゴリは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 + ステップ2が実行された場合は解決された assets/index.md を含むディスパッチコンテキスト + catalog-map.md)。利用可能なアセットを中心にショットをデザインします:カタログブロック + hyperframes-animation ルール/ブループリント、レイアウト、モーション、ビート、および(asset-fusionの場合は)element_positions + スポイターパレットを選択します。shot-plan.json(content.block + content.customize + カテゴリごとのコンテンツ)を最終決定します。
ステップ 4 — ビルド(サブエージェント:ビルダー、再利用ファースト)
ビルダーのディスパッチコンテキストに共有モーション原則を含めます。chartsおよびstatについては、データインモーションも含めます。ビルダーはタイムラインを書き込む前にこれらのガイドを読みます。
サブエージェントをディスパッチします。プロンプト = agents/builder.md 全体 + ディスパッチコンテキスト(shot-plan.json、catalog-map.md、カテゴリの module.md、references/motion-vocabulary.md、references/builder-contract.md)。再利用ファースト:npx hyperframes add <block> + その場でカスタマイズ。ギャップとアセットフュージョンアフォーダンスのみを手動で作成します。HFコントラクト(一時停止されたGSAPタイムライン window.__timelines、class="clip" + 安定したID、tl.seek(0)、決定論的)に従って compositions/index.html を出力します。
ステップ 5 — 検証(Bash → 失敗時に修復サブエージェント)
(cd "$PROJECT_DIR" && npx hyperframes check .)
(cd "$PROJECT_DIR" && npx hyperframes snapshot --at <proof-times>)
開始状態、シグネチャムーブ、最終ホールドを示すプルーフタイムを選択します。続行する前に、生成されたコンタクトシートまたはスナップショットシートを検査します。lint、check、またはスナップショットの失敗時は、修復サブエージェント(agents/finalize.md)をディスパッチして、1回のインプレース修正パスを実行し、失敗したゲートを再実行します。欠陥を隠すために固定された長さを決して変更しないでください。
ステップ 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(承認) |
| 承認されたレンダリングが存在する | 出力を確認して報告 |
デザインノート(メンテナー向け — 実行時はこれを読みません)
- アセットファーストの根拠...