reels-dopamina

アプリ向けドーパミンReels

このスキルは、視聴者のある痛点を突いて製品を販売する短尺縦型動画を生成し、最初から最後まで高い滞留率を実現します。プロセスは人間の承認を挟んで2つのフェーズに分かれています。なぜなら、音声・BGM・画像の生成にはクレジットと時間がかかり、脚本を間違えてレンダリングまで進んでから気づくのは最もコストの高い無駄だからです。

フェーズ1（低コスト） ブリーフィング → 製品の事実確認 → 脚本 → 承認
フェーズ2（高コスト） アセット → タイミングマップ → 合成 → ビジュアルレビュー → レンダリング → 検証

何よりも先に：ブランドプロフィール

brands/<ブランド名>.md にプロフィール（色、フォント、ロゴSVG、ブランド名の発音、CTA、オファー、Instagramの@、アプリのスクリーンショットの場所）がないか探してください。存在しない場合は、brands/_modelo.md を基に、ユーザーが教えてくれた情報や、製品のコード/サイト（CSSの色トークン、ブランドコンポーネントのロゴ、価格ページなど）から見つけた情報を使って新規作成します。brands/vehiro.md が完全な例です。

フェーズ1 — 脚本

1. 簡易ブリーフィング

不足している情報だけを質問します：製品/ブランド、ターゲット（購入を決定する人）、痛点（または「なぜあなたを選ぶのか」）、声（女性/男性、またはナレーションなし）、目標尺（30～50秒）、フォーマット（デフォルトはReels 9:16）。ユーザーが「お任せします」と言った場合は、あなたが決定し、その選択理由を一行で説明してください。

2. 痛点の選定

動画1本につき1つの痛点。優先順位は、(a) ターゲットが金銭的または自尊心的に感じる痛点、(b) 視覚的に表現できる痛点、(c) 製品が実際に解決でき、かつ実在する画面で示せる痛点。同じシリーズの過去の動画で使った痛点は避け、選択前に既に使ったものをリストアップしてください。

3. 製品の事実確認

脚本の約束事が1つ残らず、コード、画面、またはサイト上で実際に存在し、説明通りに動作することを確認します。これにより、虚偽広告と手戻りを防ぎます。このチェックで実際に発覚した例：ダッシュボードがステータスごとに車両を分離していなかった（リストのフィルターのみで分離していた）；「リアルタイム」が実際は「常に最新」（誰かが更新したときにステータスが変わる）；無料トライアルが7日間（コード上の定数）；アプリが生成するWhatsAppメッセージには正確な定型文があり、それが動画のセリフになった。もし機能が存在しない場合は、約束を変更し、捏造しないでください。

4. 脚本の作成

references/copywriting.md（コピーの構造とルール）と references/hooks-catalog.md（検証済みフック）を読んでください。各シーンのエフェクト選定には references/dopamine-fx.md を使用します。

常に以下のフォーマットで、チャット内テキストとして出力します：

## Reels N — "<痛点の名前>"
**痛点:** <一文>。 **製品が実際に持つもの:** <確認した箇所の箇条書き>。
**声:** <声の名前> · **尺:** ~XX秒

### フック (0～3秒)
- **映像:** ...   - **音:** ...   - **セリフ:** "..."
- なぜ引きつけるか： ...

### 脚本
| 時間 | セリフ | 映像とエフェクト |
|---|---|---|
| 0～3秒 · フック | ... | ... |
| ... · 煽り | ... | ... |
| ... · 打撃 | ... | ... |
| ... · 転換 | ... | ... |
| ... · 解決 | ... | ... |
| ... · CTA | ... | ... |

### あなたへの判断項目
- <実際の判断のみ：声、代替フック、緩和が必要な約束>

出力後は一旦停止し、承認を待ちます。脚本の修正は低コストです。修正があれば適用し、変更箇所のみを再提示します。

フェーズ2 — 制作（「制作して良い」と言われた後でのみ）

プロジェクトフォルダ（例：marketing/videos/<スラッグ>/ に assets/）を作成し、templates/base.html を <スラッグ>/index.html に、templates/fx.js を <スラッグ>/fx.js にコピーします。

5. アセット

何かを生成する前に references/audio.md と references/elevenlabs.md を読んでください。

