マーケティングビデオ
このビデオは1つのHTMLページであり、すべてのピクセルが時間の純粋な関数である seek(t) によってフレームごとにモーションブラーとともにレンダリングされ、サウンドトラックはミリ秒単位で配置されます。ブランド固有のものはすべてインテークから取得され、何も仮定されません。ユーザーとはその言語で会話してください。以下で SKILL_DIR はこのファイルが含まれているフォルダを指します。
0. 初回実行: ツール
bash SKILL_DIR/scripts/check_deps.sh
このスクリプトは、このマシンに不足しているもの(node 18+、ffmpeg、python3、numpy)と、そのシステム向けのインストールコマンドをリスト表示します。不足しているものがあれば、各ツールの目的を平易な言葉でユーザーに伝え、コマンドを表示し、インストールするかどうかを一度だけ確認します。インストールは「はい」の場合にのみ実行し、その後チェックを再実行します。パスワードが必要なコマンドや独自のインストーラー(Homebrew、sudo)を起動するコマンドは、ユーザーが自身のターミナルで実行するものです。そのコマンドをユーザーに伝えて待機します。その間にインテークの質問をしてください。ステップ2まではツールに依存するものはありません。
1. インテーク: 最初にすべてを尋ねる
references/intake.md の質問を1つのメッセージで送信します。何かを構築する前に以下が必要です:
- 被写体: ビデオが何を伝えるか、誰に宛てて、どこに投稿されるか;
- インスピレーションビデオ: 最も有用な単一の入力;
- デザインシステム、またはニュートラルなデフォルトを使用する明示的な許可;
- UIスクリーンショット: ビデオが製品を表示する場合。
すべての入力は最終的にローカルファイルになる必要があります: ダウンロードを依頼するか、ツールが許可する場合は自分でフェッチしてください。その他すべてには規定のデフォルトがあります。必須項目が1回のリマインダー後も不足している場合は、それに依存する処理を開始しないでください。インスピレーションについては、エンジン独自のスタイル(1つの連続的にモーフィングする形状)を提供し、ユーザーが受け入れた場合にのみ続行します。
プロジェクトを作成し、回答をその brief.md に記録します:
bash SKILL_DIR/scripts/setup.sh ~/marketing-videos/<slug> # テンプレート、スクリプト、ローカルPlaywright
cd ~/marketing-videos/<slug> # 以降のすべてのコマンドはここから実行
2. インスピレーションを読み取り、読み取り内容を確認する
python3 inspect_inspiration.py <video> # コンタクトシート、カット、ショット長、音楽テンポ
両方のシートを確認し、最大10行のスタイル読み取りを記述します: 連続モーフィングかカットか、ビートごとのイベントと状態が保持される時間、カメラの動き、イージング、パレット、タイポグラフィ、サウンド。それを表示し、何を保持するかを尋ねます。ユーザーからの書面による指示(ルール、禁止リスト、構造)は読み取りを上書きします。音楽が提供された場合は、今すぐ測定し(python3 inspect_inspiration.py track.mp3)、グリッドの前に CONFIG.bpm をそのテンポに設定します。
3. ビートグリッド上の状態リスト、そして待機
ビートごとに1行のテーブル: 時間、画面上の状態、どのように動くか、カーソルの動作、カメラ。references/craft.md にルールがあります。ユーザーが承認するまで何も構築しないでください。 ここでの反復は1分で済みますが、ビルド後は1時間かかります。
4. ビルド
scene.html を編集します: CONFIG(テンポ、小節数、ループまたはエンドカード、トークン、フォント)、その後サンプルシーンを置き換えます。最初に references/craft.md を読んでください: これにはエンジン、モーションルール、および注意点が含まれています。
- フォント: ブランドのファイルを
fonts/に配置し(Google Fontsはwoff2としてダウンロード)、fonts.jsonにリストします。CONFIG.fontはそれらのファミリーの1つを最初に指定します。python3 build.pyがそれらをインライン化します。 - ロゴ: ブランドのSVGをそのまま貼り付けます。ワードマークをフォントで再入力しないでください。
- スクリーンショットは、HTMLで簡略化して再現するための参考であり、画像として貼り付けられることはありません。
- 実際の映像:
python3 frames.py --src clip.mp4 --name <who> --sheetを使用してクリーンなウィンドウを選択し、フレームのアスペクト比にクロップして抽出します。映像は、そのサウンドがステップ5でミックスされない限り、無音で再生されます。
5. 検証、そしてサウンド
python3 build.py && node preview.mjs # フォーマットごとのコンタクトシート、ビートごとに1フレーム、コンソールとフォントエラー
node checks.mjs # ボタン内のクリック、ポインターが読み取りテキスト上にないこと
両方ともデフォルトで1440x1440および1080x1920になります。他のサイズは 1920x1080 として渡します。すべてのシートを確認し、グリッドから外れているもの、詰め込みすぎているもの、スマートフォンサイズで読みにくいもの、または着地すべき時に遷移途中のものを修正します。checks.mjs はすべてのフォーマットで合格する必要があります。新しいクリックと保護するテキストは window.CHECKS で宣言します。
python3 audio.py は、シーンのテンポでベッドを合成し、各 window.CUES サウンドを測定されたピークに配置します。--music track.mp3 --offset <s> はユーザーのトラックを使用し、--voice clip.mp4:at:start:dur は撮影された人物の声をミックスし、その下の音楽を下げます。
6. レンダリングと納品
node render.mjs scene.built.html 1440 1440 out/<slug>-v1-1x1.mp4 audio/bed.wav
node render.mjs scene.built.html 1080 1920 out/<slug>-v1-9x16.mp4 audio/bed.wav
納品される各バージョンには新しいファイル名が付けられ、そのソースは納品時に versions/v<N>/ にコピーされます。新しいレンダリングが完了するまで、納品済みファイルを上書きしないでください。MP4をユーザーが希望する場所にコピーし、何が変更されたか、どのチェックが合格したか、ユーザーに代わって行った判断事項を報告します。
7. 反復
craft.md#iterating に従ってください: 名前が付けられたもののみを変更し、振り付けをやり直すのではなく時間を引き伸ばし、変更のたびに preview.mjs と checks.mjs を再実行します。
必要条件
フォルダは自己完結型です。スクリプトにはnode 18+、ffmpeg、およびnumpyを含むpython3が必要です(ステップ0で不足しているものを検出してインストールします)。setup.sh は各プロジェクトにPlaywrightのChromiumを追加します。プロジェクトが独自のルールを持つリポジトリに存在する場合は、それに従い、レンダリング、映像、フレーム、node_modules をバージョン管理から除外してください。