gbro-collage-broll

环境要求

• Codex 环境：Gate 2 静帧生成依赖内置 image_gen 工具
• GEMINI_API_KEY：在 Google AI Studio 创建，视频生成按量计费
• Python >= 3.10，用于运行视频生成脚本
• google-genai >= 2.10.0（skill 会引导创建共享 venv ~/hyperframes-projects/.omni-venv/）
• ffmpeg / ffprobe：用于首尾帧处理、去音轨、生成 contact sheet

安装与启动步骤

1. 1克隆 skill 目录

   把项目仓库放进 agent 的 skills 目录，README 示例为 ~/.agents/skills/，也可放到 ~/.claude/skills/。

   git clone https://github.com/pyang5166/gbro-collage-broll.git ~/.agents/skills/gbro-collage-broll

   复制

2. 2配置 API 密钥

   在环境变量中提供 GEMINI_API_KEY，密钥从 Google AI Studio 创建；README 未给出具体导出命令，请按你的运行环境设置。

3. 3补齐运行依赖

   确认本机已装 Python >= 3.10、ffmpeg/ffprobe；google-genai 由 skill 引导装进共享 venv。

4. 4首次触发自检

   首次触发时 skill 会自动运行 scripts/check_setup.sh，并根据缺失项给出配置指引，按提示逐项补齐即可。

5. 5Gate 1 隐喻确认

   对 agent 说出文稿并触发技能，此阶段只输出视觉隐喻方案（核心意思/关键物件/底色/组装顺序），不生成图片视频。

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

   复制

6. 6Gate 2 静帧确认

   隐喻确认后才生成彩色拼贴静帧和 contact sheet，再次等你确认，不满意可在此阶段调整。

7. 7Gate 3 生成视频

   静帧通过后自动用 gemini-omni-flash-preview 做首尾帧组装动画，并附逐秒抽帧、首帧空场、尾帧对照的完整 QA。

关键配置

如何确认成功

首次触发后 check_setup.sh 自检无缺失项，且 Gate 1 能正常输出视觉隐喻方案，说明环境与密钥已就绪。

常见问题

注意事项

• 克隆目标目录必须与你的 agent skills 目录一致，否则技能无法被识别触发。
• 触发词包括 collage b-roll、纸拼贴 b-roll、半调拼贴、拼贴风格配画面、gbro-collage-broll。
• 视频生成按量计费，请务必在 Gate 2 静帧确认满意后再进入 Gate 3。
• Gate 2 静帧生成依赖 Codex 环境内置的 image_gen 工具，环境不符时可能无法生成静帧。