1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | gke-upgrades-google-skills |
| 作者/维护者 | Google Cloud（仓库账号 google，维护团队内部代号 Cloud IX Team） |
| 来源链接 | https://github.com/google/skills/tree/main/skills/cloud/gke-upgrades |
| 许可证 | Apache-2.0（GitHub API 确认） |
| GitHub Stars / Forks | 15,235 / 1,192（GitHub API 实测；该数字为仓库整体，本技能所在子目录不单独统计 star，仅作背景参考） |
| 最新版本 | 无正式 Release/Tag，滚动更新；本技能所在子目录最近一次实质性提交为 2026-07-18 |
| 安装方式 | npx skills add google/skills，安装时从交互列表勾选本技能 |
2. 功能介绍与亮点
gke-upgrades 是 Google Cloud 官方维护的 GKE（Google Kubernetes Engine）升级与维护规划技能，专门处理集群版本升级、节点池维护这一类高风险运维操作，与同仓库聚焦安全配置、成本优化等其他运维环节的姊妹技能明确分工。
主要亮点：
- 三份配套参考文档：除主 SKILL.md 外，另附
checklists.md（升级前/中/后清单模板）、runbook-template.md（维护运行手册模板）、troubleshooting.md（9 类常见升级卡顿场景的诊断流程图，含每类问题的诊断命令与修复命令），内容深度明显超出同批次姊妹技能。 - 覆盖 Standard 与 Autopilot 双模式：区分节点池升级策略（surge、blue-green）、控制面与节点版本偏差规则（节点最多落后控制面 2 个次版本）、发布渠道（Rapid/Regular/Stable/Extended）选型与支持周期。
- 不依赖专有 MCP 工具：正文全程给出标准
gcloud/kubectl命令，未像同仓库部分姊妹技能那样声明依赖 Google 专有 MCP 服务器，任何能生成命令文本的编码助手均可直接使用。 - 官方持续投入：隶属 Google 于 2026-04-22 Cloud Next 大会公开发布的官方技能仓库，GKE 是首批覆盖的产品之一；本子目录近一个月内仍有实质性内容修复提交。
3. 适用场景
所属固定分类：DevOps 与基础设施
- 需要规划 GKE 集群版本升级、编写升级前检查清单或维护运行手册的 DevOps / SRE / 平台工程师。
- 升级卡住（Pod 无法驱逐、节点资源不足、GPU 驱动回归等）需要快速定位原因的运维人员。
- 希望借助编码助手统一多集群（dev/staging/prod）升级节奏、落实发布渠道与维护窗口策略的初中级 GKE 用户。
4. 跨 Agent 兼容性
| Agent | 结论 | 判断依据 |
|---|---|---|
| Claude Code | ✅ 原生支持 | 底层分发工具（npx skills，即 vercel-labs/skills）官方支持列表明确列出 claude-code，安装路径 .claude/skills/ |
| Codex | ✅ 支持 | 同一分发工具支持列表明确列出 codex，安装路径 .agents/skills/ |
| OpenClaw | ✅ 支持 | 同一分发工具支持列表明确列出 openclaw，安装路径 skills/（项目级）/ ~/.openclaw/skills/（用户级） |
| Hermes Agent | ✅ 支持 | 同一分发工具支持列表明确列出 hermes-agent，安装路径 .hermes/skills/ |
技能内容本身为纯 Markdown 文本（SKILL.md + 参考文档），不含任何平台专有代码，四个生态均可直接安装使用。
5. 推荐理由
GKE 集群升级是高风险但发生频率不算高的操作，团队常常缺乏系统化流程，容易漏检 PodDisruptionBudget、版本偏差、GPU 驱动兼容性等细节导致升级卡住。这个技能把升级全生命周期（前置检查、执行策略、卡顿排障、维护窗口管理）整理成可直接套用的清单、运行手册模板与 9 类故障诊断流程图，且不依赖任何专有工具，编码助手可直接生成落地文档。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 官方 Google Cloud 团队维护，隶属 2026-04-22 公开发布、仓库整体 15,235 stars 的官方技能仓库；该数字属整个合集，不代表本技能自身热度——本子目录自身未查得可归属的独立第三方 PR/issue 讨论 |
| 可用性 | 9 | npx skills add 一条命令即可选装；除 SKILL.md 外另附 3 份结构化参考文档（清单、运行手册模板、故障排查流程图）；子目录最近一次实质提交为 2026-07-18；无需额外付费依赖，仅需用户自有 GCP 账号 |
| 安全性 | 9 | 见下方检查清单 |
| 综合 | 8.3 | 三项均值 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令执行及权限范围 | 无内置可执行脚本——技能全部内容为 Markdown 指导文本，正文中的 gcloud/kubectl 命令仅作为给用户参考的文本，不由技能自身触发执行 |
| ② 运行时联网外发数据 | 未发现——技能不含任何网络请求逻辑 |
| ③ API key/凭据要求及存储方式 | 不要求任何密钥；正文命令假设用户已有自己的 gcloud 登录态，技能本身不存储任何凭据 |
| ④ SKILL.md 与脚本中可疑指令 | 亲自抓取 SKILL.md 及 3 份参考文档全文逐段核实，未发现 prompt injection 或数据外发迹象 |
| ⑤ 作者/组织信誉 | 官方 Google Cloud 团队，无造假迹象 |
| ⑥ License 是否明确 | 明确，Apache-2.0 |
| ⑦ 最近维护时间 | 本子目录最近一次实质更新为 2026-07-18 |
7. 跟同类 Skills 相比的优势
| 维度 | gke-upgrades-google-skills（本推荐） | AKS Agent Skills（微软官方，AKS 工程团队出品） |
|---|---|---|
| 定位 | 专精 GKE 集群升级与维护全生命周期 | 覆盖 AKS 网络、升级策略、安全、可靠性、扩展等多主题的最佳实践技能，另配一个独立故障排查技能 |
| 升级相关深度 | 独立成技能，含 9 类升级卡顿场景诊断流程图、清单模板、运行手册模板 | 升级策略是“最佳实践技能”内的一个子主题，与其他运维主题共用篇幅，未见专门的升级故障诊断流程图 |
| 覆盖云平台 | 专注 Google GKE | 专注 Azure AKS |
| 输出物形式 | 结构化清单/运行手册/诊断流程图三件套 | 生产级指导、故障排查清单与防护措施 |
核心差异化：AKS Agent Skills 采用“一个技能覆盖多个运维主题”的广度路线，升级策略只是其中一节；本技能反其道而行，把升级这一个高风险环节做深做透，提供可直接套用的清单与逐场景诊断流程，更适合正处在升级窗口、需要严谨流程的团队。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价，Reddit、Hacker News 等社区渠道均未见相关讨论。
9. 其他补充
同一仓库内还收录了覆盖 GKE 其他运维环节（工作负载安全、成本优化、集群基线配置等）的官方技能，可按实际运维阶段组合安装，不属于本技能的功能范围。
10. 安装使用方式
- 通用方式（Skills CLI）：
npx skills add google/skills，从交互列表中勾选gke-upgrades - 支持平台：分发工具官方支持列表包含 Claude Code、Codex、OpenClaw、Hermes Agent 等 70 余种编码助手
- 安装后无需重启宿主 Agent；在涉及 GKE 版本升级、节点池维护、升级卡顿排查等对话场景中，Agent 会依据
description字段自动匹配并加载本技能
11. 注意事项
- 技能本身不执行任何操作，正文提供的
gcloud/kubectl命令需要用户自行在已认证的 GCP 环境中执行并核实 - 内容假设用户已具备 GKE 集群访问权限与基本 Kubernetes 概念，不适合尚未开通 GCP 账号的用户直接使用
- 无正式 Release/Tag，采用滚动更新，如需锁定版本建议固定到具体 commit
- 部分高级场景（如 GPU 驱动升级回归、Rollout Sequencing 多环境编排）涉及的底层机制较复杂，建议结合 Google Cloud 官方文档交叉核实后再落地