コードでモーション制作
動画はコードから生まれます。
私は、t クロックに基づいて各フレームを描画するプログラムを書き、フレームごとにレンダリングして MP4 にまとめます。そのため、16進数の色、ブランドフォント、数値はすべて正確に出力されます。これらはコードに直接書かれているものであり、生成 AI によって解釈されたものではありません。また、「30% 遅く」や「9:16 に変更」といった修正は、動画を最初から作り直すことなく、コードの1行を変更するだけで対応できます。
対応しないこと: 人物、場所、製品の撮影。ゼロからのフォトリアリスティックな画像生成。ブランドの推測。写真、動画、ブランドの実際の画面はファイルとして提供され、コードは提供されたものをアニメーション化します。
ベースとなる実写動画は、<video> タグではなく、フレームシーケンスとして取り込みます。
ffmpeg -i base.mp4 -q:v 3 frames/f%04d.jpg でフレームを書き出し、draw 内で floor(t × fps) + 1 のフレーム画像をオンデマンドで読み込みます。<video> タグを使用すると、レンダリングサーバーが Range リクエストに応答せず(シークが機能しない)、メディア接続が適切に閉じられないため(networkidle がタイムアウトする)問題が発生します。
必要条件: Python 3.10+、pip install playwright + playwright install chromium(スクリプトは chrome チャンネルを使用します。Chrome がインストールされていない場合は、abrir() 内でデフォルトの Chromium に変更してください)、ffmpeg および ffprobe が PATH に含まれていること。
このスキルのファイル:
assets/template.html: ユニーククロック、固定シード、イージング、ステガー、タイムラインバーとシーン名付きプレイヤー、セーフエリアを備えたエンジン。scripts/render.py: フレームごとに MP4 をレンダリングし、ショートバージョン用のセグメント、レビュー用のフレームシートを生成します。tecnicas.md: 7グループに分類された39のテクニックと、各テクニックのパラメータ、目的別の組み合わせ。examples/reel-resultado-8s.html: 完成した8秒のリール動画の例(数字シャッフル → バー → CTAと紙吹雪)、サンプルデータ付き。
作業ディレクトリ: 動画ごとに1つのディレクトリ(例: motion/<client>/<piece>/)。HTML、アセット(ロゴ、写真、フォント)、MP4、レビューシートはすべて同じ場所に置かれます。
ステップ 0 — ブランドキット
ブランドごとに一度だけ、マニュアル、ウェブサイト、またはクライアントから提供された情報に基づいてキットを作成します。
| アイテム | 入力方法 |
|---|---|
| パレット | 背景、テキスト、アクセント、数字の16進数カラーと役割。3〜4色。7色は色が多すぎてコントラストが不足します。 |
| フォント | 正確なフォント名。Google Fonts → <link>。独自フォント → フォルダにファイルを配置し、@font-face を使用。 |
| ロゴ | ファイル(SVG または透明 PNG)。ロゴをゼロから描画したり、言葉で説明したりしないでください。ファイルがなければ、提供を依頼してください。 |
| 動きのトーン | 2〜3の形容詞(落ち着いた、エネルギッシュ、プレミアム、ポピュラー)。イージングとカットを定義します。 |
| 数字 | 実際の値、小数点、フォントを含む。確認済みの数字がない場合 → 私が確認するか、画面上に 「サンプルデータ」 とラベルを付けて表示します。 |
| オファー、CTA、@/サイト | ブリーフから。緊急性を出すのは、実際の期限がある場合のみ。 |
| トラック | ブランドまたはストックサイトからライセンスされたファイル + BPM とドロップの秒数。 |
ブランドフォルダにキットを motion.md として保存します。2つ目の動画以降は、このファイルを読み込み、再作成は行いません。
ステップ 1 — トリアージ: 6つのコンポーネント
以下のチェックリストを一度に1つの質問ずつ埋めていきます。一度埋めた項目は再度開きません。ブリーフにすでに答えがある項目は、最初から埋めた状態で表示します。コンポーネントが不足している場合は、私が単独で決定しますが、ほとんどの場合、クライアントが想定していたものとは異なります。
1. フォーマット — アスペクト比 + 解像度 + 尺 + fps
2. シーン — 何が、どの順序で、各シーン何秒表示されるか
3. テキスト — 正確なフレーズを引用符で囲んで(クローズドリスト、リテラル)
4. テクニック — 名前を指定(tecnicas.md)
5. リズムと音 — イージング、ステガー、BPM / トラック
6. 納品形式 — MP4 · 6秒のショートバージョン · レビュー用プレイヤー · LP用ループHTML · 透明背景
プラットフォーム別フォーマット:
| アスペクト比 | 解像度 | 配置場所 | 標準尺 |
|---|---|---|---|
| 9:16 | 1080×1920 | Reels, Stories, TikTok, Shorts | 8〜15秒、最初のフレームにフック |
| 4:5 | 1080×1350 | IG/FB フィード | 6〜15秒 |
| 1:1 | 1080×1080 | フィード、一部の配置 | 6〜15秒 |
| 16:9 | 1920×1080 | YouTube、プレゼンテーション、大画面、ウェブサイト | 5秒(イントロ)から長尺説明まで |
| LP | ページ幅(例: 1440) | ヒーローセクションなど | 軽量な5〜10秒ループ、HTMLで納品 |
30 fps でほぼすべてカバーできます。60 fps は、ズーム、高速パーティクル、カメラの動きがある場合のみ必要です。広告の場合は、テスト用に常に同じ内容の6秒バージョンを作成します。
ステップ 2 — タイムコード付きスクリプト(ゲート)
コードを書く前に、スクリプトを表示して承認を待ちます:
フォーマット: 9:16 · 1080×1920 · 15秒 · 30 fps · トラック 120 BPM(カット: 3 / 7 / 11秒)
キット: 背景 #050505 · アクセント #E50914 · 数字 #FFDD00 · Morganite / IBM Plex Sans · logo.svg
| シーン | 時間 | テクニック | 内容 | テキスト(リテラル) | 入場 / 退場 |
スクリプトのルール:
- シーンは1つのアイデアにつき1つ。 1つのシーンに2つのフレーズが必要な場合は、2つのシーンに分割します。
- 各シーンは2〜4秒。 2秒未満では、テキストを読む時間が足りません。
- 読み取り時間: 単語3語につき1秒 + 1秒のマージン。数字のみ: 1.5秒 · 3語: 2秒 · 6語: 3秒 · 9語: 4秒。4秒以上かかるフレーズは1つのシーンとして長すぎるので、分割するか単語を削ります(承認済みコピーの単語を削る判断は、承認者のみが行います)。
- 入場と退場の方法を指定します。 退場は次のシーンへのつながりとなります。
- 9:16 と 4:5 では、最初の3秒間にフックを配置します。 メインメッセージは最後に残してはいけません。
- ビートに合わせてカット: ビート = 60 ÷ BPM 秒。小節 = 4ビート。シーンの尺が小節の倍数になると、動画が引き締まります(120 BPM: ビート 0.5秒、小節 2秒 · 128: 0.47 / 1.88 · 100: 0.6 / 2.4 · 90: 0.67 / 2.67)。
ステップ 3 — 構築
assets/template.html を作業ディレクトリにコピーし、CFG、BRAND、SCENES を埋めます。コードの法則は、これらによって MP4 がプレイヤーで承認されたものと一致することが保証されるため、重要です。
- すべては
tの関数です。setTimeout、Date.now()、CSS トランジション/アニメーション、またはフレーム間で状態を蓄積するものは使用禁止。1.4秒の時点での文字「3」は、常に同じ位置にあります。 - すべてのランダム値には固定シード(
rng(CFG.SEED + i))を使用します。これがないと、エクスポート結果が承認結果と異なります。 - シミュレーション(物理、ボイド、布):
tに関する解析式を使用するか、ロード時に固定ステップ(1/240秒)で事前計算し、フレームごとに保存してインデックスで読み取ります。draw内で積分してはいけません。 - フォントは
CFG.FONTS、アセットはCFG.ASSETSに配置します。エンジンは最初のフレームの前にこれらがロードされるのを待ちます。ロードされなかったフォントは、警告なしで汎用フォントにフォールバックします。これは最もよくあるエラーです。 - 9:16 のセーフエリア: テキスト、数字、ロゴは、上端から250px、下端から350px、右端から120px、左端から60px以内に配置します(概算値。アプリによって異なります)。
- 意図を持ったイージング:
inOutがデフォルト。テキスト、ピン、数字の登場にはback(オーバーシュート)を使用。linearは連続回転とスクロールのみに使用。bounceは落下するオブジェクトのみに使用。ステガーは文字間 0.07秒、カード間 0.15秒。 - 階層: 主要な数字は、シーン内で最も大きな要素にします。
- 各シーンの先頭に、時間とテクニックをコメントとして記述します。
長尺動画や負荷の高いテクニック(シェーダー、シミュレーション)を使用する場合: シーンごとに1つずつ構築します。シーンを構築し、レビューし、承認を得てから統合します。短尺動画(〜15秒、軽量な4シーン程度)は全体を一度に作成できますが、レビューは引き続きシーンごとに行います。
ステップ 4 — 公開前のレビュー
python ~/.claude/skills/motion/scripts/render.py peca.html --sheet auto --safe
各シーンの中間と最後のフレームを、セーフエリアを表示したシートを生成します。以下の方法でシートを確認します: 確認 → 拡大 → 確定(小さなテキスト、数字、ロゴの拡大部分を確認)。6つのレイヤーをチェックします:
| レイヤー | 確認内容 |
|---|---|
| 1. テクニック | 尺、解像度、fps がリクエスト通りか。先頭または末尾に黒フレームがないか。 |
| 2. ブランド | 16進数カラーが正しいか。ブランドフォントがロードされ、汎用フォントになっていないか。ロゴに歪み、回転、色の置き換えがないか。動きのトーンが適切か。 |
| 3. 可読性 | シーンごとに1つのアイデアか。各テキストはルールに従った時間表示されているか。テキストと背景のコントラストは十分か。主要な数字が最も大きいか。 |
| 4. プラットフォーム | アスペクト比が正しいか。セーフエリア外に要素がないか。最初の3秒にフックがあるか。音声なしでも機能するか。 |
| 5. データ | 数字は提供されたものと一致しているか(四捨五入なし)。ピリオドとフォントは正しいか。サンプルデータは画面にラベル表示されているか。捏造された数字がないか。 |
| 6. 権利 | トラックはライセンスされているか、ブランド所有か、生成されたものか。写真や画面は許可を得ているか。第三者のブランドは許可がある場合のみ使用。オファーの約束は検証済みか。 |
特定の瞬間を確認する場合: --sheet 1.5,2.9,3.1。問題が見つかった場合は、質問せずに公開前に修正します。
素材の3回目の確認は、承認者がスマートフォンで、音声なしで行うものです。 私はフレームを確認しますが、動画が再生されているときの感覚は確認しません。納品時には、明示的にこの確認を依頼してください。
ステップ 5 — レンダリングと納品
python ~/.claude/skills/motion/scripts/render.py peca.html # MP4全体
python ~/.claude/skills/motion/scripts/render.py peca.html --segments 0-3,11-15 -o peca_6s.mp4 # ショートバージョン
python ~/.claude/skills/motion/scripts/render.py peca.html --audio trilha.mp3 # トラック付き
レンダリング後: ffprobe で解像度、fps、フレーム数、尺を確認します。納品物:
- MP4(H.264, yuv420p, +faststart)、そのままアップロード可能。
- 6秒バージョン(広告の場合)。
- プレイヤー付きHTML(ブラウザで開く: 再生、一時停止、タイムラインバー、シーン名、セーフエリア)。承認者はこれを使用して、調整が必要な正確な秒数を指定します。
LP: 納品はループするHTML自体であり、MP4は含みません。軽量性が最優先です。ページの読み込みを遅くしてはいけません。
トラック: スキルはファイルをミックスし(--audio)、カットを指定されたBPMに合わせます。コードで生成されたトラックは実装されていません。リクエストがあった場合は、即興で対応せず、その旨を伝えてください。ライセンスのない第三者の音楽は広告を停止させるため、絶対に使用しないでください。
ステップ 6 — 調整
最初のバージョンはドラフトです。適切な調整は、シーンまたは秒数を指定し、変更量を指定し、保持すべきものを指定します。「シーン1(0〜3秒)で、+248% を1.5秒間固定してから切り替えてください。残りは変更しないでください。」影響を受ける部分のみを変更し、再レンダリングします。
| 症状 | 考えられる原因 | 修正 |
|---|---|---|
| ロボットのような動き | linear イージング | inOut、登場時は back を使用 |
| すべてが同時に動く | ステガーがない | 文字間 0.07秒、カード間 0.15秒のステガーを追加 |
| ブランドフォントと異なる | フォントがロードされていない | CFG.FONTS / @font-face とフォルダ内のファイルを確認 |
| 9:16 でテキストが切れる | 16:9 を想定したレイアウト | 1080×1920 のグリッドでセーフエリアを考慮して再作成 |
| プレイヤーがカクつく | パーティクルやシェーダーが多すぎる | プレイヤーでは要素を減らし、フルカウントはレンダリング時のみにする |
| エクスポート結果がプレイヤーと異なる | シードなしのランダム、または状態の蓄積 | ステップ3の法則1〜3に従う |
| ビートから外れたカット | シーンがBPMと関係ない | 尺をビートの倍数にする |
| 数値が間違っている | データが提供されていない | 提供されたリストを正確に使用し、四捨五入しない |
公開後: リテンション低下が最初の3秒にある場合、シーン1のみを交換します。中間のシーンにある場合、そのシーンのみを短縮または交換します。クリックが発生しない場合は、他の部分はそのままに、異なるエンディング(紙吹雪、回転するシール、QRコード)をテストします。一度に変更する変数は1つだけです。
アカウントライブラリ
承認された動画 → ブランドの motion.md に記録: 承認されたスクリプト、使用されたテクニック、HTML のパス、および可能であれば最初の7日間のメトリクス。次の動画は、過去に実績のあったものから始め、ブランドの標準エンディング(ロゴ + CTA 付きの最終署名)は再利用され、再作成されません。