用途：在 Codex 作为主要实现者的前提下，把部分任务委托给 Gemini CLI 作为协作者，用于原型设计、调试、代码审查和网络搜索。桥接脚本 scripts/gemini_bridge.py 封装 gemini -p（无头模式），返回结构化 JSON，并通过 SESSION_ID 管理会话连续性。
主要能力：支持多轮会话（首次调用返回 SESSION_ID，后续传入即可续接）；支持网络搜索与研究（Gemini 内置 grounding）；可审查 diff 或以统一 diff 形式提出修改；可分析截图/图像。会话由 Gemini CLI 持久化在 ~/.gemini/tmp/<project>/chats/，桥接脚本负责捕获并返回 ID，调用方需自行保存复用。
使用方式：基本调用为 python3 .codex/skills/collaborating-with-gemini/scripts/gemini_bridge.py --cd "." --PROMPT "$PROMPT"，返回 { "success": true, "SESSION_ID": "...", "agent_messages": "..." }。多轮时在第二次调用加 --SESSION_ID "<id>"。提示词中含反引号会触发 shell 命令替换，需用 heredoc。桥接标志包括 --PROMPT（必填）、--cd（必填）、--SESSION_ID、--model、--sandbox、--approval-mode、--include-directories、--return-all-messages。通过 Codex 命令运行器调用时默认超时设为 timeout_ms 600000（10 分钟）。
安全与限制：Gemini 默认可读写工作区文件，桥接脚本不限制。--sandbox 可阻止 shell 命令和文件写入，建议用于审查/咨询任务。请求代码修改时可在提示词中加入 OUTPUT: Unified Diff Patch ONLY. Do not modify any files.，但这只是约定，不被强制执行。--approval-mode plan 不能可靠阻止写入，Gemini 可能自行批准计划并用 shell 绕过文件写入限制，不应依赖它保证安全。截图需先复制到 .codex_uploads/，且不要将其加入 .gitignore，否则 Gemini 拒绝读取被忽略路径。
适用场景：设计权衡、边界情况或测试缺口的第二意见；网络搜索与研究；审查 diff 或提出统一 diff 修改；截图/图像分析。不适用：琐碎的一次性任务（直接在 Codex 做）；需要文件编辑的任务（Codex 编辑，Gemini 建议）；涉及机密、私钥或生产数据的任何内容。
验证：冒烟测试 python3 .codex/skills/collaborating-with-gemini/scripts/gemini_bridge.py --help；会话测试运行一次提示，确认 JSON 含 success: true 和 SESSION_ID。协作期间可维护 [Gemini Capsule] Goal: | SID: | Files: | Last: | Next: 状态块。