设置编码代理

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

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

该技能的用途

Gemini API 开发技能 (gemini-api-dev)：

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

以下部分介绍了基于您偏好的技能管理生态系统的安装方法。两者都会安装相同的技能 - 您可以在终端中从任何目录运行这些命令。

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

使用 skills.sh 进行安装

# List available skills
npx skills add google-gemini/gemini-skills --list

# Install the gemini-api-dev skill globally
npx skills add google-gemini/gemini-skills --skill gemini-api-dev --global

通过 Context7 安装

# Interactively browse and install skills
npx ctx7 skills install /google-gemini/gemini-skills

# Install a specific skill directly
npx ctx7 skills install /google-gemini/gemini-skills gemini-api-dev

验证安装

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

1. 验证代理行为

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

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

成功安装后，系统将：

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

验证清单

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

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

问题排查

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

代理未发现技能

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

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

全球冲突与局部冲突

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

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

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

资源