brand-video — 一貫したスタイルの顔出しなし動画、オンデマンド
/brand-video として呼び出します。1つのコマンドで、複数のルックを生成。検証済みのRestoreAssist実行(9本の動画出力)に基づいて構築されています。styles.md からスタイルを選択し、その他の要素はすべて一定に保つので、出力はバッチ間、ブランド間で一貫します。
入力(不足時のみ質問; 適切に推論)
- brand — RestoreAssist / Synthex / DR / NRPG / CARSI / CCW / Unite、またはクライアント名。クレーム、CTA、音声を設定します。
- style —
styles.mdのキー(デフォルトflat-line)。これが「ルック」/ ドロップダウンの値です。 - topic(s) — 1つのアングル、またはバッチ用のリスト(それぞれ1動画、並列処理)。
- voice —
ELEVENLABS_VOICE_ID(ブランドごと;~/.hermes/.envから取得)。重要: 生成前に現在の値を確認してください — ユーザーが変更することがあります。 - upload? — デフォルト: レンダリング + ステージのみ。明示的に依頼があった場合のみ、YouTube限定公開にアップロードします。
パイプライン(動画ごと — それぞれスラッグフォルダを作成し、決してディレクトリを共有しない)
- スクリプト →
<slug>/script.md: 1つのクリーンなVOパラグラフ、約120~140語、約12~16の短い文(1文 = 1ビジュアルビート = 1画像)、問題→解決策→CTA。主張はブランドWikiに基づき、機能をでっち上げないこと。ブランドのCTA行で終了。 - 音声 → バンドルされた tts.py を実行(
ELEVENLABS_API_KEY+ELEVENLABS_VOICE_ID+DIRを読み込み):cd <workdir> && set -a && . ~/.hermes/.env && set +a && DIR=$PWD/<slug> python3 <skill>/pipeline/tts.py<slug>/voiceover.mp3+<slug>/transcript.json(ビート)を書き出します。ビート数を記録します。 - 画像 → ビートごとに1枚、プロンプト = 選択したスタイルのPOSITIVEトークン + その文に該当する具体的なシーン + スタイルのNEGATIVEトークン、ランドスケープ16:9、ゼロ埋めで
<slug>/images/01.png …として保存。- 本番 / ヘッドレス(デフォルト):
python3 <skill>/pipeline/image_gen.py "<prompt>" <out.png>— Geminigemini-2.5-flash-image("Nano-Banana") via HTTPS、GEMINI_API_KEYは環境変数から。サーバーサイドで動作。エンドツーエンドで検証済み。アプリワーカーが呼び出す方式です(ローカルMCP不要)。 - 対話型(オプション): Claudeセッション内で実行する場合は
mcp__margot__image_generateを使用。並列衝突を避けるため、スラッグプレフィックス付きのファイル名を使用すること([[parallel-agents-shared-output-collision]] 参照)。
- 本番 / ヘッドレス(デフォルト):
- 合成 →
python3 <skill>/pipeline/stitch.py <slug>→<slug>/final-1080p.mp4(1920×1080@25、画像タイミングはビートに基づく)。最終的な再生時間が音声の再生時間とほぼ一致することを確認。
バッチ処理と新しいルック
- バッチ: トピックごとに1つのサブエージェントを起動(並列)、それぞれが自身のスラッグディレクトリを所有。正確なエージェントプロンプトの形状はRestoreAssist実行を参照。
- 音声差し替え(音声のみ変更、スクリプト/画像は同じ): VOを再生成、
list.txtのdurationをnew_total/old_totalでリスケール、再合成。(差し替えパターン) - ルックの追加:
styles.mdにブロックを追加(positive/negative トークン)。そのキーが即座に選択可能なスタイルになります — このレジストリがドロップダウンのデータソースです。
アップロード(YouTube、オプション)
ブラウザのファイルアップロードは機能しません(ホストパスが拒否される)。[[youtube-api-upload-restoreassist]] に文書化されたYouTube Data APIパスを使用します: デスクトップOAuthクライアント → トークンを ~/.hermes/yt-restoreassist-token.json に保存 → videos().insert privacyStatus=unlisted、category 27、not-for-kids。チャンネルタイトルでガード。uploaded.json により冪等性を確保。OAuthクライアントのGCPプロジェクトでYouTube Data API v3が有効になっている必要があります。
ガードレール
- クレームは現実のものにすること(ブランドWiki / 製品の事実)。フラットイラスト + 合成音声 → YouTubeのAI開示は通常「いいえ」(アップロード時に確認; AI音楽を追加した場合は「はい」に変更)。
- 一貫性のために、バッチごとに1つのスタイルを維持。
SKILL.mdは200行以内に保つこと([[feedback-tight-code]] 参照)。 - 参考実装 + アセット:
/Users/phill-mac/restoreassist-videos/。