google/agents-cli：给 AI 编程工具装上 Google Cloud Agent 开发套件

想象一下：你让 AI 编程助手去开发一个企业级 AI Agent，它能自动生成代码、自动跑评估、自动部署到 Google Cloud——整个流程无需你敲一行命令。这不是科幻，而是 agents-cli 正在做的事。

背景：AI Agent 开发的最大痛点

Google 在 2025-2026 年密集发布了 Agent 开发工具全家桶：

• ADK（Agent Development Kit）：Python/Go/Java 多语言的 Agent 开发框架
• Agent Platform：企业级 Agent 运行时平台（Agent Runtime）
• Gemini Enterprise：企业版 Gemini Agent 平台

工具虽强，但门槛不低。开发者需要同时掌握 ADK API、Vertex AI、Cloud Run、GKE、CI/CD 配置等一堆技术，学习曲线陡峭。agents-cli 的出现，正是为了把这个流程自动化——它把 Google 工程师的部署经验封装成一套可复用的 CLI 命令和 Skill 模块，让 AI 编程助手（Claude Code、Gemini CLI、Codex 等）能够替你完成从零开发到云端部署的全流程。

核心功能：六个 Skill 模块覆盖全生命周期

agents-cli 包含六个核心 Skill，每个对应 Agent 开发的一个阶段：

六个 Skill 组合起来，就构成了一个完整的 Agent 开发知识体系。AI 编程助手加载这些 Skill 后，就相当于拥有了 Google 工程师的 Agent 开发经验——知道什么时候该用什么模型、评估数据怎么设计、Cloud Run 和 GKE 怎么选。

部署体验：从本地原型到云端生产

agents-cli 将 Agent 开发路径划分为清晰的三阶段：原型验证 → 评估迭代 → 生产部署。

本地开发阶段：只需 uvx google-agents-cli setup 一条命令即可安装。没有 Docker，不依赖任何云服务。本地开发可以用 AI Studio API Key 调用 Gemini，不需要 Google Cloud 账号。

评估迭代阶段：agents-cli eval generate 自动在评估数据集上跑 Agent 并生成 Trace；agents-cli eval grade 用 LLM-as-Judge 对 Trace 评分；agents-cli eval optimize 还能根据评估结果自动调优 Prompt。

生产部署阶段：agents-cli deploy 支持一键部署到 Agent Runtime（Cloud Run 后端）、Cloud Run 或 GKE。agents-cli scaffold enhance 可以给已有项目补上部署和 CI/CD 能力。

技术架构：CLI + Skill 的双层设计

agents-cli 的设计理念是「工具本身不智能，工具让 AI 编程助手变智能」。

CLI 层提供原子命令（scaffold、eval、deploy），可以直接在终端敲命令运行，适合不想被 AI 编程助手「绑架」的开发者。Skill 层则将这些能力以自然语言描述的方式注入到 AI 编程助手，使后者能理解并自动执行复杂的多步骤 Agent 开发流程。

Skill 格式兼容 Superpowers/agent-skills 体系，支持 Claude Code、Codex、Gemini CLI 等主流工具，通过 npx skills add google/agents-cli 即可安装。

代码质量方面：采用 Python + TypeScript + Shell 混编，Python 是 CLI 核心逻辑，TypeScript 用于 IDE 集成插件，Shell 用于部署脚本。代码风格通过 Ruff lint 检查，有 GitHub Actions CI 流水线。

适用场景与局限

适合的场景：

• 企业内部需要快速批量开发 ADK Agent 团队
• 需要将 Agent 部署到 Google Cloud 的开发者
• 想让 AI 编程助手自动化执行完整 Agent 开发流程的高级用户

局限：

• 核心能力绑定 Google Cloud 生态，本地开发可用 AI Studio Key 绕过，但生产部署必须依赖 Google Cloud
• 目前以 Python ADK 为主要集成对象，其他语言（Go/Java）支持较间接
• 预发布阶段（Pre-GA），API 可能变动，不适合对稳定性要求极高的生产场景

行业意义

agents-cli 代表了 AI 开发工具的一个新趋势：工具自我封装为 AI 可读的 Skill，让 AI 编程助手变成更专业的领域专家。过去 AI 编程助手在陌生领域（如 Google Cloud 部署）常常「有心无力」，现在通过加载特定领域的 Skill，可以快速获得该领域的最佳实践。

随着 ADK 2.0 的发布和 Gemini Enterprise Agent Platform 的成熟，agents-cli 的能力边界还会持续扩展。它正在成为 Google Cloud 生态中 Agent 开发的事实标准工具链。