1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | Build and deploy AI agents on Google Cloud（google-cloud-solution-build-deploy-agents） |
| 作者/维护者 | Google（google/skills 仓库） |
| 来源链接 | https://github.com/google/skills/tree/main/skills/cloud/google-cloud-solution-build-deploy-agents |
| 许可证 | Apache-2.0（数据来源：GitHub API） |
| GitHub Stars | 18,646（数据来源：GitHub API；该数字属整个 google/skills 合集仓库，不代表本技能自身热度） |
| Forks | 1,491（同上，合集整体数据） |
| 最新版本 | 仓库不发布正式 release，持续滚动更新；本技能目录最近一次提交为 2026-08-06（数据来源：GitHub API） |
| 安装方式 | npx skills add google/skills 交互式勾选安装，或手动复制 skills/cloud/google-cloud-solution-build-deploy-agents/ 目录到 agent 的 skills 目录 |
2. 功能介绍与亮点
这是一个引导 agent 在 Google Cloud 上完成“设计并落地一套 AI agent 或多 agent 系统”全流程的架构技能，与专注单一垂直场景（GKE 迁移、n 层 Web 应用、企业 RAG）的同系列技能不同，覆盖面是通用的 agent 系统构建：
- 四阶段确定性工作流（需求发现与分析 → 方案设计 → 实施计划 → 方案验证），每阶段结束都要求用户审阅批准才能进入下一步；正文明确规定在需求存在歧义或矛盾时必须先与用户澄清，禁止在此之前直接生成架构建议。
- 单/多 agent 设计模式推荐：根据任务复杂度、工作流形态、延迟与成本要求，明确给出“单 agent 系统”还是“多 agent 协作系统”的选型建议，而非笼统建议上多 agent。
- 随包提供完整参考与模板体系：
references/下 3 份文件（产品映射、设计原则、关联指导文档，合计约 20KB）与assets/下 3 份产出模板（方案架构、实施说明、验证计划，合计约 8KB），要求 agent 直接引用复用而非凭经验现写。 - 实施阶段绑定官方 Agents CLI：明确要求指导用户使用
agents-cli scaffold/agents-cli deploy/agents-cli eval run等官方命令行工具完成脚手架搭建、部署与质量评测，并要求生成的部署说明必须包含 ADK 有状态 agent 节点代码示例、通过 MCP 标准注册工具、Cloud Run 场景下的缩容到零配置。 - 凭据处理有明确安全要求：正文强制要求部署说明必须建议使用加密环境变量存储模型参数或私有 API 凭据，避免明文出现在容器日志流中。
亮点：Google 官方出品；开源可审计（Apache-2.0）；同分组内内容体量最大（SKILL.md 13.8KB + 支持文件约 28KB）；核心路径基于标准 gcloud/Agents CLI 命令，不强制依赖 MCP 工具上下文。
3. 适用场景
固定分类：DevOps 与基础设施。
适用于需要在 Google Cloud 上从零设计并部署一套 AI agent 或多 agent 系统、但不确定该选单 agent 还是多 agent 架构的团队；适用于希望有一套标准化四阶段流程（需求→设计→实施→验证）来约束 agent 系统交付质量、而非临场发挥的平台工程师；也适用于计划采用 Google 官方 Agents CLI 与 ADK 工具链、需要一份贴合该工具链的部署指导的开发者。
4. 跨 Agent 兼容性
- Claude Code：原生支持——仓库 README 明确列出
claude plugin marketplace add google/skills安装路径，随后claude plugin install <plugin>@google-plugins即可；也可通过通用的npx skills add google/skills勾选安装。 - Codex：原生支持——仓库 README 明确列出
codex plugin marketplace add google/skills，随后从/plugins浏览器安装；同样支持npx skills add通用安装路径。 - OpenClaw：未验证——本技能是遵循 agentskills.io 通用 SKILL.md 规范的纯文本技能（无绑定专有工具），理论上可手动复制安装，但未见到
google/skills针对该 agent 的专门说明。 - Hermes Agent：未验证——Hermes 官方支持从任意 GitHub 仓库安装单个技能，路径与本仓库结构吻合，但未找到已有用户在 Hermes 上安装本技能的具体记录。
5. 推荐理由
团队想用 AI agent 落地一个业务场景时，常见的困境是不知道该选单 agent 还是多 agent 架构、该用哪些 Google Cloud 产品拼装、以及部署上线后如何验证质量——这个技能把“先摸清需求与设计约束、再给出选型建议与技术栈映射、再落成可执行的部署说明与 IaC、最后自动生成验证清单”固定成一条标准流程，且四个阶段结束都要用户确认才推进，避免在需求不清楚时就仓促生成架构。相比同分组内聚焦单一垂直场景的技能，它是覆盖面最通用的一个，适合作为“不确定该用哪个更专项的技能”时的默认起点。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 发布方 Google 为一线云厂商且是 Cloud Run/Agent Platform/ADK 等相关产品的所有者，属官方出品；google/skills 合集仓库 18,646 星不计入单个子技能，检索 GitHub Issue 标题（0 命中）与公开网络均未找到针对本技能自身的独立第三方讨论 |
| 可用性 | 9 | 四阶段流程完整、随包提供 3 份参考文档与 3 份产出模板；核心路径基于标准 gcloud 命令与官方 Agents CLI，不强制依赖 MCP 工具上下文；技能目录最近提交 2026-08-06，维护活跃；零已知 GitHub issue |
| 安全性 | 9 | 官方出品、开源可审计；四阶段每阶段末尾均设置“请求用户审阅批准”关卡，禁止在需求存在歧义时直接生成架构；正文强制要求用加密环境变量存储模型参数与 API 凭据，避免明文写入容器日志；未见可疑指令或数据外发迹象 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令执行范围 | 生成 Terraform/IaC 代码、gcloud 与 agents-cli 部署命令，但均需用户审阅批准后自行运行，不自动执行改动性操作 |
| ② 运行时联网外发 | 核心工作流不联网；生成的部署方案本身会联网调用 Google Cloud API，但这是用户主动执行的部署动作，非技能本身静默外发 |
| ③ API key/凭据 | 正文未要求向技能本身提供任何 API Key；认证依赖用户本机既有的 gcloud 登录态；正文强制要求部署说明中用加密环境变量存储模型参数与私有凭据 |
| ④ 可疑指令/注入迹象 | 未发现 |
| ⑤ 作者/组织信誉 | Google 官方仓库，无造假迹象 |
| ⑥ License | Apache-2.0，明确 |
| ⑦ 最近维护时间 | 技能目录最近提交 2026-08-06，所属仓库整体最近提交 2026-08-22，持续维护中 |
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 与本技能的差异 |
|---|---|---|
| Google_Cloud_Solution_N_Tier_Serverless_Web_App_Google_Skills | 同仓库姊妹技能，专注安全 n 层 serverless Web 应用的网络隔离架构 | 技术栈锁定 Cloud Run + Cloud SQL 三层 Web 应用，不涉及 agent 设计模式选型或 ADK/Agents CLI 部署链路 |
| Google_Cloud_Solution_Guided_Gke_Ai_Migration_Google_Skills | 同仓库姊妹技能，引导把既有 AI 推理负载迁移到自托管 GKE | 落点是存量工作负载的迁移与显存换算，面向“已有系统要搬家”，而非“从零设计新 agent 系统” |
| Google_Cloud_Solution_Architecture_Google_Skills | 同仓库姊妹技能，通用 Google Cloud 方案架构工作流 | 正文明确写明“通用云架构场景应改用该技能，本技能专用于 agent/多 agent 系统”——两者互相指向对方适用的场景，覆盖范围不重叠 |
8. 用户评价
该技能目前在 GitHub Issues、Reddit、Hacker News 等第三方渠道尚无独立具名用户评价。
9. 其他补充
该技能是 google/skills 仓库“Multi-product solution skills”分组下的技能之一，与同分组的 n 层 Web 应用、GKE AI 迁移、企业 RAG 检索、数据科学工作流等技能共享统一的四阶段工作流设计模式，但各自锁定不同的架构落点，形成互补矩阵而非重叠覆盖。另有一个独立的 google/agents-cli 项目自带其部署类技能，来源仓库与本技能不同，使用前请注意区分。
10. 安装使用方式
- 一键安装：
npx skills add google/skills，安装过程中勾选 “Build and deploy AI agents on Google Cloud”。 - 插件市场（Claude Code）：
claude plugin marketplace add google/skills，再执行claude plugin install <plugin>@google-plugins。 - 插件市场（Codex）：
codex plugin marketplace add google/skills，再从/plugins浏览器中选择安装。 - 手动安装：将仓库
skills/cloud/google-cloud-solution-build-deploy-agents/（含SKILL.md、assets/与references/子目录）复制到本地 agent 的 skills 目录。 - 使用前需完成
gcloud auth login认证；若按正文建议使用 Agents CLI 完成脚手架与部署，还需另行安装agents-cli。首次对话时表达“帮我设计并部署一个 AI agent 系统”意图即可触发需求发现阶段。
11. 注意事项
- 定位是“人工审阅引导式”架构设计与部署指导工具，不是全自动部署工具；每阶段产出都需用户确认，最终的部署命令仍需用户自行审阅后执行。
- 正文明确不适用于通用 Google Cloud 方案架构（无 agent 上下文）或针对单一产品的窄任务，这类场景应改用同仓库其他技能。
- 实施阶段的部署说明大量绑定 Google 官方 Agents CLI 与 ADK 工具链，若团队采用其他 agent 开发框架，指导的贴合度会下降。
- 跨 Agent 兼容性仅确认 Claude Code / Codex，OpenClaw / Hermes Agent 未验证。