AI 程式碼輔助工具功能強大，但也有其限制，例如訓練資料只到特定日期，因此無法提供新的 API 功能和變更。如果無法存取 Gemini 專屬文件，代理程式可能會建議一般模式，而非最佳化方法。
為確保程式設計助理能跟上不斷演進的 Gemini API 和建議用法，建議您設定 Gemini 文件 MCP，並使用 Gemini API 技能強化環境。這些工具雖然可以獨立使用，但設計上是為了搭配運作，提供完整的涵蓋範圍。
連結 Gemini Docs MCP
Gemini 會在 https://gemini-api-docs-mcp.dev代管公開的 Model Context Protocol (MCP) 伺服器。將程式設計代理連結至這個伺服器，可確保所有查詢都能存取最新的 API、程式碼更新和最佳設定範例。
在代理的終端機或專案根目錄中執行下列指令，安裝伺服器：
npx add-mcp "https://gemini-api-docs-mcp.dev"
這個伺服器會新增 search_documentation 函式，代理程式可使用該函式從官方 Gemini 說明文件檔案擷取即時 API 定義和整合模式。
新增 API 開發技能
這些技能會直接在助理的環境中提供內建規則和最佳做法 (例如強制使用正確的 SDK 和目前模型版本)。這項技能會與 Gemini Docs MCP 服務搭配運作：如果兩者都已安裝，這項技能會使用 MCP 服務來處理說明文件；即使未安裝 MCP，這項技能也會從 ai.google.dev 擷取 /gemini-api/docs/llms.txt 做為備援 (您也可以在網址後方加上 .md.txt，以原始 Markdown 格式擷取個別頁面，例如 https://ai.google.dev/gemini-api/docs/speech-generation.md.txt)。
如要安裝這些技能，可以使用下列任一項支援的工具。每個技能模組下方都有安裝說明：
gemini-api-dev
使用 Gemini API (Interactions API) 建構應用程式的技能。Interactions API 是我們最簡單且最適合用來建構 Gemini 模型和代理程式的 API。這項技能涵蓋的主題包括：
- 生成文字、進行多輪對話及串流
- 函式呼叫、結構化輸出內容和圖像生成
- 背景執行和 Deep Research 代理
- 伺服器端對話狀態管理
- 將提示傳送至目前模型，並避開已淘汰的模型
- Python 和 TypeScript SDK 模式
使用 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 Docs MCP 伺服器，並使用您安裝的技能。
1. 驗證服務專員行為
最可靠的驗證方式是向專員詢問有關 Gemini API 的技術問題。
提示：「如何使用 Gemini API 的脈絡快取功能？」
設定成功後，系統會：
- 提供準確的程式碼：從最新端點參照特定 Gemini 方法，例如
cacheContent或cachedContents.create。 - 使用 MCP 工具：顯示工具已連線至 Gemini 文件 MCP 伺服器，或使用
search_documentation工具擷取資料。 - 叫用已載入的技能：顯示「使用技能：gemini-api-dev」指標 (如果依附於次要包裝函式)。
2. 驗證表現和工具
如果代理程式提供一般或通用答案，請使用環境專用的 Discovery 或 Status 指令，確認文件 MCP 或技能已載入記憶體。
| 環境 | MCP 驗證 | 技能驗證 |
|---|---|---|
| Claude Code | 在終端機中輸入 /mcp，即可查看有效伺服器和 search_documentation 工具。 |
在終端機中輸入 /skills，列出所有有效資訊清單。 |
| 游標 | 依序前往「設定」>「功能」>「MCP」。確認伺服器為「已連線」狀態。 | 依序開啟「設定」>「規則」。確認技能顯示在「代理決定」下方。 |
| Antigravity | 在「自訂」>「連線」側欄中查看 MCP 狀態。 | 輸入 /skills list 或查看「自訂」>「規則」側欄。 |
| Gemini CLI | 執行 gemini mcp list 或使用 /mcp list。 |
執行 gemini skills list 或在工作階段中使用 /skills 斜線指令。 |
| Copilot | 輸入 @gemini /mcp 即可列出有效資料連接器。 |
輸入 @gemini /skills (或 /skills) 即可查看有效擴充功能。 |
疑難排解
如果代理程式只提供一般資訊，或無法辨識 Gemini 專屬方法，請檢查下列事項：
代理程式未探索到技能
大多數代理程式只會在啟動時為技能建立索引。
修正：完全重新啟動 IDE (Cursor/VS Code)，或結束並重新開啟終端機型代理程式 (Claude Code)。
全球與區域衝突
如果您使用 --global 旗標安裝，代理程式可能會忽略該旗標，而採用專案專屬規則。
修正方式：嘗試直接將技能安裝到專案根目錄，不要使用全域標記：
npx skills add google-gemini/gemini-skills --skill gemini-api-dev