agents-cli 是什麼、怎麼安裝使用：Google 官方的智能體開發 CLI 與 7 個 Skills（用 ADK 搭建、評測、部署 Agent）

本文根據 google/agents-cli 倉庫 README 整理，資料核對於 2026-10-11。截至當日，GitHub 顯示該倉庫約 6068 Star、692 Fork，最近一次推送在 2026-10-06；skills.sh 榜單上它的 7 個技能累計安裝各約 48.6 萬次（含整庫安裝的計數）。命令與技能以倉庫為準。

是什麼

agents-cli 的全稱是「Agents CLI in Agent Platform」，README 的一句話介紹是：用於在 Gemini Enterprise Agent Platform 上構建智能體的 CLI 和技能。它的定位寫在常見問題裏——它不是 Claude Code、Codex 的替代品，而是給編程智能體用的工具：提供命令和技能，讓你的編程智能體更擅長在 Google Cloud 上構建、評測和部署基於 ADK 的智能體。ADK 是 Google 的智能體開發框架，agents-cli 則把「從建項目到上線」這一整條線交給編程智能體來操作。

README 還回答了一個常被問到的問題：需不需要 Google Cloud？本地開發（創建、運行、評測）不需要，用 AI Studio 的 API Key 就能在本地跑 Gemini；部署和雲端功能才需要。

包含哪些 Skill

README 列出 7 個技能：

• google-agents-cli-workflow：開發生命週期、代碼保護規則、模型選擇；
• google-agents-cli-adk-code：ADK 的 Python 接口——智能體、工具、編排、回調、狀態；
• google-agents-cli-scaffold：項目腳手架，對應 create、enhance、upgrade；
• google-agents-cli-eval：評測方法——指標、數據集、用大模型當評委、自適應評分標準；
• google-agents-cli-deploy：部署——Agent Runtime、Cloud Run、GKE、CI/CD、密鑰管理；
• google-agents-cli-publish：註冊到 Gemini Enterprise；
• google-agents-cli-observability：可觀測性——Cloud Trace、日誌和第三方集成。

對應的主要命令有 agents-cli create <名稱>（新建項目）、agents-cli eval run（在評測集上運行並打分）、agents-cli deploy（部署到 Google Cloud）、agents-cli publish gemini-enterprise、agents-cli login（用 Google Cloud 或 AI Studio 認證），以及給已有項目補上部署和 CI/CD 的 agents-cli scaffold enhance。

怎麼安裝

前置條件是 Python 3.11 以上、uv 和 Node.js。README 給了兩種裝法。

只裝技能，其餘讓編程智能體自己處理：

bash
npx skills add google/agents-cli

連同命令行一起裝：README 的寫法是用 uv 的一次性運行器（uvx）執行 PyPI 包 google-agents-cli 的 setup 子命令，等價的完整寫法是：

bash
uv tool run google-agents-cli setup

它會把 CLI 和技能一起裝進你的編程智能體。

怎麼用

裝好後打開你常用的編程智能體，直接提需求：

• README 的示例：「用 agents-cli 做一個把囉嗦文字壓縮成簡短技術短句的智能體」；
• 「給這個智能體寫一組評測用例，跑一遍並告訴我哪些沒過」；
• 「給現有的 ADK 項目加上部署到 Cloud Run 的配置和 CI」。

不用編程智能體也可以：CLI 本身能獨立使用，所有命令都可以在終端裏直接運行。

適合誰 / 不適合誰

適合：

• 打算用 Google 的 ADK 和 Gemini 做智能體的開發者；
• 已經在 Google Cloud 上、想把評測和部署流程標準化的團隊。

不適合：

• 用其他框架（如 LangGraph、CrewAI）或不打算上 Google Cloud 的項目；
• 只想找通用編程技能的人，這套技能的內容全部圍繞 Google 的技術棧。

注意事項

• 許可：GitHub 標註 Apache-2.0；倉庫另有服務條款一節。
• 遙測：README 說明預設每次命令調用會發出一條使用信號，寫入你自己的 Google Cloud 項目的日誌，只記錄命令名、退出碼、錯誤類別、耗時、版本和操作系統等元數據，不含文件內容和參數；寫日誌的請求頭裏還帶有供 Google 做使用分析的版本、系統和命令名資訊。README 提供了關閉它的環境變量。
• 費用：部署會在你的 Google Cloud 帳號下創建計費資源，模型調用按 Gemini 的價格計費。
• 憑據：登入用的是你的 Google Cloud 或 AI Studio 身份；部署技能的內容涵蓋密鑰管理，API Key 不要寫進倉庫。
• 國內網絡訪問 Google 服務受限，使用前確認網絡與帳號條件。