設定程式碼編寫代理

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

資源