SuperAPI AI 工具集

claude-use-gemini-acp

智能体与模型

查看项目

更新于 10-15 21:50

技能介绍

用途:把子任务委派给 Gemini CLI。适合任务上下文超出 Claude 窗口、需要实时 Google 搜索接地、想要其他模型的第二意见,或用户明确要求使用 Gemini 时。

主要能力:在 ACP 模式下启动 Gemini CLI 子进程,发送一个提示,把响应流式输出到 stdout,然后干净退出。没有持久会话,一次提示对应一次响应。

使用方式(首次需安装): cd ~/.claude/skills/claude-use-gemini-acp/scripts pnpm install 后续运行会跳过该步骤。

调用示例: GEMINI_MODEL=gemini-2.5-pro
TARGET_CWD=/path/to/project
node ~/.claude/skills/claude-use-gemini-acp/scripts/gemini-delegate.mjs
"Summarize the architecture in ARCHITECTURE.md and list the top 3 risks"

可用环境变量:GEMINI_MODEL(默认 gemini-2.5-pro)、GEMINI_CLI_VERSION(默认 nightly)、TARGET_CWD(默认当前工作目录)。响应会随生成流式输出到 stdout,可捕获后用于回复。

工作原理:启动 pnpm dlx @google/gemini-cli@<version> --acp --yolo --model <model>,通过 @agentclientprotocol/sdk 的 ClientSideConnection + ndJsonStream 连接,经 ACP 会话依次发送 initialize、newSession、prompt,把 agent_message_chunk 增量流式输出到 stdout,响应完成后终止子进程。--yolo 标志会自动批准 Gemini 会话内的所有工具调用。

提示构造建议:新会话没有历史,需在提示字符串中包含全部相关上下文;如需 Gemini 读取文件,可用绝对路径引用;保持提示聚焦,一次调用一个明确任务;多步工作应改为多次顺序调用而非一个冗长提示。

限制与错误处理:脚本不会重试。若非零退出,请检查 stderr 中的 pnpm dlx 下载失败、Gemini 认证错误(可能需要 gemini auth login)或 ACP 初始化失败。应把错误反馈给用户并建议修复根因后重跑。