SuperAPI AI 工具集

collaborating-with-gemini

编程与开发

查看项目

更新于 10-15 16:52

技能介绍

用途:在 Codex 作为主实现者的前提下,把 Gemini CLI 当作协作方,用于原型设计、调试和代码审查。

主要能力:提供轻量桥接脚本 scripts/gemini_bridge.py,返回结构化 JSON(含 success、SESSION_ID、agent_messages,可选 error/all_messages);支持通过 SESSION_ID 复用多轮会话;支持 --sandbox 沙箱模式、--model 覆盖默认模型、--return-all-messages 返回全部原始消息。

使用方式:不要直接调用 gemini,始终使用桥接脚本。运行时应将 --cd 设为仓库根目录(它决定 gemini 进程工作目录),仅当当前目录即仓库根时才用 --cd "."。请求代码改动时要求仅输出 Unified Diff Patch 并禁止直接修改文件。始终记录 SESSION_ID 并在后续追问中复用。通过 Codex 命令运行器调用时默认 timeout_ms 设为 600000(10 分钟)。若提示词含 Markdown 反引号,不要用 --PROMPT "..." 直接传参,改用 heredoc。示例:PROMPT="$(cat <<'EOF' ... EOF)" 后执行 python3 .codex/skills/collaborating-with-gemini/scripts/gemini_bridge.py --cd "." --PROMPT "$PROMPT"。

适用场景:让 Gemini 自行打开文件(提供入口文件与大致行号、目标与约束、输出格式);获取替代方案与边界情况、UI/UX 与可读性反馈、对补丁的风险与缺失测试审查。分享剪贴板截图时,需先把 PNG 复制到 .codex_uploads/ 再在提示词中引用,且不要将其加入 .gitignore。

限制:Gemini 只能读取工作区根目录(--cd)内的文件,无法访问系统临时目录,可能拒绝被忽略的路径;该技能面向 Codex 宿主,在其他宿主中需调整命令运行器超时与上传路径等细节;最终结果由使用者负责并在本地验证。协作期间建议维护简短的 Collaboration State Capsule。