guion-video-corto は何をしますか？
アーキタイプと意識レベル別の短尺動画
このスキルは「汎用的な動画」を書きません。まずその動画がどのタイプの動画であるか、つまり、その意図と視聴者の意識レベルを特定します。次に、対応するプレイブックを読み込み、すべてに共通するリテンションエンジンの上に構築します。外部の数値は仮説として扱います。本当に価値があるのは、自アカウントのデータです。
成果物: ビート・バイ・ビートの台本（発話内容 + 画面上テキスト + 映像プラン）+ プラットフォーム別キャプション + 使用したアーキタイプと意識レベル。動画自体は生成しません：別途撮影または編集します。
1. 背骨：意識レベル（Eugene Schwartz）
これにより、台本の攻撃性が決まります。スタイルの問題ではなく、誰が見ているかに依存します。
- 無自覚： 自分に問題があることに気づいていない。
- 問題に気づいている： 痛みを感じているが、解決策があることを知らない。
- 解決策に気づいている： 解決策が存在することを知っているが、あなたのものを知らない。
- 製品に気づいている： あなたを知っているが、確信していない。
- 最も自覚している： 準備ができており、オファーだけが必要。
黄金律： すでに熱い（レベル4～5）相手にのみ攻撃的になれる。冷たい（レベル1～2）視聴者にハードクロージングは怖がらせる。だから発見系オーガニック動画は売らず、リターゲティング広告は直接オファーに行く。
2. 支配的な指標
配信戦略は早期リテンションが決める。視聴回数ではない。以下の順序で見る：
- 3秒時点のリテンション、つまりフックの後も何人が見続けているか。フックの成績。
- 平均視聴時間、動画の中盤が持続しているかを知るため。
- リーチあたりのシェア数（シェア ÷ リーチ）、最も強力なシグナル。
- 非フォロワーへのリーチ、動画が拡散したかを知るため。
- リーチあたりのフォロワー獲得数、プロフィールが注意をコンバージョンしたかを知るため。
魔法の数字はない。 「3秒時点70%」のような目標は検証可能なソースなしに広まっている：仮説としてのみ使え。本当の基準は自アカウントの中央値。 その中央値の3倍を超えた動画はシグナル。1.5倍未満は普通の日。
数ヶ月を節約する診断：
- 視聴回数はあるがフォロワーが増えない動画は、プロフィールに問題がある。フックの問題ではない。
- 視聴回数がない動画は、フックに問題がある。
書き直す前にこの2つのケースを分けよ。
3. ルーター
そのピースが属するアーキタイプを特定し、対応するプレイブックを読み込む。ユーザーが言わなければ、質問するか、目標から推測する。
| アーキタイプ | 意識レベル | 台本の仕事 | 攻撃性 | 典型的なCTA | チャネル | プレイブック |
|---|---|---|---|---|---|---|
| 発見 | 無自覚 → 問題 | 見つけられること | 売りゼロ | フォロー / 保存 | オーガニック | playbooks/descubrimiento.md |
| 権威 | 問題 → 解決策 | 信じられること | ソフト | フォロー / コメント | オーガニック | playbooks/autoridad.md |
| 育成 | 解決策 → 製品 | 好まれること | ミディアム | キーワード → DM | オーガニック + ソフトリターゲティング | playbooks/nutricion.md |
| クロージング / 広告 | 製品 → より自覚 | 今すぐ選ばせること | 高い / 直接的 | 予約 / 購入 / 応募 | 広告（リターゲティング） | playbooks/cierre-ads.md |
| 推薦 | 検討 → クロージング | オファーを検証させること | ソフト～ミディアム | キーワード → DM | オーガニック + 広告 | playbooks/testimonio.md |
各ピースには1つの支配的な意図がある。ユーザーが「1つで複数」を望むなら、別々のピースに分けよ。
4. ワークフロー
- ブランド → プロフィール。
perfiles/<brand>.mdが存在すれば読み込む。なければperfiles/plantilla-marca.mdを使い、チャットで最低限のコンテキストを尋ねる。ブランドのデータを決して捏造してはならない。 - アーキタイプ → プレイブック。 セクション3のルーターを使い、対応するプレイブックを読む。そこに構造、フックの角度、攻撃性、CTAが書いてある。
- 共通エンジン。
references/motor_hooks_retencion.mdとreferences/formulas_hooks.mdを読む。3つの異なるフックの型を選ぶ（同じ型の3バージョンではない）。それぞれについて、発話内容と画面上テキストを別々に書く。 - チェッカーを実行する。 ターミナルがあれば
scripts/guion_check.py（セクション8）を実行し、各警告を修正する。ターミナルがなければ、手動で同じルールを適用する。 - 台本を構築する。プレイブックの構造とエンジンを使用。1ビートに1つのアイデア、連鎖するオープンループ。
- プラットフォーム。
references/plataformas.mdに従ってカットを調整する。同じカットをすべてのネットワークにそのまま投稿しない。 - キャプション + CTA を要求されたネットワーク用に、プレイブックとプロフィールが指定するCTAと共に作成する。
- 音読する。 「書かれた」文章は、誰かが口にするとすぐわかる。人が話しているように聞こえないものはすべて書き直す。
ユーザーがフックだけ、または構造だけを望む場合は、その部分を提供する。
5. リテンションエンジン（概要）
各プレイブックが適応する基本骨格：フック（0～3秒）→ テンション → 価値ビート＋ミニループ → 証明 → ペイオフ → CTA。 詳細は references/motor_hooks_retencion.md にあり。
すべての意図に共通するルール：
- アクションの途中かペイオフから始める。「こんにちは、この動画では…」は禁止。
- 冒頭にロゴやブランド名を入れない。
- フレーム1は動画が提供するものを約束する。
- 数秒ごとにカットまたは変更を入れ、30秒を超える動画では途中にリフックを入れる。
- 常に字幕：動画は音がなくても理解できなければならない。
- 画面上テキストは別の台本である。
- 1カードあたり最大6語。フックのカードはフレーム1に表示する。
- 1080×1920のセーフゾーンを守る：y=230より上、y=1440より下には何も置かない。右端230pxは空けておく。各プラットフォームのプレビューで確認する。
- ビートごとに映像プランを変える。 8秒間の固定画角では人は離脱する。
- 動画1本につきアイデア1つ。 台本に2つのアイデアがあれば、それは2本の動画だ。そう伝える。
- 数字は形容詞より先に。 実際の数字がなければ
{{あなたの数字}}を残し、その旨伝える。決して捏造しない。 - 推薦文や事例は、実際のもので許可を得ている場合のみ使用する。
- 1ピースにつき1言語： 発話、画面上テキスト、キャプションはすべて同じ言語。
規制対象ニッチ（健康、金融、法律など）
- 結果の約束や、ブランドが証明できない主張はしない。
- 配信するピースでは、視聴者の個人的属性（「太っていませんか？」「借金がありますか？」など）に言及しない。サービスと結果について話す。
- ビフォー／アフターは、実際のもので、同意があり、プラットフォームが許可している場合のみ。
6. ブランドプロフィール
ブランドはエンジンを変えず、装うだけ。
perfiles/plantilla-marca.mdは空のテンプレート。ブランドごとに一度記入し、perfiles/<brand>.mdとして保存する。- どのブランドのピースか指定されていない場合は、書く前に質問する。
- 不足している情報（価格、納期、保証、数値）は
[COMPLETAR]とマークし、ユーザーに通知する。
7. 成果物フォーマット
| # | タイム | 発話内容（音声） | 画面上テキスト | ビジュアル / プラン |
- 上部に3つのフックバリアント（A/Bテスト用）。
- 下部にプラットフォーム別キャプション。最初の行は短く好奇心をそそる内容で、「… もっと見る」の前に置く。
- 末尾にタグ：アーキタイプ + 意識レベル + プラットフォーム。
8. チェッカー（scripts/guion_check.py）
Python 3で動作し、依存関係はなく、スペイン語と英語に対応。
python scripts/guion_check.py hooks.txt # 1行1フック → 0～100のランキング
python scripts/guion_check.py --hook "無応答のフォームで40人の顧客を失いました。"
python scripts/guion_check.py guion.txt --beats --objetivo 30 --ppm 160 # 1行1ビート
フックの5つのチェック：
- 長さ： 3秒以内で話せる。
- 具体性： 数字、名前、期限がある。
- 利害関係： コスト、損失、過ちを挙げている。
- 前方負荷： 重要なことが最初の単語にある。
- 誰に話しているか： あなた/youを使うか、視聴者を特定している。
50未満ならまだフックではない。
--beats で台本全体をチェックし、以下をマーク：
- 3.5秒を超えるフック；
- 4.5秒を超えるビート；
- 具体性のないビートが3つ連続；
- ループの欠如（最終行がフックの単語を拾い直していない）。
視聴回数を予測するわけではない：挨拶、前置き、空虚なフック、長い台本を検出する。
フックには5つのレイヤーがあり、スクリプトは音声とテキストのみを測定する。納品前に、これらのレイヤーがすべて同じことを言い、最初の3秒に現れているか手動で確認する：
- 画面上テキスト；
- ビジュアル、つまりフレーム1に見えるもの；
- 音声、最初の発話行；
- サウンド：音楽、効果音、または意図的な無音；
- キャプション、その最初の行。
2つのレイヤーが競合する場合は、一方を削除する。
1分間あたりの単語数： すでに録画された動画を測定して（単語数 ÷ 分数）、実際の声でキャリブレーションする。測定されるまでは、スペイン語で160、英語で170を出発点として使用し、その旨伝える。
9. トライアルリールと「音声＋モーション」フォーマット
トライアルリールは、Instagramが最初に非フォロワーにのみ表示するリール。フックを無料でテストできるラボ。
- 各リールには、別のフックを使ったトライアルバージョンを持たせ、本当のA/Bテストを行う。
- 3秒時点のリテンション、非フォロワーへのリーチ、シェア、リーチあたりのフォロワー獲得数を見る。勝った方を通常公開するか、広告配信する。
- 持続可能なボリュームが望ましく、バーストは避ける。
音声＋モーショングラフィックスフォーマットはカメラ不要で、ボリュームを出すのに適している：
- 実際の音声は別録りし、アニメーションはAfter Effectsなどのツールで行う。
- 構造はエンジンと同一：フレーム1にテキストを表示するビジュアルフック → 各2～4秒のビート4～7つ、それぞれビジュアルチェンジ → ペイオフ → CTA。
- さらに、各ビートの画面上テキスト、ビジュアル要素、動き、長さを指示するアニメーションシートを提供する。
10. ファイル
playbooks/：各意図の構造。ステップ2で読み込む。perfiles/：各ブランドの声とアイデンティティ。ステップ1で読み込む。references/motor_hooks_retencion.md：フックのパターン、リテンション、字幕、A/Bテスト、完成した台本例。ステップ3で読み込む。references/formulas_hooks.md：スペイン語と英語の26のフックの型。ステップ3で読み込む。references/plataformas.md：Reels、Shorts、TikTokにカットを適応させる方法。ステップ6で読み込む。scripts/guion_check.py：ローカルチェッカー。