設定程式碼編寫代理

AI 程式設計助理功能強大，但仍有其限制，例如訓練資料會在特定日期截斷，因此無法掌握新的 API 功能和變更。如果無法存取 Gemini 專屬文件，服務專員可能會建議一般模式，而非最佳化方法。

Gemini API 開發技能可讓程式碼代理程式直接存取最新的 Gemini API 說明文件、整合模式和最佳做法，解決這些問題。這樣一來，專員就能提供更準確且具體的程式碼範例和指引。運用這項技能，程式碼輔助工具就能隨時掌握 Gemini API 的最新發展和建議用法。

這項技能提供的內容

Gemini API 開發技能 (gemini-api-dev)：

  • 引導程式碼代理參閱官方 Gemini API 說明文件
  • 提供建構 Gemini 輔助應用程式的最佳做法
  • 包含常見整合項目的建議模式

以下各節說明如何根據偏好的技能管理生態系統安裝 SDK。這兩項指令都會安裝相同的技能，請在終端機中從任何目錄執行這些指令。

  • 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，即可列出所有有效資訊清單。
Cursor 依序開啟「設定」>「規則」。確認「專員決定」下方顯示 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

資源