ビジュアルディレクター は何をしますか?
優れたトーキングヘッドリールは、話者の発言をビートごとに視覚的に示します。リストは各項目が発話されるたびにチップとしてポップインし、数字はカウントアップし、「プロンプトを入力した」という発言にはチャットウィンドウが入力を表示します。これらのピースは小さく、頭の周り(顔の上には決して配置しません)に配置され、発言が話された瞬間に正確に表示されます。
これを build.json → "visuals": [...] で計画します。エンジンが配置、キットのルック、アニメーション、およびポップアップごとの効果音を処理します。
1. リールをビートとして読み取る
ロックされた行(edl.json)を単語インデックスとともに確認します:
python3 -c "import json;w=json.load(open('projects/<name>/transcript.json'))['words'];c=json.load(open('projects/<name>/cut.json'));[print(' '.join(f\"{x['i']}:{x['w']}\" for x in w[a:b+1])) for a,b in (l['words'] for l in c['lines'])]"
表示可能なものがあるビートすべてにマークを付けます:
- 何かのリスト
- 数字
- ツールやアプリ
- 動作(タイピング、送信、予約)
- Before/After または A vs B
- プロセスや手順
- システム
- 人物やストーリー
- 時間の範囲
- 却下されたアイデア
- 強調する価値のあるキーワード
フィラー、トランジション、および対象物のない感情には何も配置しません。
2. 各ビートに適したピースを選ぶ
| 発言内容 | ピース | 例 |
|---|---|---|
| リスト(「マーケティング、請求書、メール」) | chips、各単語が発話されるたびに1アイテム | 各アイテムに word を指定 |
| ドロップまたはクローズされるもの(「頭の中のあのタブすべて」) | "close": true の chips | |
| 数字(「100+のクライアント」「午後3時」「2人のチーム」) | number | "value": "100+", "label": "clients" |
| 行のキーワードまたはパンチライン | word(思考や質問の場合は "style": "type") | "text": "real *support*" |
| 拒否するもの(「50ステップはダメ」「別のアプリは嫌」) | strike | "pre": "No", "text": "50 steps", "strike_word": i |
| プロンプトの入力、AIへの質問、DMの送信 | chat | "prompt": "...", "reply": "..."(任意) |
| 売上、メッセージ、予約、通知 | notify | "app": "Stripe", "title": "New payment: €497" |
| 完了した手順、ToDoリスト、成果 | checklist | 各アイテムに word を指定 |
| 「ステップ1 / 最初のもの / パート2」 | step | "n": 1, "text": "*train* it" |
| 変化やプロセス(A → B → C) | flow | 各アイテムに icon と text を指定 |
| システム、接続されたツール、「すべてを1か所に」 | hub | center とアイコン付きの nodes |
| 時間の範囲(「1ヶ月後…3年後」) | scale | marks、from、to、move_word |
| クライアント、人物、誰かのストーリー | person | "name": "Abby", "note": "coach", "meter": 3 |
| A vs B、旧方式 vs 新方式 | versus | left(✗)/ right(✓)、right_word |
| ミームやGIF(ユーザーがリクエストした場合のみ) | gif | "file": "projects/<name>/memes/3.mp4", "caption": "me reading my old *captions*" |
| プロフィール、スクリーンショット、アプリ | phone | "image": "assets/profile.png"(ユーザーが提供した画像のみ) |
ピースのテキスト:
- チップ、ノード、ラベルあたり1~3語
- 話者の言葉を使用
- タイトルケースは可ですが、
chatとnotify以外では完全な文は禁止
アイコン: uv run tools/icons.py calendar money email で実際の名前を確認し、名前を推測しないでください。未知のアイコンがあるとビルドは停止します。
シグネチャーピース(ユーザー自身の素材が必要)
- ユーザーの周りを回るリール:
events内で{"type": "orbit", "word": i, "until_word": j}(visualsではなく)。- ユーザーのコンテンツや作品群に関する行(「私はこれを300個作ってきた」)で使用。
brand/reels/が必要。uv run tools/reels.py add <their reel files or a folder>で埋めてください:ユーザー自身がエクスポートしたリール、またはApifyが接続されている場合はプロフィールからダウンロードしたもの。- リールはユーザーの後ろと前を通過します。リールあたり最大1回。
- コールトゥアクション用のInstagramプロフィールフォロー(「フォローしてね」「BRAINとコメントして」):
{"kind": "profile", "word": i, "until_word": j, "keyword": "BRAIN"};keywordは任意で、コメントシートに入力されます。- 数字は
brand/instagram.json(name, handle, posts, followers, following, bio, avatar)からのみ取得します。ない場合は、実際の数字をユーザーに尋ねてください(またはApifyでプロフィールから取得)。決して推定したり捏造したりしないでください。 - グリッドは
brand/reels/を使用します。Follow(およびPost)時にタップ音が鳴ります。
- 別のクリエイターのリールをカードとして:
"handle": "creatorname"を指定したgif。@ハンドルが下に表示されます。- 常にクレジットを表示し、ユーザーが指定したクリップのみを使用します。
- カスタムインサート(適切なピースがない場合、例:使用しているアプリの再現、スクロールするファイルなど):サブエージェントを使用して構築します。下の「カスタムインサート」を参照。
モーション
キットの visuals.motion:gentle / snappy / bouncy / blur(ぼかしからシャープにポップイン)/ rise(落ち着いた編集風)。
wordポップに"style": "rise"を指定すると、各文字が行から一つずつ浮かび上がります。セリフ体のパンチワードに最適です。キットでvisuals.word_style: "rise"と設定するとデフォルトにできます。- キャプションは
captions.pop: "blur"でぼかしポップにできます。
カスタムインサート(並行サブエージェント)
- まずタイミングを固定: インサートがヒットする必要のある単語時間を、インサート独自のクロック(t = 0 は表示時)に変換します。
- インサートごとに1つのサブエージェントを生成し、バックグラウンドで並行して実行(Agentツール)、あなたはビルドを続けます。以下の内容を指示します:
- 何を表示するか、およびそれが再生される行。ユーザーからの実際のデータのみを使用し、それ以外は汎用のプレースホルダーにします。実在の人物は使用せず、ロゴのコピーもしません。
- 作業場所:
projects/<name>/inserts/<insert-name>/index.html。それ以外には触れません。 - サイズと持続時間: 例:900×700 px、2.6秒。描画するカードやウィンドウの外側は透明のまま。
- 契約:
window.renderAt(t)は、t 秒時点の正確な状態を描画します。タイマー、CSSトランジション、アニメーションは使用禁止。フレームは一つずつキャプチャされるためです。- ローカルフォントのみ(
fonts/free/からコピー)。 - テキストは最低24 px、ユーザーのキットカラーを使用。
- タイプされるテキスト:t の各ステップで1文字ずつ。
- ローカルフォントのみ(
- ビート: 時間を音声にロック。
- レンダリング:
uv run tools/insert.py <index.html> --dur <s> --w <w> --h <h>→insert.mov、アルファ付き。報告前に数フレーム確認。 - 報告: パス、正確な持続時間、ビート時間(効果音用)。問題があれば報告。
- 配置:
{"kind": "insert", "file": "…/insert.mov", "word": i, "width": 640}。ビートにsfx_extraクリックを追加。
ミームとGIF(リクエスト時のみ)
-
プロンプトなしでミームを追加しないでください。 ミームは好みの問題です。報告で提案することはできます(「ライン5にはDavid Roseの『えっ』が合いそう」)が、ユーザーが承諾した場合のみ追加します。
-
検索:
uv run tools/memes.py search "<show> <character> <emotion or words>" --project projects/<name>。例:「schitts creek david ew」や「the office michael no god please no」。- 最大6クリップをダウンロードし、
SHEET=…/memes/sheet.pngを出力します。シートを読み、ユーザーが説明した内容に合致するタイルを選びます(正しいキャラクター、正しい表情)。最初のものだけを選ばないでください。 - タイルには左から右、上から下に1~6の番号が振られています。
- 最大6クリップをダウンロードし、
-
ユーザー自身のファイル(「このGIFを使って」):
uv run tools/memes.py add "<file>" --project projects/<name>でmemes/own-1.mp4が作成されます。画像も使用可能。 -
配置:
{"kind": "gif", "file": "projects/<name>/memes/<n>.mp4", "word": i, "caption": "<their text>"}- キャプションは任意で、話者の言葉で、1箇所
*emphasis*を使用。デフォルトの長さは約2.6秒、または"until_word"を設定。 - ワイドクリップは頭の上に、縦長クリップは顎の下に配置されます。
"at": "full"で1.6秒の全画面カットアウェイになり、キャプションが上部に表示されます。
-
報告内で: 使用したものを明記し、シートを開いて(
open …/sheet.png)ユーザーが「ミーム3」と言えるようにします。他のクリップはすでにダウンロードされているため、fileを変更してリビルドするだけで差し替えられます。 -
キーがない場合(
MEMES=no-key):3分で完了する無料セットアップを提案します。- ユーザーが developers.giphy.com にアクセスし、サインアップしてAPIアプリ(SDKではない)を作成し、キーをコピーします。
- ユーザーがキーをチャットに貼り付けます。
- あなたが
brand/keys.jsonに{"giphy": "<key>"}として保存します。
ユーザーにファイルを直接編集するよう依頼しないでください。それまでは、ユーザー自身のGIFファイルは引き続き使用できます。
-
初回のみ言及: テレビや映画のミームを初めて使用する場合、それらのクリップはスタジオの所有物です。短い無音のリアクションGIFはInstagramで広く使用されていますが、わずかなリスクがあります。ユーザー自身のクリップにはリスクはありません。
3. タイミング(トランスクリプトの単語インデックス)
"word": iで、単語 i が発話されると同時にピースが表示されます。行の開始ではなく、ビートの最初の単語を使用します。- 各アイテムは独自の
"word"を持つため、各チップ、チェック、ノードは発話と同時に表示されます。これが編集された感覚を生み出します。 - ピースの終了:
"until_word": jで単語 j の後に終了- 指定がない場合、約2~3秒間、または最後のアイテムの1.4秒後に保持
"dur": 2.5で長さを直接設定
- 他の瞬間も単語にタイミングを合わせることができます:
strike_word、reply_word(chat)、right_word(versus)、move_word/move_end_word(scale)、meter_word(person)、close_word(chipsのクローズ)。
4. キットによる密度(kit.json → visuals.density)
| 密度 | 頻度 | 印象 |
|---|---|---|
calm | 8~10秒ごとに1ピース | クリーンな専門家による説明 |
steady | 4~6秒ごと | ほとんどのリール |
busy | 2~4秒ごと、ほぼ連続 | 高速「説明」スタイル |
すべての密度でのルール:
- 同時に表示されるピースは1つ。異なるゾーンにあり、同じビートに属する場合のみ、2つを重ねることができます。
- フック(最初の約3秒)やステートメントの間は絶対に表示しないでください。ピースでステートメントを置き換えることはできます:
busyでは、最大1つのステートメントを使用します。 - 同じ種類のピースを連続して使用しないでください。ただし、同じリストの続きの場合は除きます。
wordポップは、キャプションを凝縮または再構成する必要があり、単にミラーリングしてはいけません。同じ単語を表示する場合、エンジンはその間キャプションを非表示にします。それは機能しますが、「ビジネスの包括的な概要」に対する「全体のビジネス」のようなポップは、「非交渉事項」を繰り返すよりも価値があります。- ポップアップも表示される単語にハイライト(
highlight_words)を設定しないでください。 chatはそれ自体で完結した小さなストーリーを再生します:プロンプトを入力し(キークリック音)、送信し(スワイプ音)、AIが「思考中」を表示し、replyが指定されている場合はそれを表示します。入力終了後、送信のために約1.5秒の間隔を空けてください。短いreplyを話者の言葉で(説明する結果)入れると効果的です。- ピース間には短い呼吸の間隔(≥0.4秒)を残してください。
"at"は、デフォルトの配置が何かと衝突する場合にのみゾーン(top、left、right、chest)を上書きします。
5. ビルドと確認
uv run tools/build.py projects/<name>。ビルドは CHECK=…/check.png を出力します:各瞬間とポップアップの1フレーム。それを読み、以下の問題を修正します:
- 読めない
- 画面外
- 顔を覆っている
- キャプションと衝突している
- 間違った単語を説明している
SAFE ZONE:行にリストされている(Instagramのユーザー名、キャプション、いいね/コメント/シェアボタンの下に位置する)。すべて修正:ピースを移動("at")、テキストを短縮、または早く終了させ、なくなるまでリビルド。
画面に表示されるもの:
- ポップアップ、フック、ステートメントのテキストにダッシュ(—)は使用しないでください。代わりにカンマ、ピリオド、または改行を使用します。
- 実際の数字は、ユーザー自身のものであり、ユーザーが発言した場合のみ使用します。チャットウィンドウ、コメント、DMには汎用のプレースホルダーを使用し、実在の人物の名前や証拠としての捏造された結果は決して使用しないでください。
- 画面上に別のクリエイターの投稿やリールが表示される場合は、その@ハンドルを表示します。
その後、new-reelスキルと同様に引き継ぎ、次のような1行を追加します:「12個のポップアップ:4つのタスクのチップ、『プロンプト』のチャットウィンドウ、AIシステムのハブ…」。
ユーザーから依頼があった場合
-
「どんなグラフィックを追加できる?」 / 「オプションを見せて」: そのキットのカタログ動画が存在する場合は開きます(
projects/*/catalog-<kit>.mp4)。ない場合は最新のリールでレンダリング:uv run tools/build.py projects/<name> --catalog。すべてのピースが1回ずつ、そのキットのルックで、ラベル付きで表示されます。長々とピースを説明しないでください。 -
「もっと/少なくポップアップを」: このリールの密度を変更し、「常に」と言われた場合はキットの
visuals.densityに保存します。 -
「ここにチェックリストを」 / 「フォローと言ったらプロフィールを表示して」: その単語に正確にそのピースを追加します。
-
スタイル(「枠線付きカード」「落ち着いたアニメーション」「太いアイコン」):キットの
"visuals"ブロック:card:solid/outline/glassmotion:gentle/snappy/bouncyicon_stroke:1.5~2.5radius- 色:
accent、strong、alert、word、card_color;色名はキットから、または16進数値
プリセットではなく、そのキットを変更します。