gbro-collage-broll

gbro Collage B-roll

約 5 秒のナレーションを鋭いビジュアルアイデアに凝縮し、エディトリアルな紙のコラージュを組み立てるアニメーションに仕上げます。

このスキルを使う場面

次のような場合に、このスキルを使ってください。

• ユーザーが「collage b-roll」「paper collage B-roll」「halftone collage」「紙拼贴 b-roll」「半调拼贴」「gbro-collage-broll」をリクエストした場合。
• ナレーションや抽象的なコンセプトを、エディトリアルな半調紙コラージュのビジュアルメタファーに変換する場合。
• Gemini Omni Flash を使い、3 段階の厳格な人間による承認を経て、何もない状態から組み上がる 9:16 の縦型動画クリップを生成する場合。

このスキルを使わない場面：

• フレーム単位での正確なレイヤー操作、タイムライン編集、または透過アセットが必要な場合（代わりに HyperFrames／HTML ベースの動画レンダラーを使ってください）。
• 最終的な MP4 クリップをレンダリングせず、動画プロンプトだけを求めている場合。
• 人物や製品のリアルな商用実写映像を求めている場合。

手順

1. 前提条件と環境の確認

Gate 1 の前に、セットアップ検証スクリプトを実行してください。

bash .agent-skills/gbro-collage-broll/scripts/check_setup.sh

GEMINI_API_KEY、ffmpeg／ffprobe、Python >= 3.10、および google-genai >= 2.10.0（~/hyperframes-projects/.omni-venv 内）が準備できていることを確認してください。

2. 3 段階の承認ワークフロー

Gate 1：ビジュアルメタファーの承認

• 約 5 秒のスクリプトを、明確なビジュアル上の主題 1 つに凝縮します（核心となる意味、感情、動作を表す動詞、主要なオブジェクト 3～6 個、背景色／アクセントカラー、組み立ての順序）。
• 画像や動画は生成せずにメタファーの提案を出力し、その後 STOP してユーザーの承認を待ちます。

Gate 2：静止画フレームの承認

• Gate 1 の承認後、visual-spec.json を作成し、Codex image_gen で 9:16 の静止画フレームを生成します。
• コンタクトシート still-contact-sheet.jpg を生成し、gate2-qa.md を作成します。STOP して、動画モデルを呼び出す前にユーザーの承認を待ちます。

Gate 3：動画の生成と QA

• Gate 2 の承認後、空の単色の先頭フレーム（first-frame.png）と、目標とする最終フレーム（last-frame.png）を用意します。
• scripts/generate_video.py を使って Gemini Omni Flash による動画生成を一括実行します（デフォルトは gemini-omni-flash-preview です）。

~/hyperframes-projects/.omni-venv/bin/python \
  .agent-skills/gbro-collage-broll/scripts/generate_video.py \
  --batch <project>/omni-jobs.json \
  --concurrency 3

• 出力 MP4 を無音形式（final-5s-noaudio.mp4）に変換し、フレーム抽出のコンタクトシートを実行して、gate3-qa.md を作成します。

例

例 1：1 行の B-roll リクエスト

入力：

collage b-roll: 很多人以为 AI 是来替你思考的，其实它更像一面镜子，会把你问题里的漏洞照出来。

ワークフロー：

1. Gate 1 の提案：
   • 核心となる意味：AI は思考を代替するものではなく、見落としを照らし出す鏡です
   • メタファー：虫眼鏡と、光を放ち組版の文字抜けを照らし出す破れた紙の鏡面
   • 色彩：マスタードイエローの背景、黒と白の半調、濃い赤のアクセント
2. Gate 2 の生成とコンタクトシートのレビュー。
3. Gate 3 の Omni Flash による動画生成と、無音 MP4 の納品。

ベストプラクティス

1. 3 段階の承認を厳守：Gate 1 と Gate 2 を決してスキップしないでください。人間の承認を待つことで API コストを抑え、動画モデルの実行前に美的な方向性を合わせられます。
2. カラーパレットに多様性を持たせる：すべてのクリップをコバルトブルーにしないでください。意味に応じて、オレンジ、マスタードイエロー、濃い紫、ティール、フォレストグリーンを使い分けます。
3. 何もない状態から組み立てるタイミング：Image 1 が空の単色フィールドで、Image 2 が完成フレームそのものであることを確認してください。これにより Omni Flash が、鮮明なストップモーション風の組み立てアニメーションを生成できます。
4. テキストや UI の混入を避ける：静止画フレームには、読み取れる文字、ロゴ、ウォーターマーク、UI のアーティファクトが入らないようにします。

参考資料

• プロジェクトリポジトリ：https://github.com/pyang5166/gbro-collage-broll
• デフォルトの動画モデル：gemini-omni-flash-preview