SuperAPI AI 工具集

gemini-peer-review

编程与开发

查看项目

更新于 10-15 23:31

技能介绍

用途:把 Gemini 当作编程同行,对代码质量、架构决策、调试或安全审查给出第二意见。通过直接调用 Gemini API 实现,不依赖 CLI。

主要能力与模式:review 审查指定文件的缺陷、逻辑错误、安全漏洞、性能与最佳实践问题;architect 对设计决策做权衡分析,需提供项目上下文(如 CLAUDE.md 及相关源码);debug 在两次以上修复失败后,让 Gemini 以无调试偏见的视角分析错误;security 扫描注入、认证绕过、数据暴露等漏洞;quick 为无文件上下文的快速提问。模型选择:review、debug、quick 用 gemini-2.5-flash;architect、security-scan 用 gemini-2.5-pro。

使用方式:先设置环境变量 GEMINI_API_KEY,密钥可从 https://aistudio.google.com/apikey 获取:export GEMINI_API_KEY="your-key-here"。工作流为:根据请求确定模式,读取目标文件到上下文,按 references/prompt-templates.md 的 AI-to-AI 模板构建提示词,写入 .claude/artifacts/gemini-prompt.txt(避免 shell 转义问题),生成并运行 Python 脚本调用 API,最后综合 Gemini 的发现并加入自己的观点,由用户决定采纳什么。API 端点为 https://generativelanguage.googleapis.com/v1beta/models/{model}:generateContent,请求体包含 contents 与 generationConfig(temperature 0.3、maxOutputTokens 8192),从 candidates[0].content.parts[0].text 提取文本。脚本写到 .claude/scripts/gemini-review.py 后运行。若模型 ID 报错,可用 curl 查询当前可用模型。

适用场景:提交重大改动前的最终审查、多次调试失败后、存在多个可行方案的架构决策、安全敏感代码审查。

限制:不适合简单语法检查、每次编辑都调用、答案显而易见的问题。构建提示词必须使用 AI-to-AI 格式并写入文件,不要通过 bash 参数内联传代码,否则会因 shell 转义而失败。模型 ID 可能频繁变化,出错时需重新查询。其余细节资料未提供。