単一アニメーション挿入の構築
あなたは、動画に挿入またはオーバーレイとして配置される単一の完成されたアニメーション(4〜10秒)を構築します。これは、作者が音声で話している考えを視覚的に示すものでなければなりません。単に全体的に説明するのではなく、その考えを具体的に示す必要があります。
デフォルトスタイル — v4「画像を使ったプレゼンテーション」
ユーザーが他を指定しない限り、v4スタイルで構築してください。 作者はこれを「全体的に理想的」と呼び、今後の動画もまったく同じにするよう求めています。詳細はすべて references/style-v4.md にあります:リファレンス(references/style-v4.md 内の説明)、kinetic / full / split-cam / split-screen / lower の正確なジオメトリを備えたレイアウト、定数、サウンド、承認プロセス。
- 共通スタイルとヘルパー:
assets/style-v4/common.css、common.js(heroIn、rise、chipIn、countUp)。 - 参考シーン(フラグメント +
.sfx.json):references/recipes/v4/— 最も近いレイアウトのものから始めてください。 - 構築:フラグメント
W/scenes/NN.htmlを作成 →python3 scripts/mk_scene.py W NN→check→ レンダリング。 画像:scripts/gen_images.sh+scripts/alpha.py;ウェブカム/スクリーンクリップ:scripts/cut_clips.py。 - スタンプと「悪い結果」のサウンド —
assets/style-v4/sfx/、残りは media-use バンドル。
古いレイヤー(以下):テクニックは Austin Marchese の編集から抽出され、チャンネルのデザインシステムに適用されました — PiPモーフ、ズームスルー、チャプターカルーセルなど。v4では、これらを基本ではなく、シーン内のアクセントとして使用します。テクニックは、タイミング、カーブ、レイヤー順序を正確にコピーします。パレットとタイポグラフィは、独自のシステムからのみ使用します。
読むべきものとその順序
references/style-v4.md— どのように見えるべきか。references/gotchas.md— コードを書く前に。エンジンの制限、明るいテーマの落とし穴、ジョイントのルールがあります。各項目はかつてイテレーションを要しました。references/style-rules.md— スタイルのルール:テキストの出現と消去方法、リズムの決め方、常に動くもの。これらは、どのテクニックを構築する場合でも遵守してください — それらこそが編集を認識可能にします。references/design-system.md— パレット、スケール、コンポーネント、ブランドルール。違反は不可。- 使用するテクニックのメカニクス — 自分のセクションのみを読んでください:
references/techniques.md— 検証済み実装のテクニック;references/techniques-observed.md— 分析から抽出されたがまだ構築されていないテクニック;説明に従って構築します。
references/recipes/<technique>.html—techniques.mdからの動作する実装。これは丸ごとコピーするためのテンプレートではなく、複雑な部分がどのように解決されたかのサンプルです。メカニクスが明らかでない場合に参照してください。
特定のシーンのスペックは、/motion-plan またはユーザーから直接提供されます。
作業手順
1. プロジェクトを準備する
プロジェクトがまだない場合:
./node_modules/.bin/hyperframes init <name> --example blank --non-interactive --resolution landscape --skill motion-graphics
リポジトリのルートで単独の npx hyperframes は「Missing script」で失敗します — CLI はグローバルではありません。作成済みプロジェクト内では npm run check と npm run render が機能します。外部では、上記のバイナリへのパスを使用します。
このスキルの assets/ フォルダをプロジェクトに丸ごとコピーしてください、ファイル単位ではなく:tokens.css は @import "./fonts/fonts.css" でフォントを読み込むため、ディレクトリ構造が一致する必要があります。
cp -R <skill-path>/assets/. <project>/assets/
Onest と Unbounded フォントはローカルに配置されています(キリル文字とラテン文字の両方)。そのため、テキストはどのマシンでも同じようにレンダリングされます。GSAP、開始テンプレート、およびすべてのレシピは CDN から読み込むため、レンダリング時にはネットワークが必要です。ネットワークがない場合は、gsap.min.js を隣に配置し、<script src> を修正してください。
コンポジションへのトークンの接続は、次の1行で行います:
<link rel="stylesheet" href="./assets/tokens.css" />
2. コンポジションを構築する
HyperFrames のコントラクト:window.__timelines["main"] 内の単一の paused タイムライン。各 timed 要素は class="clip"、data-start、data-duration を持ちます。詳細は /hyperframes-core にあります。構造に疑問がある場合はロードしてください。
テクニックが成功するかどうかを決定する3つのこと:
タイミングとカーブは文字通りコピーしてください。 PiP の成長における power2.inOut と power2.out の違いは、カメラの移動と画像の拡大の違いです。プッシュジョイントにおける power3.inOut と power4.inOut の違いは、なめらかな移動と急な動きの違いです。
テクニックを維持し、スペックの文字にとらわれないでください。 スペックのフレーム単位の説明が宣言された easing と矛盾する場合(成長率がカーブと一致しない場合)、easing が優先されます。それは動きがどのように知覚されるかを定義します。スペックが、クリップがトリミングされる時点でオブジェクトがフレーム外に出ない振幅を与える場合、実際の1920×1080ジオメトリに合わせて振幅を再計算し、そのことを伝えてください。
認識されないテクニックは強化する必要があります。 形式的に正しいが視覚的に確認できない実装は、完了した作業ではありません。明るい背景上の塗りつぶしの遷移は、フロントマーカーを追加しない限りほとんど見えません。中間で両側が空のジョイントは、表示するものは何もありません。
テクニックが techniques.md にも techniques-observed.md にもない場合 — スペックのフレーム単位の説明に従って構築しますが、まずその中で 分岐点 を見つけてください:それがフレームの成否を決定する解決策です。通常、これはカーブではなくジオメトリです — どれだけシフトするか、グループの中心はどこか、何がエッジを越えるか。スペックを書いた人はフレームを見たことがありません。彼はおそらく分岐点に気づいていません。自分で決定し、フレームで検証し、必ずレポートで名前を付けてください — それは次の人のスキルに追加されます。
3. 確認する
npm run check
エラーも警告もゼロ。コントラストとレイアウトの監査は、テクニック自体に対して警告を出すことがあります — ぼやけたバックプレート、ジョイントでのシーンの重なり、抑えられた隣接要素。テクニックと実際の問題を区別してください:実際の問題は修正し、テクニックは標準のオプトアウトでマークします。各オプトアウトは、厳密にそれ自身のチェックのみを無効にします — テーブルは gotchas.md にあります。ランダムに適用してはいけません:data-layout-ignore はコントラストも削除するため、その下のテキストは報告から静かに除外されます。
同時に、サイドカー *.motion.json を配置してください — check はそれを自動的にピックアップし、レンダラーが使用するのと同じ巻き戻しタイムライン上で動きの意図をチェックします。これは、「レンダリングして見る」に最も近い自動的な代替手段です:巻き戻しがスキップした入り口、壊れた stagger 順序、停止したショットをキャッチします。フォーマットは gotchas.md にあります。
4. 目で確認する — これは必須のステップです
../node_modules/.bin/hyperframes snapshot . --frames 8 -o snapshots
snapshots/contact-sheet.jpg を Read で開いてください — これは画像であり、あなたはそれを見ることができます。check は、フレームが空である、テキストが小さい、ブロックがランダムに配置されている、とは言いません。
フレーム0は特に注意して確認してください — これは最も一般的な失敗です。スタイルのルールでは、シーンは静止状態や空白からではなく、すでに動きのある状態で始まります。ゼロフレームで空白またはすべてが構築済みで静止している場合、テクニックは最も目立つ場所で壊れています。
特に難しいポイントで、スポットフレームを別途キャプチャしてください:
../node_modules/.bin/hyperframes snapshot . --at 1.45,1.55,1.675,1.8 --no-end -o snapshots-detail
どのポイントを選択するか:テクニックにジョイントがある場合 — ジョイントの中央と両側のフレーム。ジョイントがない場合、コンポジションの再計算の瞬間をキャプチャしてください:リストの圧縮、ブロックの再配置、アクティブ要素の切り替え。これらの時点でレイアウトが崩れ、均等な8フレームでは見えません。
議論の余地のある箇所(グラデーション、小さなフォントサイズ)は、フルサイズの PNG で確認してください:JPEG コンタクトシートは、サイズとバンディングの両方で誤解を招きます。
画像が良くなるまで繰り返してください。最初のバージョンはほとんどの場合小さすぎます — これが最も一般的な間違いです。1920×1080 のフレームは見た目よりも大きいです。
5. レンダリングする
npm run render
MP4 の配置場所
自分のプロジェクトの renders/ フォルダのみ。 レポートでファイルへのパスを指定してください。完成した挿入物を共有フォルダに配置するのは、動画全体をアセンブルする担当者です。彼だけが、タイムライン上での名前と、どれが承認されたかを知っています。
これは形式的なものではありません。ある動画では、9人のビルダーが結果を3つの異なる場所に配置し、2人が renders/ を完全に削除し、1人が「オーケストレーターが確実に見つけられるように」とファイルを2つのフォルダに重複して配置しました — その結果、オーケストレーターは find でディスク全体からレンダリングを探さなければなりませんでした。CLAUDE.md の「最終的な動画は output/ に」というルールは、完成した動画に関するものであり、アセンブリ用の挿入物に関するものではありません:挿入物は半製品です。
作業プロジェクトフォルダも 削除しないでください。シーンが承認された後、オーケストレーターによって削除されます。それまでは、修正のために必要になる可能性があります。
フレーム上のオーバーレイ:コンポジションにプレートを埋め込む
オーバーレイ — ガラスパネル、タイトル、用語集 — は、その下の特定のフレームを想定して設計されており、直感的でない技術的な結果をもたらします:backdrop-filter は、コンポジションに存在しないものを認識しません。 オーバーレイを透明な背景でレンダリングし、編集プログラムで重ねると、ガラスは空の部分をぼかし、つまり何もぼかさず、パネルは平らなフィルムになります。
したがって、オーバーレイのコンポジションは挿入とは異なる方法で構築されます:
# シーンのタイムコードに正確に一致するソースの一部をプロジェクトの assets に配置
ffmpeg -ss 20.0 -i <source> -t 4.0 -vf "scale=1920:1080,fps=30" -an \
-c:v libx264 -crf 16 -preset veryfast -pix_fmt yuv420p -y assets/plate.mp4
<video id="plate" class="clip" data-start="0" data-duration="4" data-track-index="0"
src="./assets/plate.mp4" muted data-layout-ignore></video>
プレートはゼロトラックとして配置され、data-layout-ignore でマークされます — 監査対象外です。その上にあるガラスは実際に機能します。出力は通常の MP4 であり、編集時にその部分の代わりに配置され、重ねられるわけではありません。プレートからの音声は削除されており、オーディオトラックはソースから取得されます。
代替案 — 透明性を持つ --format mov — は、編集者がアルファを明示的に要求し、レイヤーを自分で配置する準備ができている場合にのみ必要です。
報告すべきこと
簡潔に、10〜15行:何ができたか、MP4へのパス、どの部分が難しかったか、どのように解決したか、何が不完全に残っているか。コードは要約しないでください — それはファイルにあります。
スペックからの逸脱は明示的に述べてください。 振幅を再計算した場合、カーブを変更した場合、スペックにない要素を追加した場合 — そのことを述べ、理由を説明してください。スペックを書いた人はフレームを見ていません。あなたは見ました。報告された逸脱は発見であり、沈黙された逸脱は編集時の驚きです。
完了と見なされる条件
checkがクリーンで、MP4がレンダリングされている。- テクニックが目で見てフレーム上で認識でき、「形式的に実装された」だけではない。
- パレット、スケール、デザインシステムのルールが遵守されている。
- 決定論的:シーンに疑似乱数が含まれている場合、同じタイムコードの2つのスナップショットは同一のSHA-256を生成する。