用 32 个 Agent Skill 管理 KubeSphere 集群

KubeSphere 是面向 Kubernetes 多云、数据中心和边缘管理的开源容器平台——它 17k 星的仓库里还藏着主 README 只字未提的东西：一个 skills/ 目录，收录 32 个 SKILL.md skill（截至 2026-10-16），能把 coding agent 变成 KubeSphere 操作员。只读集群查询、DevOps 流水线操作、WizTelemetry 可观测性工作流，都可以在对话里驱动。

为什么这个 Skill 重要

主 README 对这些只字未提——skill 仅以文件夹形式存放在 skills/ 下，每个文件夹一份 SKILL.md，frontmatter 写明使用时机，部分还带有明确的范围外清单。这种结构让整个合集异常诚实：kubesphere-cluster-management 把自己限定为只读查询，并警告绝不通过 kubectl 增删改资源——管理操作仍然归属控制台。

三十二个 skill 大致分成几组：六个 DevOps skill（overview、Jenkins、Argo CD、流水线、租户级操作、凭据）服务 CI/CD；一套 WizTelemetry 可观测性 skill——日志、事件、审计、通知、追踪、告警规则、基于 Vector 的数据管道，以及为整组提供 APIServer 后端的 whizard-telemetry 平台服务；平台运维类如 kubeeye（基于 OPA、PromQL 等规则类型的集群巡检）、openpitrix（Helm/YAML 应用商店）、volcano（批量训练任务与队列）、openkruise（CloneSet 与 SidecarSet 发布）、servicemesh（Istio、Kiali、Jaeger）；以及一对互相引用的网关 skill——kubesphere-gateway 走 ingress-nginx 路线，kubesphere-gateway-api 走更新一代基于 Traefik 的 Kubernetes Gateway API。目录里还有九个本文未展开的 skill——kubesphere-core、kubesphere-extension-management、kubesphere-fluid、kubesphere-network-extension-operations、nodegroup、opensearch，以及三个 frontend-forge skill；完整清单以目录本身为准。

安装

仓库没有成文的安装命令，所以安装遵循 SKILL.md 的通用约定：克隆仓库，把需要的 skill 拷进 agent 的 skills 目录。以集群查询 skill 为例：

git clone https://github.com/kubesphere/kubesphere
cp -r kubesphere/skills/kubesphere-cluster-management ~/.claude/skills/

按角色挑选，不必全量拷 32 个——平台工程师要 DevOps 组，SRE 要 WizTelemetry 组。驱动集群的 skill 需要把 kubectl 指向一个 KubeSphere 托管的集群。

实战：一次只读的多集群巡检

1. 按上文安装 cluster-management skill，并确认 kubectl 上下文。
2. 提出报告请求：

用 kubesphere-cluster-management 列出所有托管集群的名称、连接类型、
KubeSphere 版本、Kubernetes 版本和 Ready 状态，整理成一张汇总表。
只做查询，不要执行任何写操作。

3. skill 用 kubectl get cluster 配合格式化模板执行——正是 SKILL.md 自带的命令，输出名称、连接类型、KS 版本、K8s 版本以及 Ready/KSCoreReady 状态。
4. 同一会话里继续：multi-tenant-management skill 可以创建用户、workspace、项目和角色绑定——同时按它自己的范围拒绝删除操作和自定义角色。

要定期体检，把同一套配置指向 kubeeye：它的 SKILL.md 覆盖部署 KubeEye、创建 InspectRule 与 InspectPlan 资源、取回巡检报告。

技巧

• 依赖某个 skill 之前先通读它的 SKILL.md——多个 skill 写有明确的范围外清单，边界是成文的，不用你猜。
• 两个网关 skill 互相引用是有原因的：要更新一代的 Kubernetes Gateway API 标准选 kubesphere-gateway-api，要 ingress-nginx 选 kubesphere-gateway。
• 目录内容会漂移——拷贝时对照 skills/ 目录清点，别依赖本文的数字。
• DevOps 组的 skill 同时记录了 KubeSphere API 操作和 kubectl 路径，没有 cluster-admin 权限的租户用户也有成文的路线可走。

何时不用这个 Skill

这些 skill 刻意把以写入为主的管理操作交还给 KubeSphere 控制台——如果你的工作以创建和删除资源为主，控制台界面才是设计意图中的工具。它们也是 KubeSphere 专属的：不带 KubeSphere 的原生 Kubernetes 集群无法响应这些查询。而且仓库没有提供安装命令或市场入口，这个合集比一键插件需要更多准备——对平台团队值得，浅尝辄止则未必。

查看 排行榜 了解更多 skill。