1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | gke-networking-google-skills |
| 作者/维护者 | Google（google/skills 官方仓库） |
| 来源链接 | https://github.com/google/skills/tree/main/skills/cloud/gke-networking |
| 许可证 | Apache-2.0（GitHub API 获取，适用于整个仓库） |
| GitHub Stars | 19,037（GitHub API 获取；该数字属整个 google/skills 合集仓库，不代表本技能自身热度） |
| Forks | 1,538（GitHub API 获取，同为合集整体数据） |
| 最新版本 | 无独立版本号；技能目录最近一次提交于 2026-07-23（GitHub API 获取） |
| 安装方式 | npx skills add google/skills 后勾选 “GKE Networking”，或手动复制 skills/cloud/gke-networking 目录 |
2. 功能介绍与亮点
这是一个专注于 GKE（Google Kubernetes Engine）集群网络层规划与配置的技能，覆盖私有集群、VPC 原生模式、DNS、节点出网与 IP 地址规划。核心能力包括：
- 黄金路径默认配置表：以表格形式给出私有节点、私有控制面端点、Dataplane V2（基于 eBPF 的网络插件）、Cloud DNS 等九项默认设置，逐项注明是首次建集群（Day-0）还是后续调整（Day-1）生效，并说明设置理由。
- 私有集群访问三种路径：DNS 端点访问（默认、无需 VPN）、私有端点访问（VPC 内或专线）、授权网络（按 CIDR 白名单），各配对应
gcloud命令，覆盖自带 VPC 场景的完整建集群命令。 - IP 地址规划速查表：Pod CIDR、Service CIDR、节点子网的推荐范围与换算规则（
maxPodsPerNode=48对应每节点/25，110对应/24），并标注“VPC、子网、IP 范围建集群后不可更改”这类一次性决策的风险点。 - 明确的职责边界：正文写明应用层入口、负载均衡、Service 网络不在本技能范围内，指向配套的
gke-service-networking技能；网络策略的默认拒绝规则与按团队放行规则分别指向gke-workload-security、gke-multitenancy，避免功能重叠。
3. 适用场景
所属分类：DevOps 与基础设施
适用于为 GKE 集群做网络架构设计与私有集群配置的平台工程师、云架构师：从零开始规划集群该用多大的 Pod/Service IP 段、要不要接入现有 VPC、如何在保证私有节点无公网 IP 的前提下仍然可控地对外访问，均可依据本技能给出的黄金路径默认值与具体命令直接执行，无需自行翻阅分散的 GKE 网络文档。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 ✅ | SKILL.md 遵循 Agent Skills 规范（YAML frontmatter + 纯 Markdown 正文） |
| Codex | 原生支持 ✅ | Codex CLI 读取同一 SKILL.md 目录结构，google/skills 官方安装文档明确列出该目标 |
| OpenClaw | 原生支持 ✅ | 采用相同的 AgentSkills SKILL.md 规范，结构可直接迁移 |
| Hermes Agent | 原生支持 ✅ | 遵循 agentskills.io 开放标准，跨兼容框架可移植 |
⚠️ 正文列出的 MCP 工具（get_cluster、update_cluster 等）为可选加速路径，正文命令均以 gcloud 命令行形式给出，未接入对应 MCP 时技能仍可通过命令行独立完整工作。
5. 推荐理由
GKE 网络配置项多且大量决策“建集群后不可更改”（VPC、子网、IP 范围），一旦规划失误只能重建集群。本技能把这些一次性决策压缩成一张黄金路径默认值表 + 对应 gcloud 命令，并把 IP 段大小换算规则、私有集群三种访问方式都提前摆在使用者面前，帮助在建集群前就把网络架构想清楚，而不是上线后再排查连通性问题。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 发布方 Google 是 GKE 产品与技术的所有者；google/skills 属合集仓库，19,037 星属整个仓库，不计入单个子技能，未查到该子技能自身独立于合集之外的第三方讨论 |
| 可用性 | 9 | 单文件 SKILL.md 即可用，黄金路径表格 + 可直接执行的 gcloud 命令覆盖典型场景，2026-07-23 有更新、维护活跃，无付费依赖（仅需已有的 GCP 项目） |
| 安全性 | 9 | 纯配置指导，无外发数据；给出的 gcloud 命令权限范围与网络配置目的一致，仅作用于用户自己的 GCP 项目，开源可审计；见下方检查清单 |
综合评分：8.33
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令执行范围 | 仅 gcloud container clusters 相关命令，权限范围与网络配置目的一致 |
| ② 运行时联网外发 | 无向第三方服务器外发数据，仅与用户自己的 GCP 项目交互 |
| ③ API Key/凭据 | 不要求硬编码密钥，依赖标准 gcloud 身份认证 |
| ④ 可疑指令 | 通读全文未发现夹带无关推广或索取凭据的指令 |
| ⑤ 作者信誉 | Google 官方仓库，GKE 产品团队维护，无造假迹象 |
| ⑥ License | Apache-2.0，明确开源 |
| ⑦ 最近维护 | 2026-07-23 有更新，维护活跃 |
7. 跟同类 Skills 相比的优势
| 技能 | 覆盖范围 | 特点 |
|---|---|---|
| gke-networking-google-skills（本技能） | GKE 集群网络层（私有集群、VPC、IP 规划） | 聚焦建集群前必须一次性定好的网络决策，附 IP 段换算规则 |
| gke-service-networking-google-skills | 应用层入口、负载均衡、Service 网络 | 覆盖集群建好之后的流量路由，与本技能分工互补、不重叠 |
| gke-basics-google-skills | 集群整体创建与模式选择 | 涵盖 Autopilot/Standard 选型与凭据获取，网络细节留给本技能深挖 |
| azure-kubernetes-microsoft-azure-skills | AKS（Azure Kubernetes Service）网络与运维 | 面向 Azure 生态，网络模型（如 CNI 插件选择）与 GKE 的 VPC 原生模式不同，不可直接迁移 |
GKE 网络配置的特殊之处在于 VPC、子网、IP 范围一旦建集群就无法更改，本技能把这类不可逆决策提前列成清单，与覆盖集群建好之后流量管理的 gke-service-networking-google-skills 及负责整体建集群流程的 gke-basics-google-skills 形成互补，不构成重复收录。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。
9. 安装使用方式
- 通用安装：
npx skills add google/skills，交互式勾选 “GKE Networking” 后自动写入当前 agent 的技能目录。 - 手动安装：直接复制仓库中的
skills/cloud/gke-networking/SKILL.md文件到所用 agent 的技能目录下。 - 使用前提：需已开通 Google Cloud 项目并完成
gcloud auth login；若使用 MCP 加速路径，需额外配置对应的 GKE MCP 工具。 - 触发方式：向 agent 提出“帮我规划 GKE 集群网络”或“配置私有 GKE 集群”类请求即可触发，无需重启 agent。
10. 注意事项
- 正文强调 VPC、子网、IP 范围在建集群后不可更改，使用前务必按业务预期规模核对 Pod/Service CIDR 是否够用，避免上线后被迫重建集群。
- MCP 工具路径依赖用户自行配置对应的 GKE MCP 服务器，未配置时可直接使用文中提供的
gcloud命令行。 - 应用层入口、负载均衡、Service 网络配置不在本技能范围内，需配合同仓库的
gke-service-networking技能使用。