设置编码代理

AI 编码助理功能强大，但也有局限性 - 训练数据在特定日期截止，因此无法了解新的 API 功能和变化。如果无法访问 Gemini 专用文档，代理可能会建议通用模式，而不是优化方法。

Gemini API 技能通过让编码代理直接访问最新的 Gemini API 文档、集成模式和最佳实践来弥合这些差距。这样可确保智能体能够提供更准确、更具体的代码示例和指导。安装这些技能后，您的编码助理会及时了解不断发展的 Gemini API 及其推荐用法。

可用的技能

以下技能可供使用。安装与您的使用情形相关的插件。

  • skills.sh：推荐。用于实现可移植的代理行为的开放标准。
  • Context7：支持已在使用 Context7 生态系统的用户。

gemini-api-dev

核心 Gemini API 开发技能：

  • 让编码代理参考 Gemini API 官方文档
  • 提供有关构建由 Gemini 提供支持的应用的最佳实践
  • 包含常见集成的推荐模式

使用 skills.sh 进行安装

npx skills add google-gemini/gemini-skills --skill gemini-api-dev --global

通过 Context7 安装

npx ctx7 skills install /google-gemini/gemini-skills gemini-api-dev

gemini-live-api-dev

技能：使用 Gemini Live API 构建实时对话式 AI 应用。此技能提供以下方面的文档和最佳实践：

  • 用于低延迟流式传输的 WebSocket 连接
  • 流式音频、视频和文本
  • 语音活动检测和抢占支持

使用 skills.sh 进行安装

npx skills add google-gemini/gemini-skills --skill gemini-live-api-dev --global

通过 Context7 安装

npx ctx7 skills install /google-gemini/gemini-skills gemini-live-api-dev

gemini-interactions-api

使用 Interactions API 构建应用的技能。Interactions API 是一个用于与 Gemini 模型和代理互动的统一接口，专为代理应用而设计。此技能涵盖以下内容：

  • 文本生成、多轮对话和流式传输
  • 函数调用、结构化输出和图片生成
  • 后台执行和 Deep Research 智能体
  • 服务器端对话状态管理
  • Python 和 TypeScript SDK 模式

使用 skills.sh 进行安装

npx skills add google-gemini/gemini-skills --skill gemini-interactions-api --global

通过 Context7 安装

npx ctx7 skills install /google-gemini/gemini-skills gemini-interactions-api

验证安装

安装后，确认您的编码代理已为技能编制索引，并且可以访问实时 Gemini API 文档。

1. 验证代理行为

最可靠的验证方式是向代理提出有关 Gemini API 的技术问题。

提示：“如何使用 Gemini API 进行上下文缓存？”

成功安装后，系统将：

  • 引用特定的 Gemini 方法，例如 cacheContent 或 cachedContents.create。
  • 显示“正在使用技能：gemini-api-dev”指示器。

2. 验证清单

如果代理给出的答案很笼统，请使用适合您环境的特定“发现”命令来验证技能是否已加载。

环境 验证方法
Claude Code 在终端中输入 /skills，列出所有有效清单。
光标 依次打开“设置”>“规则”。验证该技能是否显示在“代理决定”下。
Antigravity 输入 /skills list 或查看自定义 > 规则边栏。
Gemini CLI 运行 gemini skills list 或在对话期间使用 /skills 斜杠命令。
Copilot 输入 @gemini /skills（或仅输入 /skills）可查看有效扩展程序。

问题排查

如果您的代理仅提供一般信息或无法识别 Gemini 特有的方法，请检查以下内容：

Agent 未发现技能

大多数代理仅在启动时对技能进行索引。

修复：完全重启 IDE（Cursor/VS Code），或退出并重新打开基于终端的代理（Claude Code）。

全球冲突与局部冲突

如果您使用 --global 标志进行安装，则代理可能会忽略该标志，而采用项目专用规则。

修复：尝试直接将技能安装到项目根目录中，而不使用全局标志：

npx skills add google-gemini/gemini-skills --skill gemini-api-dev

资源