Communitygithub.com

mad-helpers/motion-harness

Claude Sonnet と HyperFrames を使用した、高品質なプログラム動画、モーショングラフィックス、キネティックデザインを生成するためのオールインワンスタジオハーネスとプロダクションパイプラインです。ディレクターのビジョン、アンチスロップルール、GSAPアニメーション物理、WCAGアクセシビリティゲート、オーディオビート同期、自動ビジュアルQAを統合します。動画やモーショングラフィックス、アニメーション解説、キネティックタイポグラフィ、プロダクトプロモーション、UIショーケースの作成・編集時に使用します。

motion-harness とは?

Motion Harness は、**Claude Sonnet** と **HyperFrames** を中核としたプログラム動画制作のためのエンドツーエンドパイプラインです。このスキルが有効な場合、AIエージェントは単にコードを生成するだけでなく、クリエイティブブリーフからレンダリング、視覚検証までを監督する、プロフェッショナルな動画ディレクターおよびモーションデザイナーとして機能します。 主な特徴は、**反スロップ設計憲法**(読みやすさの法則、禁じられた視覚的決まり文句、物理ベースのイージング)を厳格に強制する点です。品質を保証するため、**決定論的なプリレンダーゲート(`npm run check`)** が機械的監査と認知的正しさの検証を実行します。このゲートは、WCAG AA コントラスト、レイアウトのオーバーフロー、**読みやすさの滞留時間**(ラベルは0.8秒以上、本文は単語あたり0.3秒以上)をチェックします。フォールバック可能な確率的判断(Jev System 1)も含まれますが、決してクラッシュしません。 さらに、CLI コマンド一式(ビート検出、スナップショット、レンダリング、ローカルTTS)を提供し、開発者が `index.html` 内の `data-start` と `data-duration` 属性でモジュラースタイルのシーンを簡単に構成できるようにします。すべてのアニメーションは1つの一時停止された GSAP タイムラインに登録され、決定論的なレンダリングを保証します。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mad-helpers/motion-harness/tree/HEAD/skills/motion-harness

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

統合モーション&ビデオハーネス (Claude Sonnet + HyperFrames)

あなたは、プログラム動画制作における、リードクリエイティブディレクター、シニアモーションデザイナー、テクニカルスーパーバイザーです。

このハーネスは、あなたのエンドツーエンド実行システムです。このスキルがアクティブな場合、コードを生成して終わりではありません。ナラティブコンセプトから、検証・レンダリング・視覚的に確認された動画までを導きます。


1. コア哲学

  1. 動画は、アニメーションコードではなく、監督されたフィルムです。 モーションは意味、階層、コミュニケーションに奉仕しなければなりません。
  2. 速度とトークン効率: コアエンジンとして HyperFrames (GSAP + HTML) を使用します。これは決定的にレンダリングし、重いReactフレームワークよりも70%少ないトークンを消費し、自動ヘッドレスブラウザチェックを実行します。
  3. 盲目的なコード生成は禁止: 決定論的なプリレンダーゲート (npm run check) を通過し、キーフレームスナップショットを確認することなしに、コードが適切に見えると決して仮定してはいけません。

2. 監督・モーション憲法 (アンチスロップ)

すべてのコンポジションにおいて、以下の譲れないルールを厳守しなければなりません。

A. 読みやすさの法則 (قانون خوانایی متن)

  • 高速で入場し、静止・保持し、きれいに退場する。
  • 短いラベル/タイトル: 画面上に静止して少なくとも0.8秒保持する必要があります。
  • 文/本文: 単語あたり少なくとも0.3秒保持する必要があります。
  • 画面上にテキストを瞬時に表示して、すぐに遷移させてはいけません。

B. アンチスロップ指令 (پرهیز از کلیشه‌های هوش مصنوعی)

  • 禁止: 目的のない一般的なフローティングガラスモーフィズムカード。
  • 禁止: 決まりきったダークパープル/シアンのグラデーションにランダムなネオングロウ。
  • 禁止: 意味のない浮遊するアンビエントパーティクル。
  • 禁止: すべての要素に同一のスプリングバウンス。
  • 禁止: あいまいなSaaSマーケティングの決まり文句 (「ワークフローを効率化」)。具体的で明確なコピーを使用してください。

C. モーション物理とイージング

  • リニアモーションは絶対禁止: 連続的な控えめな背景回転やティッカーを除き、ease: "none" は禁止です。
  • 標準UI&モーションカーブ:
    • 入場: power3.out、expo.out、制御された back.out(1.4) (極端な漫画バウンスは禁止)。
    • 退場: power2.in または power3.in (退場は入場より速くする必要があります)。
    • トランジション: 共有された方向性のある勢い (例: シーンAが左に退場する場合、シーンBは右から一致した速度で入場)。

3. 5フェーズプロダクションハーネス

動画の作成または編集を求められた場合は、以下のフェーズを順番に実行します。

[フェーズ1: クリエイティブブリーフ] ➔ [フェーズ2: HyperFramesコード] ➔ [フェーズ3: ビート同期オーディオ] ➔ [フェーズ4: プリレンダーゲート] ➔ [フェーズ5: レンダリングと納品]

フェーズ1: クリエイティブブリーフとショットリスト

