1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | agents-cli | — |
| 项目自述名称 | Agents CLI（“The CLI and skills for building agents on Gemini Enterprise Agent Platform”） | GitHub README |
| 作者/维护者 | Google（官方组织仓库） | GitHub API |
| 来源链接 | https://github.com/google/agents-cli | — |
| 许可证 | Apache-2.0 | GitHub API |
| GitHub Stars | 5,354 | GitHub API |
| Forks | 567 | GitHub API |
| 最新版本 | v1.2.1（2026-07-23 发布） | 仓库提交记录 |
| 安装方式 | uvx google-agents-cli setup（装 CLI + 全部技能），或仅装技能 npx skills add google/agents-cli |
官方 README |
2. 功能介绍与亮点
这是 Google 官方发布的一套技能组合，教编码 agent（Claude Code、Codex 等）如何用 Google Agent Development Kit（ADK）构建、评测、部署 AI agent。仓库内 7 个 SKILL.md 首尾相接覆盖一条完整开发生命周期：workflow（开发流程与代码保留规则、模型选型）→ adk-code（ADK Python API 的 agent/tool/编排/回调/状态模式）→ scaffold（项目脚手架的创建/增强/升级）→ eval（评测方法论：指标体系、数据集 schema、LLM-as-judge 评分、失败模式分析）→ deploy（部署到 Agent Runtime / Cloud Run / GKE，含 CI/CD 与密钥管理）→ publish（注册到 Gemini Enterprise）→ observability（Cloud Trace、日志、第三方可观测性集成）。
每个技能都不是单薄的一段提示词，而是配套结构化参考文件：例如 eval 技能自带数据集 schema、指标手册、用户模拟测试、内置工具评测、多模态评测共 5 份参考文档；deploy 技能自带 Cloud Run、Agent Runtime、GKE、Terraform 模式、批量推理、CI/CD 流水线共 6 份参考文档。技能本体全部是纯 Markdown 文档，不含任何随附的可执行脚本，前置元数据里明确声明依赖同名 CLI 工具 agents-cli（uv tool install google-agents-cli 一条命令即可装好）。
主要亮点：
- 官方配有独立文档站（google.github.io/agents-cli），含 Guide / Reference / Tutorial 多级导航，另有一段官方演示视频
- GitHub 累计 57 个 issue，绝大多数来自真实第三方用户（跨 Windows/macOS 环境的实际报障、功能建议），并非仅作者自说自话
- 保持近乎每周一次的版本节奏（v0.3.1 至 v1.2.1，2026-06-08 至 2026-07-23），最近一次发版在 3 天前
- 4 位具名 Google 工程师参与提交，仓库创建仅约 3.5 个月即积累 5,354 星与 567 fork
3. 适用场景
所属分类：元技能与 Agent 增强
适合已经在用 Claude Code、Codex 等编码 agent、又需要在 Google Cloud 上从零构建、评测、部署生产级 AI agent 的开发者：不熟悉 ADK Python API 具体写法、想用规范化流程管理评测数据集与失败分析、或需要把 agent 部署到 Cloud Run / GKE 并接好可观测性与 CI/CD，均可让编码 agent 按需调用对应技能获取实操指导。
4. 跨 Agent 兼容性
- Claude Code：原生支持——README“Works seamlessly with”一栏明确列出 Claude Code；GitHub Issue #15 记录了一名用户实际用 Claude Code 调试并提交本仓库的 Windows 崩溃问题，是可查证的真实使用案例
- Codex：原生支持——同一兼容性声明中列出
- OpenClaw：未验证——README 仅以“any other coding agent”泛称覆盖，未逐一点名该生态
- Hermes Agent：未验证——同上
5. 推荐理由
在 Google Cloud 上构建生产级 AI agent，原本要分别摸清 ADK 的 API 写法、评测指标体系、部署到 Cloud Run/GKE 的基础设施配置、可观测性接入等好几块互不相通的知识，任何一块都容易走弯路。这套官方技能把整条生命周期拆成 7 个环环相扣、各自配有详尽参考文档的技能，背后有同名 CLI 工具真正落地执行，而不只是纸面指导；近 3 天内仍在发版，57 个来自真实用户的 issue 里能看到跨平台报障与具体功能诉求，是目前该细分方向证据最扎实的官方选择。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 9 | Google 官方组织仓库，创建约 3.5 个月即获 5,354 星 / 567 fork；57 个 issue 中可见大量互不相识的真实第三方用户（跨 Windows/macOS 环境报障与功能诉求），非仅作者自问自答 |
| 可用性 | 8 | uvx google-agents-cli setup 一条命令装好 CLI 与全部技能；官方文档站含完整 Guide/Reference/Tutorial；近 3 天内仍有发版；本地开发（脚手架/编码/评测）仅需 AI Studio API key 即可免费跑通，但部署与云端功能需要配置 Google Cloud 项目 |
| 安全性 | 9 | 见下方检查清单 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① shell 命令执行范围 | 技能本体不含任何脚本文件，纯 Markdown 参考文档；指导编码 agent 调用的是另行安装、已发布在 PyPI 的官方 agents-cli 命令行工具（脚手架/评测/部署等），用途在每个 SKILL.md 开头即写明 |
| ② 联网外发 | 部署与发布相关技能会联网到 Google Cloud（Cloud Run/GKE/Agent Runtime）与 Gemini Enterprise，目标透明且均为官方自家服务 |
| ③ API key 存储 | 本地开发用 AI Studio API key，云端功能走标准 gcloud 认证流程，未指导任何非常规凭据存储方式 |
| ④ 可疑指令 | 抓取阅读 eval、deploy 等多份 SKILL.md 全文，未发现面向 AI 助手的可疑指令或混淆内容 |
| ⑤ 作者信誉 | Google 官方组织仓库，署名与官方域名一致，未见刷星或 SEO 操纵痕迹 |
| ⑥ License | Apache-2.0，已核对仓库 LICENSE |
| ⑦ 最近维护 | 最近一次提交在 2026-07-23（3 天前），保持近乎每周发版节奏 |
7. 跟同类 Skills 相比的优势
| Skill | 定位 | 与本技能的差异 |
|---|---|---|
| adk-skill（miticojo） | 个人开发者维护的非官方技能，覆盖 ADK 在 Python/Java/Go/TypeScript 四种语言下的编码模式 | 语言覆盖面更广，但只教编码模式本身，不含脚手架、评测、部署、可观测性等后续生命周期环节，也没有配套 CLI 工具落地执行 |
| agentic-harness-patterns-skill（keli-wen） | 从 Claude Code 源码蒸馏出的通用 agent harness 设计模式手册，不绑定任何云平台 | 偏重通用架构认知，不提供部署到具体云平台的可执行路径；本技能是 Google Cloud/ADK 生态下端到端可落地的官方全流程套件，且有真实 CLI 工具支撑每一步 |
8. 用户评价
GitHub Issue 区可查到多条真实第三方用户互动：开发者 lenintorresact 在 Issue #15 中提交了 Windows 环境下 setup 命令因 Unicode 字符崩溃的详细报告（附本人用 Claude Code 调试的分析过程），该问题已修复关闭，获 10 条跟进讨论；开发者 iAMSagar44 在 Issue #9 中提出希望技能扩展支持 ADK 的 Java/TypeScript/Go 编码模式（当前技能聚焦 Python），获 4 条跟进讨论，仍在开放中。
9. 其他补充
README 的 FAQ 明确建议技能可与其他技能suite 搭配使用：“agents-cli 覆盖 agent 构建生命周期本身，相邻需求可另装其他技能，例如 addyosmani/agent-skills 覆盖通用软件工程流程，google/skills 覆盖 BigQuery、Cloud Run、Firebase、GKE 等 Google Cloud 基础设施”，体现了技能间的组合式设计思路而非大而全捆绑。
10. 安装使用方式
- 完整安装（推荐）：
uvx google-agents-cli setup，同时装好 CLI 工具与全部 7 个技能到编码 agent - 仅装技能：
npx skills add google/agents-cli，编码 agent 会按需调用 CLI 命令 - PyPI 包：
pip install google-agents-cli或uv tool install google-agents-cli - 安装后无需重启；对话中提出“用 agents-cli 构建/评测/部署一个 agent”之类需求即会触发对应技能
11. 注意事项
- 本地开发（脚手架、编码、评测）可仅用 AI Studio API key 免费跑通；部署到 Cloud Run/GKE/Agent Runtime 与发布到 Gemini Enterprise 需要配置 Google Cloud 项目，可能产生云资源费用
- 当前技能内容聚焦 Python/ADK，Java、TypeScript、Go 等语言的编码模式尚在社区诉求阶段（见 Issue #9），暂未覆盖
- OpenClaw、Hermes Agent 的兼容性未经验证，官方仅以“any other coding agent”泛称覆盖