技能包

用 gemini-api-dev 按最佳實務寫 Gemini API 呼叫

適合要讓代理按 Interactions API 寫 Gemini 呼叫程式的人,前提是先用官方 npx skills add 安裝 gemini-api-dev;這不是 Google 官方支援的產品。

官方來源 · gemini-skills

安裝

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

適合誰

你要讓代理按 Gemini API、SDK 和模型互動來寫呼叫程式時,用這組技能庫。源文把它寫成 Gemini API、SDK 與模型互動的技能庫,並單獨點名 gemini-api-dev:面向 Interactions API 的應用開發,涵蓋文字生成、多輪對話、串流輸出、函式呼叫、結構化輸出、圖像生成、Deep Research agents、已棄用模型的護欄,以及 Python 與 TypeScript SDK。文件見

https://ai.google.dev/gemini-api/docs/interactions?ua=chat

官方倉庫是

https://github.com/google-gemini/gemini-skills

源文寫明可以把這些技能裝到你常用的 AI 程式設計助手和套件管理器,但沒有點名具體產品,不要自行補用戶端名單,也不要寫成某幾個環境獨占。還沒有準備在本機執行官方 npx 命令時,先不要繼續。

源文還寫明:這不是 Google 官方支援的產品,也不能參加 Google 開源軟體漏洞獎勵計畫。評測數字只說明裝上該技能後,代理產生正確 API 程式的比例有變化,不要把它當成你本機一次呼叫的成功標準。也不要因為評測提到兩個模型,就推斷技能只能在這兩個模型上使用。技能庫裡可能還有其他技能,但源文只把 gemini-api-dev 寫成可複製的安裝例子,第一次不要自行點名未出現的技能。

3 分鐘完成第一次嘗試

先打開官方倉庫核對:

https://github.com/google-gemini/gemini-skills

推薦路徑是官方的 npx skills add。第一次先做瀏覽,不要先裝一堆技能。瀏覽是互動式的,執行前確認你只是查看清單:

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

看到清單後,源文給出的具體例子是 gemini-api-dev。安裝會往本機寫入技能檔,執行前確認你只要這一份:

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

不要改成未出現的技能名,也不要發明第二條安裝器。源文沒有寫技能落盤目錄,不要自行補路徑。

第一次在代理裡只做核對,不要先調真實 API,也不要產生圖像或啟動 Deep Research。請代理說明 gemini-api-dev 涵蓋哪些 Interactions API 能力,以及這不是官方支援的 Google 產品。觀察點是它能複述文字生成、多輪對話、串流輸出、函式呼叫、結構化輸出,以及 Python 與 TypeScript SDK,並且還沒有出網。

真正寫呼叫程式會出網,也可能消耗配額。只有當你準備好使用自己的 Gemini 憑證時再繼續;源文沒有給出金鑰欄位名,不要寫佔位金鑰。第一次不要碰圖像生成或 Deep Research。

使用案例

案例一:先瀏覽再裝一份技能。執行 npx skills add google-gemini/gemini-skills --list,確認清單裡能看到技能後再裝 gemini-api-dev。適合只想把 Interactions API 技能接到代理、還不準備發請求的人。成功訊號是 list 能打開,並且指定技能的安裝命令正常結束。源文沒有寫 list 的完整欄位,不要編造其他 --skill 名稱。

案例二:先核對接線範圍,再決定要不要寫程式。裝好 gemini-api-dev 後,讓代理複述它涵蓋文字生成、多輪對話、串流輸出、函式呼叫、結構化輸出、圖像生成、Deep Research agents、已棄用模型護欄,以及 Python 與 TypeScript SDK。適合擔心代理會直接出網或產生圖像的人。成功訊號是它能把範圍說清楚,並且承認這不是官方支援產品。需要寫真實呼叫時,先確認本次會存取 Gemini API,並自己準備憑證;源文沒有給出請求樣例參數,不要編造。評測裡提到的 Gemini 3 Flash 與 Gemini 3.1 Pro 數字,不要當成你必須重現的基準。

使用邊界

主路徑是 npx skills add google-gemini/gemini-skills,瀏覽用 --list,例子技能是 --skill gemini-api-dev。不要發明其他技能名或安裝器。源文說可以裝到常用的 AI 程式設計助手和套件管理器,但沒有點名產品,不要補名單,也不要寫成獨占範圍。

這不是官方支援的 Google 產品。漏洞獎勵計畫說明見

https://bughunters.google.com/open-source-security

能力停在 Interactions API 的上述條目和兩種 SDK。圖像生成與 Deep Research 有外部副作用,第一次不要做。源文沒有寫金鑰欄位、配額或解除安裝步驟。沒有寫到的模型名單、用戶端名單和請求參數,不要補全。第一次成功只看瀏覽命令或安裝結束,以及代理能複述範圍;真正出網前必須先確認憑證和本次會存取 API。源文沒有寫解除安裝或更新命令,不要自行補第二條安裝器。若代理開始產生圖像或啟動 Deep Research,先停下來,回到唯讀說明。評測百分比不能代替你自己的一次成功訊號。