Google Agents CLI 智能体开发引导
引导智能体从设计、开发到部署与监控的完整流程。
文件明确说明安装、开发、部署、发布和监控范围，并要求用户主动执行安装命令；但未说明所需权限、数据流、敏感数据处理、依赖供应链、外部副作用、确认门槛或回滚方案，因此从中等基线扣分。
生命周期表、命令表和后续步骤基本一致，且包含安装验证步骤；但未提供测试、版本兼容性、异常输入处理或可诊断失败反馈，且使用了“uvx google-agents-cli setup”、`agents-cli` 和 `npx skills add google/agents-cli`等未经文件内验证的路径，因此受静态评估上限并扣分。
元数据清楚覆盖创建、开发、本地运行、调试、测试、评估、部署、发布和监控等场景；但触发范围很宽，未声明不适用场景、输入输出边界、精确触发条件，也未提供中文支持或中国大陆网络可达性说明，因此扣分。
文档结构清晰，按生命周期渐进引导，提供安装命令、命令表、下一步、问题反馈、支持链接，仓库上下文提供Apache-2.0许可证和官方组织来源；但缺少该技能的版本、变更记录、明确维护责任、依赖版本、FAQ和限制说明，因此扣分。
作为入口技能，它能把用户从初始安装引导至不同开发阶段，并给出可直接复制的命令；但核心能力依赖外部CLI及未包含在该路径中的专门技能，命令可用性和最终产出未在文件中验证，用户仍可能需要额外排错，因此受静态上限并扣分。
文件提供了GitHub问题页和文档目录链接，且命令和流程可审阅；但没有提交的测试套件、CI覆盖、版本锁定或第三方执行证据，关键声明主要依赖文档自身，因此仅给有限可验证性分数。
- 安装命令会引入外部CLI和额外技能，但未说明版本、权限范围、依赖完整性校验或卸载/回滚方法。
- 部署、发布、日志记录和BigQuery分析可能产生云资源、费用及敏感数据处理影响；文件未提供确认、最小权限或数据保留指导。
- 触发描述覆盖面很宽，且未说明离线环境、中文交互和中国大陆网络可达性。
这个 Skill 能做什么，适合哪些场景？
这是 Google agents-cli 的入口技能，用于在 Gemini Enterprise Agent Platform 上构建、评估和部署 AI 智能体。它根据用户当前阶段，引导加载工作流、脚手架、ADK 编码、评估、部署、发布和可观测性等专用技能。安装后可使用 agents-cli setup、scaffold、eval、deploy 和 publish 等命令。该技能本身主要负责初始化环境、识别工作流并指导进入开发生命周期。
提供 uvx google-agents-cli setup 或 npx skills add google/agents-cli 安装路径；引导运行 agents-cli info 验证安装；指导在编写代码前收集智能体用途、外部工具和部署目标，并记录到 .agents-cli-spec.md；根据开发阶段匹配专用技能；列出用于脚手架、评估、部署和 Gemini Enterprise 发布的 CLI 命令。
- 希望创建新智能体的开发者，需要先明确需求并生成项目结构。
- 使用 ADK 编写智能体逻辑、工具、回调或状态管理的工程师。
- 需要在本地运行、调试或系统评估智能体的团队。
- 准备将智能体部署到 Agent Runtime、Cloud Run 或 GKE 的开发者。
- 希望把已部署智能体注册为 Gemini Enterprise 工具并配置监控的团队。
这个 Skill 有哪些优点和局限？
- 覆盖从需求澄清到观察的完整智能体开发生命周期。
- 明确区分工作流、脚手架、ADK 编码、评估、部署、发布和可观测性阶段。
- 提供可复制的 CLI 安装和核心操作命令。
- 可衔接 Agent Runtime、Cloud Run、GKE 与 Gemini Enterprise。
- 技能本身是入口和路由层，具体实现依赖安装的专用技能。
- 源材料没有提供测试套件、版本要求或平台兼容矩阵。
- 本地运行和调试的具体命令未在该技能中列出。
- 安装与部署流程可能需要相应的 Google Cloud 环境和权限，但权限清单未说明。
如何安装这个 Skill？
将该技能目录放入兼容 Agent Skills 的技能目录中。安装整个仓库可运行 npx skills add google/skills，随后选择具体技能；只安装 agents-cli 专用技能可运行 npx skills add google/agents-cli，或运行 uvx google-agents-cli setup。源材料未说明兼容客户端的具体技能目录路径。
如何使用这个 Skill？
安装后运行 agents-cli info 验证安装。然后向编码代理提出创建、开发、运行、调试、测试、评估、部署、发布或监控智能体的需求；在 Phase 0 先明确智能体用途、外部工具和部署目标，并写入 .agents-cli-spec.md。可使用 agents-cli scaffold <name> 创建项目、agents-cli eval run 运行并评估、agents-cli deploy 部署，或 agents-cli publish gemini-enterprise 注册。