Gemini API 技能

用于 Gemini API、SDK 和模型交互的一组技能库。

关于

大型语言模型的知识是固定的，它们是在特定时间点进行训练的。而软件开发节奏快、变化频繁，每天都有新的库发布，最佳实践也在迅速演进。

这导致了一个知识缺口，仅靠语言模型自身无法解决。例如，模型在训练时并不了解自身，也未必能意识到最佳实践中的细微变化（如 思维循环）或 SDK 的更新。

技能 是一种轻量级技术，可以为你的智能体添加相关上下文。本仓库包含与构建基于 Gemini API 的应用相关的技能。

性能

我们的评估发现，添加此技能后，智能体生成符合最佳实践的正确 API 代码的能力，在 Gemini 3 Flash 上提升至 87%，而在 Gemini 3 Pro 上则提升至 96%。

本仓库中的技能

技能	描述
gemini-api-dev	用于开发基于 Gemini 的应用的技能。提供使用 Gemini API 构建应用的最佳实践。
vertex-ai-api-dev	用于在 Google Cloud Vertex AI 上使用 Gen AI SDK 开发基于 Gemini 的应用的技能。涵盖工具、多模态生成、缓存和批量预测等内容。
gemini-live-api-dev	用于构建使用 Gemini Live API 的实时双向流式应用的技能。涵盖基于 WebSocket 的音频/视频/文本流式传输、语音活动检测、原生音频功能、函数调用以及会话管理等内容。
gemini-interactions-api	用于构建使用 Gemini Interactions API 的应用的技能。涵盖文本生成、多轮对话、流式输出、函数调用、结构化输出、图像生成、Deep Research 智能体、已弃用的模型护栏，以及 Python 和 TypeScript SDK。

安装

你可以使用 Vercel 技能 CLI 或 Context7 技能 CLI 来浏览并安装技能。

使用 Vercel 技能 CLI

# 交互式浏览并安装技能。
npx skills add google-gemini/gemini-skills --list

# 安装特定技能（例如 gemini-api-dev）。
npx skills add google-gemini/gemini-skills --skill gemini-api-dev --global

使用 Context7 技能 CLI

# 交互式浏览并安装技能。
npx ctx7 skills install /google-gemini/gemini-skills

# 安装特定技能（例如 vertex-ai-api-dev）。
npx ctx7 skills install /google-gemini/gemini-skills vertex-ai-api-dev

免责声明

本项目并非 Google 官方支持的产品。本项目不符合 Google 开源软件漏洞奖励计划 的资格。

Gemini Skills 快速上手指南

gemini-skills 是一个专为 Gemini API、SDK 及模型交互设计的技能库。它通过为 AI 代理（Agent）注入最新的开发最佳实践、SDK 变更及特定功能上下文，弥补大语言模型训练数据滞后带来的知识缺口，显著提升代码生成的准确性和规范性。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Windows、macOS 或 Linux。
• Node.js：已安装 Node.js (推荐 v18 或更高版本)，因为安装工具基于 npx 运行。
• 网络环境：由于技能库托管在 GitHub 及相关全球服务上，国内开发者可能需要配置网络代理以确保 npx 命令能正常拉取资源。目前暂无官方提供的国内镜像源。
• 前置知识：熟悉命令行操作，并了解 Gemini API 或 Vertex AI 的基本概念。

安装步骤

你可以选择使用 Vercel skills CLI 或 Context7 skills CLI 来浏览和安装技能。以下是具体命令：

方式一：使用 Vercel skills CLI

1. 交互式浏览并安装（推荐首次使用）：

   npx skills add google-gemini/gemini-skills --list
   

2. 直接安装指定技能（例如安装 gemini-api-dev 到全局）：

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

方式二：使用 Context7 skills CLI

1. 交互式浏览并安装：

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

2. 直接安装指定技能（例如安装 vertex-ai-api-dev）：

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

基本使用

安装完成后，这些技能会自动增强你的 AI 编程助手（如 Cursor、Windsurf 或其他支持 Skills 协议的 Agent）。当你在项目中询问关于 Gemini 开发的问题时，AI 将自动调用已安装的技能上下文。

使用示例场景：

假设你已全局安装了 gemini-api-dev 技能，现在需要在项目中创建一个调用 Gemini API 的 Python 脚本。

1. 在支持的 IDE 或 Agent 中输入提示词：

   "请使用 Python 编写一个调用 Gemini API 进行文本生成的示例代码，务必遵循最新的安全最佳实践。"

2. 预期效果：

   • AI 不会仅依赖其训练数据中的旧版 SDK 写法。
   • 它会利用 gemini-api-dev 技能中提供的最新上下文，生成符合当前 google-generativeai 库规范的代码。
   • 代码将包含正确的初始化方式、错误处理以及最新的参数配置（如思维链签名等），准确率可提升至 87%-96%。

可用技能列表参考：

技能名称	适用场景
gemini-api-dev	通用 Gemini API 应用开发最佳实践。
vertex-ai-api-dev	基于 Google Cloud Vertex AI 和 Gen AI SDK 的开发（含缓存、批量预测等）。
gemini-live-api-dev	构建实时双向流媒体应用（音频/视频/文本），涉及 WebSocket 和语音活动检测。
gemini-interactions-api	复杂交互应用（多轮对话、结构化输出、图像生成、Deep Research 等）。

注意：本项目并非 Google 官方正式支持的产品，也不属于 Google 开源软件漏洞奖励计划范围。