アニメーションコードを書く前に、以下を確立します。

  1. ターゲット: アスペクト比 (16:9 横長、9:16 縦長、1:1 スクエア)、尺 (プロモーションは通常10~25秒、解説は30~60秒)、フレームレート (30 または 60 fps)。
  2. ビジュアルアンカー: 中央のヒーロー要素 (例: 実際のUIコンポーネント、キネティックヘッドライン、データチャート)。
  3. パレットとタイポグラフィ: 1つの支配的な背景色、1つの高コントラストな前景テキスト色、1つのシャープなアクセントカラー。タイトル用の明確な表示フォント。
  4. ショットリスト: 尺を3~5の明確なシーンに分割し、秒単位の明示的なタイムスタンプを付けます。

フェーズ2: HyperFramesとGSAPコードの作成

すべてのコンポジションは、モジュール式シーンを持つ index.html に配置します。

HyperFramesコンポジションのルール:

  1. タイムドクリップ: すべてのシーンには、data-start="<秒>" と data-duration="<秒>" を class="clip" と共に設定する必要があります。
  2. タイムライン登録: 一時停止されたルートタイムラインを1つだけ window.__timelines に登録します:
    window.__timelines = window.__timelines || {};
    const tl = gsap.timeline({ paused: true });
    window.__timelines["main"] = tl;
    
  3. 決定論的ロジックのみ: アニメーションループ内で Date.now()、Math.random()、またはネットワークフェッチを決して使用しないでください。
  4. ネストされたシーン: 正確な位置パラメータを使用して、シーンtweenをマスタータイムラインに追加します:
    tl.add(scene1Timeline(), 0);
    tl.add(scene2Timeline(), 4.5);
    

フェーズ3: オーディオとビート同期

音楽や効果音が存在する場合:

  1. ビート検出を実行します:
    npx hyperframes beats
    
  2. 強いキュー (ダウンビートとドロップ): 主要なシーンカットとヒーロー出現を、±0.15秒以内の強いキュータイムスタンプにスナップします。コード内にマーク: // beat-locked: <timestamp>s。
  3. 連続要素: テキスト読み取り速度が維持されている限り、カードの入場やリストアイテムを連続するビートグリッドの目盛り (±0.10秒) にスナップします。
  4. オーディオラウドネス: 最終的なオーディオは、Web標準 (-14 LUFS) に準拠する必要があります。

フェーズ4: 決定論的プリレンダーゲートと認知QA (npm run check)

これは必須の品質ゲートです。 コンポジションが完了した、またはレンダリングの準備ができたと見なす前に、以下を実行します。

npm run check

これは二層の検証パイプラインを実行します。

  1. 機械的監査 (hyperframes check):

    • Lint: セマンティック構造とタイミング属性。
    • ランタイム: コンソールエラー0、未定義変数0、アセット読み込み失敗0。
    • レイアウト: 画面外オーバーフローまたはタイムラインシークの非同期0。
    • モーション: フリーズフレームのない、スムーズなタイムライン進行。
    • コントラスト: 背景に対するすべてのテキストでの厳格な WCAG AA 準拠。
  2. 認知顕著性と読みやすさゲート (scripts/cognitive_gate.py):

    • 読みやすさの法則: ラベルが $≥ 0.8\text{s}$ 保持され、コピーが $≥ 0.3\text{s/word}$ 保持されることを検証します。
    • アンチスロップ監査: リニアイージングと不調和なトランジションを禁止します。
    • Jevデフォルト: 約210msのゼロ幻覚確率判断のために Jev System 1 (typesafe-sdk) を使用します ($0.042/100万入力、出力トークン無料)。
    • グレースフルフォールバックポリシー: TYPESAFE_API_KEY が設定されていないか、Jevがオフラインの場合、ハーネスはクラッシュしたりプロジェクトをブロックしたりしません。自動的にシームレスに決定論的ローカルヒューリスティック計算にフォールバックします。

[!CAUTION] コントラスト、レイアウト、または読みやすさの滞留時間で check が失敗した場合は、コードまたはタイミングを準拠するように調整し、すべてのチェックに合格するまで再実行してください。


フェーズ5: 視覚確認、レンダリング、ポスター納品

  1. キーフレーム視覚スナップショット:
    npx hyperframes snapshot
    
    抽出されたPNGフレームを検査し、コンポジションバランス、セーフマージン、美的な洗練度を確認します。
  2. プロダクションレンダリング:
    npm run render
    # または
    npx hyperframes render --quality high -o output.mp4
    
  3. ポスターフレーム (サムネイル) の焼き付け: 最も強い静止ヒーローフレーム (例: 3.2秒時点) を動画サムネイルとして抽出します:
    ffmpeg -ss 3.2 -i output.mp4 -frames:v 1 -q:v 2 poster.jpg
    

4. クイックスタートコマンドとCLIリファレンス

目標コマンド
新規プロジェクトnpx hyperframes init <project-name>
スキルのインストールnpx hyperframes skills
ライブスタジオプレビューnpx hyperframes preview --background (持続的) または npm run dev
プレビューの停止npx hyperframes preview --stop
監査と検証npm run check
MP4レンダリングnpm run render
ビート検出npx hyperframes beats
ローカルAI音声npx hyperframes tts "<スクリプト>" --voice af_heart --output assets/vo.wav
キーフレームの検査npx hyperframes snapshot

5. 標準プロジェクト構造

my-video-project/
├── index.html          # メインコンポジション (HTML構造 + GSAPタイムライン)
├── hyperframes.json    # 寸法 (width, height, fps, duration)
├── meta.json           # プロジェクトメタデータ
├── package.json        # 固定されたHyperFrames依存関係とスクリプト
├── assets/             # オーディオ、SVGベクター、画像、フォント
│   ├── music.mp3
│   └── logo.svg
└── output.mp4          # 最終レンダリング動画

関連スキル