• ナレーション: ElevenLabsで2テイク収録（eleven_v4、[urgent] や [short pause] などのタグを使用）。ブランド名は発音通りに書きます（例：VEHIRO → 「ヴェリロ」）。
• BGM: 転換まで緊張感があり、その後アニメーションドロップのあるインスト曲。
• フック用効果音: サイレン、ゲームショーのブザー、レジスターなど（短く、約1秒）。
• リアルな画像（オプション）: 「販売員のスマホ写真」— references/elevenlabs.md の1日あたりの制限と横長フォーマットを参照。
• アプリの実画面: モバイル3倍サイズ（1170x2532）のスクリーンショットは、スマートフォンモックアップ内で最適に見えます。 ElevenLabsが使えない場合やクレジットがない場合：ナレーションなしのバージョンを提案するか（キネティックタイポグラフィでメッセージを伝える）、ユーザーがクレジットを追加するのを待ちます—許可なく音声やプロバイダーを変更しないでください。

6. 音声の検証

python scripts/transcribe_check.py <voice.mp3> を実行し（ローカルに watch スキルがあればそれを使い、なければWhisper）、テキストと比較します。単語に誤りのないテイクを選択します。一部だけ誤っている場合（例：「パレアガワ」→「パレアガワ」）、その部分だけ再生成し、scripts/splice_phrase.py で繋ぎ合わせます。既に完成した動画に合わせて単語を差し替える必要がある場合は、テイク全体を再生成し、scripts/align_phrases.py を使用します。

7. タイミングマップ

• python scripts/timing_map.py voz.mp3 → 各フレーズの開始/終了時間のリスト（無音部分を含む）。
• python scripts/music_drop.py trilha.mp3 → ドロップの正確な秒数（低音のエネルギー）。
• V（音声の遅延、0.25～0.9秒）を定義し、ドロップが転換のフレーズに合うようにBGMを配置します：BGM開始 = (転換フレーズ開始 + V) - ドロップ。
• BGMが短い場合：python scripts/extend_music.py trilha.mp3 trilha-ext.mp3 --cut <s> --bars 2 --bpm <bpm>（アニメーション部分の小節をクロスフェードで繰り返します）。
• 音声が約48秒を超える場合：atempo で5～8%加速します（ピッチは維持）。 各セリフのアニメーションはフレーズのタイミングに合わせます：動画時間 = 音声時間 + V。

8. 合成

references/dopamine-fx.md と references/hyperframes.md に従って、index.html でシーンを構成します。最も重要なルール：シーンは0.2～0.5秒重なり、動きのあるトランジションにします；約2秒ごとに視覚的な「報酬」を配置；上部にプログレスバー；ReelsのUIで隠れる範囲（上部約220px、下部約380px）に重要なテキストを配置しない。

9. ビジュアルレビュー

npx hyperframes lint .（エラー0）と npx hyperframes snapshot . --at <キーとなる時間> --no-end -o snapshots を実行します。コンタクトシートを確認：テキストが切れていないか、重なりで読めない部分がないか、空のシーンがないか、アニメーションしていない要素がないか。問題を修正し、影響を受けた時間だけ再度確認します。何かが表示されない、または時期尚早に表示される場合は references/pitfalls.md を参照してください。

10. レンダリングと検証

npx hyperframes render . -o ../renders/<slug>-9x16.mp4 -f 30 -q delivery を実行後、python scripts/verify_render.py ../renders/<slug>-9x16.mp4：尺、1080×1920、平均音量（約-18～-20 dB）を確認し、文字起こしを行います。フックが文字起こしに現れない場合、効果音が音声をマスキングしています—効果音の音量を下げてください（references/audio.md 参照）。

11. 納品

MP4を送付し、平易な文章で以下を説明します：フック、各シーンの役割、使用したエフェクト、そして正直な注意点（文字起こしで異なる発音が検出された場合、例示の数字、消費したクレジット、耳で確認できなかった点）。

参考資料

• references/copywriting.md — 7幕構成、コピーのルール、トリガー。
• references/hooks-catalog.md — 検証済みフック（映像＋音＋セリフ）とそれぞれの使用タイミング。
• references/dopamine-fx.md — エフェクト、リズム、スムーズなトランジションのカタログ。
• references/audio.md — 音声、発音、ミキシング、ドロップ、編集。
• references/elevenlabs.md — コネクター、割り当て、制限、注意点。
• references/hyperframes.md — 合成の骨格、オーディオ、リント、スナップショット、レンダリング。
• references/pitfalls.md — 解決済みのバグとその修正方法。
• examples/ — 実際のシリーズ（VEHIRO）で承認された脚本の例。トーンとフォーマットの調整用。