kingsizestrj/SKILLS

Voltec のブランドキャラクターによる AI リアル動画（ElevenLabs + HyperFrames）

Voltec のブランドキャラクターが登場する AI 生成のリアル動画（リール、ストーリーズ、または 9:16 広告。キャンペーン、季節、テーマ、シナリオを問わず）の制作と編集：実際の場所に配置された AI キャラクター → 承認済みスナップショット → Veo 3.1 image-to-video → クローン音声によるナレーション → 字幕、CTA、QR コード付き HyperFrames 編集。ここに、ワークフロー、ルール、Voltec の固定要素、動画ごとに変更されるスロットが記載されています。JSON 本文、完全なプロンプト、長いコマンドは references/ にあります。

テスト済みリファレンスケース： リール「Verão Conectado」（2026年10月15日；20.5秒、1080x1920、24 fps；v5 で納品）。その値は「例：Verão Conectado」として表示され、デフォルトではありません。キャンペーンに固有のものはスロット（§1b）であり、入力された例は§7.2にあります。

• [Voltec] は、ブランドキャラクターを使用する Voltec またはサービスエリア（Grussaí および周辺地域）に固有の固定要素を示します。「例：Verão Conectado」は、リファレンスキャンペーンのみの値を示します。それ以外は、あらゆる AI 広告に適用されます。
• エビデンスレベルは references と同じです：[vivido] セッションで発生し確認済み；[aplicado] 調査または批評から得られ、承認済みテイクに組み込まれた；[pesquisa] 調査のみ；[não testado] ルールから派生したもので、生成は行われていません（§8）。
• $SKILL = この SKILL.md のフォルダ；$PROJ = 動画プロジェクトのフォルダ。シェル変数は Bash の呼び出し間で受け継がれません。セクション5のプリアンブルを各呼び出しで繰り返してください。
• 生成プロンプトは英語。クライアント向けテキスト、ナレーション、字幕はポルトガル語。
• API キーは ~/.config/elevenlabs/env（chmod 600）に保存され、scripts/el.py が印刷せずに読み取ります。echo、cat、env、curl -v、set -x をキーと共に使用したり、ファイル、プロンプト、メッセージに書き込んだりしないでください。
• あなたは音声を聞くことはできません。テキストと audio_event による STT、セグメントのスペクトログラム、ebur128 で確認し、クライアントが聞くべきタイムスタンプをゲートページにリストしてください。

1. 使用する場合

• [Voltec] ブランドキャラクターが登場し、誰かが実際に撮影したように見せかける必要がある、Voltec の AI 生成リアル動画：リール、ストーリーズ、または広告。あらゆるキャンペーン、季節、テーマ（季節限定プロモーション、企業広告、Wi-Fi のヒント、サポート、開業、ブラックフライデー）。サービスエリア内の実際のロケ地（Grussaí、Atafona、Chapéu do Sol、São João da Barra；ロケ地として機能するもの：§7.1）または屋内（家、店、車）。これまで生成されたことのないロケ地、衣装、フォーマットについては§8を参照。
• ElevenLabs API による生成：画像（スナップショット）、動画（Veo 3.1；Seedance は API でのリリース後、またはアプリでの手動操作が必要）、クローン音声によるナレーション、SFX、STT。
• HyperFrames での編集：フレーム単位のカット、ミキシング、カード、同期字幕、CTA、QR。
• すでに納品された AI 動画の調整：テイクのカット、バリエーションの変更、フレーズまたは CTA の変更、字幕付きバージョン、アイデンティティの洗練。
• 彼女がカメラに向かって話す場合（「彼女が話す」、「彼女は話す」、「彼女が説明する」）：references/modo-falando.md の「話す」モード。Veo 3.1 が発話を含むテイクを生成し、sts.py が音声を Radassa に置き換えます。[vivido: 2026年10月15日承認済みの13秒テスト]
• [GERAL] 他のブランドまたはキャラクター：[Voltec] ではないものは、適応させて使用できます（§7.1を置き換え、§1bのスロットを埋める）。リファレンスプロジェクト：/home/syllas/hyperframes/voltec-reels-ia/（Verão Conectado；読み取り専用）。
• 人物や生成されたシーンのないモーショングラフィックス（その場合は HyperFrames で十分）や、動画を伴わない Voltec のトピック（ネットワーク、GenieACS、TR-069）には使用しません。

