解説スクリプト
スクリプトはシーンの短いリストです。各シーンには1つ以上のナレーション行と1つのビジュアルがあります。 これは音声をオフにしてスクロールする視聴者向けに作成されるため、すべての行はキャプションとしても機能する必要があります。
長さ
- 30～60秒、45秒を目標とします（
src/settings.tsのtargetSeconds）。 - これは英語で約75～140語です。数えてください。同じ内容の場合、スペイン語は英語より約15～20%長くなります。
構成
- フック（最初の3秒以内）。 驚くべき発見、または具体的な質問。「この動画では…」「今日は…について話します」や挨拶は禁止。イントロカード。
- セットアップ。 何がテストされたのか、なぜそれが重要なのかを1～2行で。
- 実験を一枚の絵で。 メカニズムやデザインを1つのビジュアル（フロー、比較図）として表現。メソッドセクション全体ではなく、1つのアイデア。
- 発見とその正確な数値。 記事に書かれている通りの数字（「14/20 vs 4/20」「83%」「p = 0.0018」）：同じ丸め、同じ単位。
- その意義（So what）。 発見がそれを活用する人にとって何を意味するのか。記事の主張よりも強く言わない。
- アウトロカードの行： 「More at javieraguilar.ai」（スペイン語： 「Más en javieraguilar.ai」）。
語り口
- 一人称。記事が書かれているように。「I gave the planner...」「What I found...」。
- 主張は記事と同じくらいニュアンスを込めて。曖昧表現（「on these runs」「in this setup」）はそのまま残す。
- 短い話し言葉の文。1行に1つのアイデア。記事が説明していない専門用語は使わない。
キャプション
- キャプションはナレーションテキストから焼き付けられ、最大2行で約32文字。
- 画面上で毎秒最大17文字（
npm run lintでチェック）。読み上げが速すぎる行は、早口にするのではなく単語数を減らす。 - キャプション内の数字は記事の通りに書く。TTS（テキスト読み上げ）で異なる読み方をする必要がある場合は、行に発話形を指定する（
narrationスキルを参照）。そのためにキャプションを変更してはならない。 - ナレーション内の長いURLやコード識別子は避ける。改行が乱れ、読みにくくなる。
英語とスペイン語
- 英語とスペイン語のペアを行ごとに一緒に書き、両方のカットが同期するようにする。スペイン語はオプション：動画が英語のみの間は、スペイン語のテキストは空のままにする。
- スペイン語の行は同じ内容を伝える。逐語訳ではなく、英語と同じくらい短く保つ。
シーンごとのビジュアル
すべてのシーンにビジュアルアイデアが割り当てられ、ライブラリのコンポーネント（explainer-animationを参照）にマッピングされます：
| ビジュアルアイデア | コンポーネント |
|---|---|
| 1つの数字がカウントアップするヘッドライン図 | Counter |
| 2～5つの値を並べて表示 | BarCompare |
| パイプライン、引き継ぎ、壊れたリンク | FlowDiagram |
| 記事の根幹をなすセンテンス | KeyQuote |
| 2～4つの図を一度に表示 | StatGrid |
| フックとクローズ | intro / outro cards |
適切なコンポーネントがない場合は、そのシーンに 「bespoke」 とフラグを立て、アニメーションの1行説明を添える。グラデーション上のテキストだけの動画は避ける：各記事には、そのメカニズムを示すビジュアルを少なくとも1つ含める。
スクリプト形式
script.mdをテーブルとして記述する。ナレーション行ごとに1行：
| シーン | コンポーネント | EN行 | ES行 | ビジュアル | ソースセンテンス |
|---|
- 「ソースセンテンス」は、行内のすべての数字と主張について記事を引用する。
- 単語数（英語）と推定長さを最後に記述する。
- 何かを作成する前に、承認のために提示する。