SuperAPI AI 工具集

gemini-guide

编程与开发

查看项目

更新于 10-15 23:31

技能介绍

用途:在构建 Google Gemini 应用时,为 Claude 提供 Gemini API 文档、SDK 模式与当前最佳实践。该技能把 Gemini 文档带给 Claude,本身不调用 Gemini。

主要能力:按优先级查找文档来源。第一优先是 GitHub 的 codegen_instructions,地址为 https://raw.githubusercontent.com/googleapis/js-genai/refs/heads/main/codegen_instructions.md,用于获取始终最新的 SDK 模式;第二优先是通过 WebFetch 访问 Google AI 官方文档 https://ai.google.dev/gemini-api/docs/{topic},追加 .md.txt 可获得 markdown;第三优先是本地缓存文档,若存在于 ~/Documents/google-gemini-context/,包含 24 个 JS、24 个 Python 和 7 个通用主题。

使用方式:用户询问 Gemini 主题时,先读 references/deprecated-patterns.md 了解不应建议的过时模式,再获取最新 SDK 模式,然后读 references/topic-index.md 将查询映射到主题,有本地文档则读取匹配文件,否则用 WebFetch 获取官方文档,最后综合成带可用代码示例的清晰回答。

常见纠正:包名应为 @google/genai(JS)和 google-genai(Python),而非 @google/generative-ai 和 google-generativeai;类名为 GoogleGenAI;调用为 ai.models.generateContent();聊天为 ai.chats.create() / chat.send();配置参数为 config;流式为 config={"stream": True};模型推荐 gemini-2.5-flash;安全类别为 5 类,含 HARM_CATEGORY_CIVIC_INTEGRITY;请求头为小写 x-goog-api-key;无每日速率限制,仅有每分钟限制。

适用场景:需要查询 Gemini API 用法、SDK 初始化、模型选择、安全设置、速率限制等文档时。

限制:本地缓存为可选,不存在时回退到 WebFetch;文档可能过时,需核对 GitHub codegen_instructions 和官方模型页面;资料未提供收费、价格或平台细节。