品質基準（Voltec の要件。すべてのプロジェクトで標準として使用）：最大限のリアリズム。誰かが実際に撮影しているかのような、信頼できるカメラワーク。突然の切り替えのない、現実的な環境。手に持ったオブジェクトに異常がないこと。ライセンスされた（またはクライアント自身の）写真を使用した実際のロケ地をクライアントに提示。動画生成前に承認済みスナップショット。詳細なプロンプト（動き、肌、実際のノイズを含む音声収録）。生成前のベストプラクティスの調査。

1b. Voltec ブランドキャラクターを使用した新規動画のクイックスタート

1. この順序で読む： この SKILL.md（§7を含む）→ persona-e-marca-voltec.md §1–4 および §6–7 → ロケ地：Grussaí の場合は locais-grussai.md §1、§3（「他の季節」の表を含む）、§4；他の場所または屋内シーンの場合は、このファイルの §8、persona-e-marca-voltec.md §10、locais-grussai.md §7–§10 → prompts-principios.md §1（「プロンプトチェックリスト」を含む）→ シーンに最も近い prompts-moldes.md §2 のテンプレートのみ（2.1 友人が撮影、2.2 同じ場所でのポーズ、2.3 自撮り、2.5–2.6 動画；新しいシーン：2.9–2.10）。残りは、必要なフェーズになったら読む。prompts-moldes.md と persona-e-marca-voltec.md は Read の1回の読み取り制限を超えています。Grep でセクションを見つけ（例：^### 2\.9、^## 10）、offset/limit 付きで読み取ってください。
2. すでに決定済み（Voltec の固定要素；再度質問しない）： アカウントのキャラクター。アセット na7keiYvPpGArmyghOpk、pUgU1HXgmdqXfP02iR8T、ZY1iDcJLhPFklahPnvkM はすでにアカウントに存在します（再度アップロードしないでください。キャラクター §4）。顔、肌、手のアンカー（キャラクター §3.1–3.3）。音声「Radassa 100%」4yvYc2GSakxLWMhlsd6b、eleven_v4、0.45/0.85、"pt"。A/B テストはこの音声の2つのシード間で行います。発音は vol-TÉC（TTS では「Voltéc」、画面では「Voltec」）。宝石やタトゥーはなし。音楽なし。ロゴ、色、フォント、都市（§7.1）。リアリズム、プロンプト、QA のルール（§3、qa-checklist.md）とゲート（§2）。モデル：API 経由の Veo 3.1、2026年10月15日選定。無料アクセステスト（modelos-e-custos.md §2.2）またはフェーズ1のカタログレビューによって状況が変わった場合のみ、再度質問してください。
3. 動画のスロット： ナレーションを書く前に、必ず質問してください（チャットで十分）。入力済みの例は §7.2 にあります。
   • クライアントから提供されるもの（決して創作しない）： テーマとフォーマット（リール、ストーリーズ、広告）。オフナレーション（デフォルト）または彼女がカメラに向かって話す（references/modo-falando.md）。その場合、各テイクの発話。オファー、価格、条件、期間。有料広告（「詳細を見る」ボタン + QR）またはオーガニック投稿（「リンクは bio」）。QR の遷移先（page_id=674 は「Verão Conectado 2026」ページです。クライアントの確認なしに再利用しないでください）。CC BY 写真のクレジットを投稿のキャプションに含めるかどうか。
   • 質問して提案する（クライアントがゲート1または2で承認）： ロケ地、時間帯、照明。尺。テイクのスクリプト（テイクごと：場所、手に持つもの、環境音）。衣装。フック。キャンペーンカード。SFX ベッドのテキスト。
4. シーン、季節、ロケ地ごとに再作成する（例からコピーしない）： キャラクターのスタイルに合わせた衣装アンカー（§3.4、不透明、無地、ロゴなし。滑らかな織りまたは大きなパターン。細かいパターンはちらつくため）。場所、日付、時間に基づいて計算された太陽光（locais-grussai.md §8；Grussaí の場合は、§3の「他の季節」の表：冬は15:40頃に太陽高度が約19.5°、午後の太陽方位が約293–304°；逆光の自撮りでは、彼女は南に向かって歩き、海は右側に来る）。風（夏の風のみ調査済み。事前に調査すること）。場所の環境音（動画プロンプトおよび SFX ベッド用）。negative_prompt のロケ地セグメント（prompts-moldes.md §2.6）。フック用のスナップショット内の空きスペース。フレーム内の滑らかな領域（テンプレートの #q1 は右上。例：Verão Conectado：T1 の開けた空）。テンプレートの __…__ トークン内のキャンペーンテキスト：フック、カードタイトル（オプションのアイコン付き1部または2部。例：「VERÃO ☀ CONECTADO」、太陽付き）、オファー。SFX ベッドのテキスト。
5. 新しいプロジェクトとページ： $HOME/hyperframes/<campanha> と新しい Artifact。Verão Conectado の URL に再公開しないでください（§7.2）。

