SuperAPI AI 工具集

oracle-gemini

通用与其它

查看项目

更新于 10-16 03:16

技能介绍

用途:将 Google Gemini CLI 作为规划与代码审查的顾问,由 Claude 负责综合结果并呈现给用户。技能明确仅用于规划与审查,绝不能用 Gemini 实施代码改动。

前提:调用前先运行 ~/.claude/skills/oracle-gemini/scripts/check-gemini.sh 校验可用性;若脚本返回非零,显示错误并停止,不可在缺少 Gemini CLI 时继续。

默认配置:模型 gemini-2.5-pro(用户可说 use flash 切换);沙箱 --sandbox(安全考虑,不可覆盖);输出 text(用户可要求 use json output);超时至少 5 分钟。超时建议:简单查询 5 分钟(300000ms),中等复杂度 10 分钟(600000ms),高复杂度 15 分钟(900000ms)。

模型选择:gemini-2.5-pro 适合复杂分析、架构与全面审查,较慢;gemini-2.5-flash 适合快速反馈、单文件审查与快速迭代,最快。涉及多文件、需深度分析或架构思考时用 pro;简单查询、单文件审查或追求速度时用 flash。

工作流:校验前提;判断模式(规划或审查);构造聚焦提示词(规划模板要求架构权衡、需创建或修改的文件、实现顺序、风险与阻碍,且不得实施;审查模板覆盖缺陷、安全漏洞、性能、代码质量与最佳实践,并要求给出文件位置与行号);选用模型并执行;呈现 Gemini 输出并注明模型;综合见解、识别行动项,必要时用 AskUserQuestion 澄清偏好,将结构化计划写入 ~/.claude/plans/[plan-name].md 并调用 ExitPlanMode 请求批准。

调用方式:Gemini CLI 不支持 HEREDOC/stdin,须使用位置参数提示词,并始终设置 Bash 工具超时(至少 300000ms)。短提示可直接作为位置参数:gemini -m gemini-2.5-pro --sandbox -o text "Your prompt here" 2>/dev/null。长提示先写入临时文件再命令替换,关键标志为 -m(选模型)、--sandbox(禁止文件修改,不可协商)、-o text(纯文本输出,需要结构化时可改 json)、2>/dev/null(抑制错误噪音)。大型输出(超过 5000 行)建议概括关键部分。

限制与错误处理:仅限规划与审查,不实施改动;沙箱不可覆盖。Gemini 未安装时显示安装说明;超时则提示用户并建议简化查询或改用 flash;遇到 API 限流则等待重试或告知限制;空响应先重试一次,再报告失败。完整模型与标志文档见 references/gemini-flags.md。