Google Cloud AI Agent 构建部署顾问
帮助设计、实现并验证部署在 Google Cloud 上的 AI Agent 与多 Agent 系统。
流程要求需求确认、架构批准、实施计划批准和验证批准，并明确最小权限、OIDC、Model Armor、人工介入、加密环境变量和部署 dry-run，显示出较好的安全意识；但未给出具体 IAM 权限边界、完整数据流和敏感数据生命周期，也未规定可执行的回滚方案，且 IaC/部署可能产生外部资源变更，因此扣分。
四阶段流程一致，包含模板、验证检查和异常部署协助，主路径可理解；但未提供已执行的测试、固定依赖版本、关键命令的完整可复现示例或具体失败诊断与恢复逻辑，且大量内容依赖外部文档和占位符，因此静态评估限制在 10 分以下并扣分。
名称、目标用户、适用场景以及不适用于通用架构或单产品窄任务的边界较清楚，且会根据需求选择单代理或多代理；但输入字段、输出契约和触发条件仍较概括，没有中文交互支持说明，也未处理中国大陆访问 Google Cloud 相关服务的可达性，因此扣分。
SKILL.md 采用清晰的阶段化结构，并提供相关指南、产品映射、设计原则和三个输出模板；仓库提供 Apache-2.0、安装方式、贡献渠道和维护中的说明。但该技能没有独立版本、变更记录、明确维护责任人、依赖版本、FAQ 或完整故障排查说明，因此扣分。
技能明确承诺生成架构文档、Mermaid 图、IaC、部署说明和验证计划，核心交付物方向直接可用；但模板主要是骨架，精确 ADK/MCP 代码和具体部署细节需动态生成并依赖外部资料，未提供已验证的代表性输出，仍可能需要较多审阅和修订，因此按静态上限保守评分。
证据包括技能自身的引用清单、产品映射、模板和仓库级许可证/安装说明，且主要指向官方材料；但未提供测试套件、CI 覆盖、执行日志或独立复现证据，无法静态验证关键路径，因此不超过 5 分并扣分。
- 部署和 IaC 可能修改真实云资源；在执行前应明确项目、区域、IAM 权限、变更范围、审批人和可回滚方案。
- 不要把模板中的占位符、示例命令或产品推荐视为已验证配置；应核对当前官方文档、API 可用性、配额、区域支持和费用。
- 技能未说明中文支持及中国大陆网络可达性；面向大陆用户时需预先验证相关 Google Cloud、文档和 CLI 服务的访问条件。
- 敏感数据检测、日志脱敏、密钥管理和代理工具权限需要针对具体工作负载补充明确规则。
这个 Skill 能做什么，适合哪些场景？
该技能面向需要在 Google Cloud 上设计或实现 AI Agent 系统的用户。它通过需求发现、方案设计、实施规划和方案验证四个阶段推进工作。技能可根据复杂度、工作流、延迟和成本需求推荐单 Agent 或多 Agent 模式，并生成架构、部署和验证材料。它专注于带有 Agent 上下文的 Google Cloud 解决方案，不适用于一般云架构或单一产品的狭窄任务。
收集功能与非功能需求、现有系统、知识库和依赖信息；识别歧义并要求确认；推荐单 Agent 或多 Agent 设计模式；拆解技术组件并映射到 Google Cloud 产品；生成 Mermaid 架构图；编写 solution-architecture.md、implementation-instructions.md 和 validation-plan.md；规划 Terraform、Agents CLI、gcloud、curl 及 MCP 相关部署和验证步骤。
- 云架构师为新的 AI Agent 工作负载收集需求并确认技术分解。
- 平台工程师为 Google Cloud 上的 Agent 系统制定产品选型、架构图和部署方案。
- 开发团队需要生成包含 Terraform 或 Agents CLI 步骤的 Agent 实施说明。
- 运维团队需要为已部署的 Agent 检查网络路由、IAM、安全策略和服务端点。
- 需要在部署前使用本地运行、评估和 dry-run 流程验证 Agent 质量的团队。
这个 Skill 有哪些优点和局限？
- 覆盖需求分析、架构设计、实施规划和验证的完整流程。
- 明确要求在关键阶段获得用户确认并支持迭代。
- 涵盖 Mermaid 架构图、Terraform、Agents CLI、MCP、Cloud Run 成本控制和安全凭据处理。
- 可处理跨云、混合云和本地组件的集成分析。
- 需要相关 references 和 assets 文件才能完整执行其文档生成流程；提供的材料未包含这些文件的内容。
- 技能本身不提供具体工作负载的现成架构，必须先获得足够需求并经过确认。
- 源材料未提供测试套件、支持的平台清单或实际部署结果。
- 实施和验证依赖 Google Agents CLI、Terraform、gcloud CLI、curl 以及云环境权限。
如何安装这个 Skill？
安装整个技能集合：npx skills add google/skills。安装过程中选择 skills/cloud/google-cloud-solution-build-deploy-agents。源材料未说明具体安装目录或单独安装命令。
如何使用这个 Skill？
在已安装该技能的 Agent 客户端中提交具体请求，例如：为一个需要访问企业知识库并部署到 Google Cloud 的多 Agent 系统设计、实施并验证方案。 提供功能需求、非功能需求、现有系统、知识库和依赖；技能会按阶段请求确认。
这个 Skill 与同类方案有什么区别？
与同仓库的 Google Cloud solution-architecture 技能相比，本技能专门面向 AI Agent 或多 Agent 系统；一般 Google Cloud 解决方案架构应使用前者。