2. フェーズとゲートによるワークフロー

各ゲートは、A/B を並べて表示し、番号付きの質問があるページ（Artifact）です。「T1-A、T2-A、T3-A、音声 A、モデル 1」のような短い形式で回答を求めてください。これが意思決定を加速させました。

• ページ： プロジェクトごとに1つ。ゲートごとに再公開（同じファイル、同じ URL）。現在のゲートを上部に、すでに行われた決定を下部に表示。新しいキャンペーン = 新しいページ。メディアは media/ のサポートファイルとして：スナップショットは JPG（セッションごとに約200 KB）、ナレーションは MP3、動画プレビューは MP4（ポスター JPG 付き、セッションごとに約11 MB。ファイルサイズ制限は15 MB）。モデル構造（例：Verão Conectado のページ）：https://claude.ai/artifact/MivTjGgrZ9ZyhZTftP66kh を読んでください（Artifact、action: "read"）。テイクごと：A/B、カメラ、アクション、収録音声、ナレーション、画面テキスト、時間。その後：時間テーブル付きナレーション A/B、モデルパス、クレジット付きロケ地、回答形式のボックス。
• 記録： 各ゲートの回答を $PROJ/DECISOES.md とページの「決定」セクションに記録します。
• ゲートの統合： オファー、CTA（有料 vs オーガニック）、QR の遷移先がすべて回答されたら、ゲート1、2、3を1つのページに統合します。それまでは、まずゲート1（チャットで十分）を行い、スナップショットやナレーションは生成しないでください。回答前にストーリーボードに表示されるナレーションは仮のものです。回答後（発音、CTA、オファー）、動画の前に、選択された音声（2シード、各約300クレジット）で最終ナレーションを生成します。例：Verão Conectado：ストーリーボードでは narracao_radassa100、回答後は narracao_v2_A_s1。
• 決して統合しない： ゲート3の OK 前の動画。

フェーズ1. 調査と計画（クレジット0）

• 並行して調査（4つの分野：モデル、リアリズム/幻覚対策、ロケ地、API。サブエージェントがあれば並行して使用）。その後、ストーリーボード形式でスクリプトとテイク計画を作成：テイクごと、場所と時間、撮影者とカメラ、2～3テンポのアクション、オブジェクト、収録音声、ナレーションフレーズ、画面テキスト、時間。
• クレジットを消費する前に2回の独立したレビューを実行：サブエージェントごとに1つの焦点。サブエージェントがない場合は、焦点ごとに個別にパス。テクニカル = API のフィールドと制限（api-elevenlabs.md §3.3）、尺/1080p、コスト、モデレーション（prompts-principios.md §4）。リアリズム = prompts-principios.md §1 の「プロンプトチェックリスト」 + 照明とジオメトリ（locais-grussai.md §8 で計算された太陽。屋内または夜間シーン：このファイルの §8）。各レビューは、問題、テイク、重大度、修正を返します。
• ランキングは急速に変化します。modelos-e-custos.md が約2ヶ月以上経過している場合は、再度確認してください。2026年11月17日以降は、veo-3.1-generate-001 がまだ存在するか確認してください。クレジットを消費せずに各モデルへのアクセスをテストします（同じファイルの §2.2）。
• すでに対応済みのクライアント： references が調査です。上記の項目と、キャンペーンで新しいものだけを再実行します：季節（夏以外の風は調査されていません）、例以外のロケ地またはオープン写真がない場合（クライアントに写真を依頼、locais-grussai.md §7。調査されていないものは §8 と locais-grussai.md §10 にあります）、衣装と手に持つもの（キャラクター §3.4）。クレジットを消費する前に2回のレビューを維持します。
• ゲート1、クライアントが受け取るもの： 日付入りのスコアと予想コストが記載された推奨モデル。書かれたナレーション付きのスクリプト。番号付きの質問：有料広告またはオーガニック投稿の CTA、QR の遷移先、ブランドの発音、オファーと価格（クライアントから提供されるもの。決して創作しない）、キャラクターと参照（いずれかの参照に別の顔がある場合は警告）、音声と同意、音楽（デフォルト：なし）、尺、タトゥーと宝石、「AI 情報」ラベル、写真のクレジット。[Voltec] セクション1bで指示されたものだけを質問します。

フェーズ2. 実際のロケ地（クレジット0）

• 写真のページで読み取られたライセンスと、証明された場所（ジオタグ、OpenStreetMap）を持つ写真：方法は locais-grussai.md §7。シーンの時間の太陽を計算し（locais-grussai.md §8）、場所の風を確認します。CC0 と CC BY のみが API に送られます。NC 写真は、プロンプトを書くための参照としてのみ使用します。屋内シーン（家、店、車）：読み取れる看板や文字のない、クライアント自身の写真（§8）。
• ゲート2、クライアントが受け取るもの： コンタクトシート（緑 = API に送信可能、赤 = NC）、クレジット、提案された単一のロケ地（1つの場所と1つの時間。例：Verão Conectado：夏の午後の、ベランダとその前の砂浜）、光の時間。

フェーズ3. スナップショットとナレーション（必須ゲート）

• スナップショット = 各テイクの最初のフレーム。gpt-image-2.5-sunburst（9:16、2K、高）で、テイクごとに2バリエーション。qa-checklist.md §A ですべてをレビューします。
• 最初に T1 A/B を生成。qa-checklist.md §A に従って最適なものを選択し、ベースとして使用します。同じ場所の次のテイクはその編集版で、カメラは同じ位置。新しい場所は、彼女を Image 1 として使用した新しい画像です（例：Verão Conectado：T2 と T3 は、ストーリーボード前に T1-A 5vBTv3B9FOt44Vu8jMY4 から派生）。ゲート3で、どのテイクが T1-X から派生するかを伝えます。クライアントがもう一方の T1 を選択した場合、動画の前に、そこから派生テイクを再作成します（テイクごとに2画像。例：Verão Conectado：T2 と T3、4画像、約2,200クレジット）。
• ナレーション全体を1リクエストで、2音声または2シードで生成。アラインメントによって測定された尺がカットを定義します。ブランドのアクセントと話されたテキストを確認します（stress.py + STT）。
• ゲート3、クライアントが受け取るもの： 顔の参照と並べた各テイクの A/B、ナレーション A/B のプレーヤー、ロケ地の写真、モデルに関する質問。回答があるまで停止し、承認された generation_id を保存します。

フェーズ4. 動画、テイクごとに2バリエーション

• Veo 3.1、start_frame = 承認されたスナップショットの generation_id、9:16、1080p、8秒、音声付き、シード 20260115 と 20260116。プロンプトは動き、カメラ、音のみを記述します（prompts-moldes.md §2.5–2.6）。キャラクターは話しません（話すモードを除く、references/modo-falando.md §4）。
• 生成あたり19,391クレジット、テイクあたり2バリエーション（例：Verão Conectado、3テイク × 2バリエーション = 116,346）。セッションでは、6つの並行生成が約3分で完了しました（変動あり）。このフェーズではクライアントは何も受け取りません。

フェーズ5. 各バリエーションの選択と QA（内部ゲート）

• 2 fps のコンタクトシート、24 fps（口）と8 fps（手とオブジェクト）の番号付きストリップ、ネイティブ音声の STT（qa-checklist.md §B）。各欠陥のフレームを記録します（テイク Veo = 192フレーム。フレーム = 秒 × 24）。それを回避するイン/アウトを選択します。バリエーション A にクリーンなウィンドウがない場合は B を使用します。両方とも失敗した場合は、1つの変数を変更して再生成します。
• 2バリエーションを超える再生成：ゲート1で承認された1ラウンドのリザーブ内。それを超える場合は、理由とコスト（テイクあたり19,391）を添えて OK を求めます。
• クライアントは、実際に疑問がある場合にのみ、ここで何かを受け取ります：ページ上のループする2バリエーション。

フェーズ6. 編集（クレジット0、SFX ベッドを除く）

… [truncated for translation]