mcpField
K
kubernetes

kubernetes

github.com/magnus919云与 DevOps15771 次安装1 天前更新
代码仓库

关于 kubernetes

用于 Kubernetes 运维的决策与路由技能，而非静态 kubectl 速查表。它引导集群发现、发行版专属操作、安全预览变更，并依据资源状态和服务边界验证结果。

主要功能

  1. 01集群与 API 发现指导
  2. 02云提供商和发行版路由
  3. 03变更预览与安全门控
  4. 04工作负载和网络参考
  5. 05有界诊断与健康检查
  6. 06运行手册和清单模板

适用场景

  1. 01识别集群上下文与发行版
  2. 02预览并规划工作负载变更
  3. 03排查 Pod 未进入 Service 端点
  4. 04在服务边界验证部署滚动更新

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/magnus919/agent-skills --skill kubernetes

安装后在 Claude Code 中输入/kubernetes确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

README.md
evals/
evals.json
references/
api-and-versioning.md
backup-restore.md
cli-reference.md
debugging.md
distributions.md
networking.md
nodes-and-reliability.md
observability.md
operations.md
policy.md
safety-gates.md
scheduling-scaling-storage.md
security-and-policy.md
source-index.md
troubleshooting.md
version-skew.md
workloads-and-rollouts.md
scripts/
gather-cluster-state.sh
k8s-cli
refresh-version-matrix.sh
test-k8s-cli.sh
verify-cluster-health.sh
templates/
cluster-inventory.json
deployment.yaml
diagnostic-report.md
hpa.yaml
networkpolicy-default-deny.yaml
pdb.yaml

详细介绍

Kubernetes

将此技能用作决策和路由层。不要把它当作静态的 kubectl 速查表。

操作约定

  1. 确认目标：发行版、提供商、集群版本、客户端版本、上下文、命名空间、访问模式，以及集群是否为生产环境。
  2. 先发现，再假设：查询已提供的 API 资源、API 版本、CRD、系统工作负载、节点和发行版标记。
  3. 区分可移植的 Kubernetes 行为与发行版／提供商覆盖层。使用生命周期、网络、身份、存储或升级说明前，先加载匹配的参考资料。
  4. 对于变更，先预览（k8s-cli ... --dry-run 或 kubectl diff／服务器端试运行），说明操作范围；破坏性操作必须获得明确确认；随后验证状态条件、事件、发布状态和外部边界。
  5. 优先使用稳定 API 和服务器端验证。将 Beta／Alpha API、功能门控、提供商默认值和版本号视为时效性信息。
  6. 控制证据的范围并采用结构化形式。切勿将 kubeconfig、Secret 值、令牌或无界日志倾倒到聊天中。

选择操作路径

情况首要操作不要这样做
实时集群操作运行 doctor、context 和 discover；记录上下文、命名空间、发行版和版本不要根据配置或先前的命令推断集群状态
无法访问集群提供范围明确的计划，并指出缺少的前置条件不要声称已完成诊断或操作成功，也不要编造命令输出
任何变更渲染配置，执行 diff／服务器端试运行，说明操作范围，获得所需确认，然后执行变更并验证相关边界不要将命令退出码为 0 视为操作成功
存在提供商或发行版应用可移植指南前，先加载匹配的覆盖层不要原样套用上游说明

首次响应时的发现

scripts/k8s-cli --json doctor
scripts/k8s-cli --json context
scripts/k8s-cli --json discover

如果无法使用包装器，请使用 references/cli-reference.md 中的等效原生命令。如果没有 kubectl，请停止并报告缺少该前置条件，不要编造集群状态。

路由

场景加载
API 发现、SSA、CRD 或弃用项references/api-and-versioning.md
工作负载、探针、发布、作业或控制器references/workloads-and-rollouts.md
调度、扩缩容、存储、节点中断或可靠性references/scheduling-scaling-storage.md 和 references/nodes-and-reliability.md
服务、DNS、NetworkPolicy、Ingress 或 Gateway APIreferences/networking.md
Pod 处于 Running 状态但未提供流量，或未出现在 Service 端点中references/workloads-and-rollouts.md、references/networking.md、references/troubleshooting.md 和匹配的发行版覆盖层
RBAC、Pod 安全、准入、审计、Secret 或策略引擎references/security-and-policy.md 和 references/policy.md
以证据为先的诊断或高级调试references/troubleshooting.md 和 references/debugging.md
备份、升级、高可用性或可观测性references/operations.md、references/backup-restore.md 和 references/observability.md
发行版／提供商覆盖层或版本矩阵references/distributions.md、references/version-skew.md 和 references/source-index.md
原生命令详情或输出约定references/cli-reference.md
变更安全关卡references/safety-gates.md

模板和脚本

  • templates/diagnostic-report.md：便于阅读的事件报告
  • templates/cluster-inventory.json：有界清单架构
  • templates/upgrade-runbook.md：升级前检查、变更和验证运行手册
  • scripts/k8s-cli：面向 Agent 的 kubectl 封装
  • scripts/test-k8s-cli.sh：使用模拟 kubectl 的确定性测试
  • scripts/gather-cluster-state.sh：为事件报告收集有界诊断信息
  • scripts/verify-cluster-health.sh：有界的操作后健康验证
  • scripts/refresh-version-matrix.sh：刷新带日期的版本观察结果，绝不静默修改指导内容

版本政策

研究基线核查日期为 2026-07-11。Kubernetes 项目页面列出了受维护的次要版本 1.36、1.35 和 1.34。这并非永久结论。在断言当前版本或支持状态之前，请刷新 references/distributions.md 和来源索引。

验证边界

声明最低证据要求
Pod 健康Pod 条件、就绪状态、事件，以及相关 EndpointSlice 或外部边界
Pod 正在提供流量就绪条件、Service 选择器、EndpointSlice 成员资格、事件，以及有界的 Service 级检查
部署成功控制器条件、生成的 Pod、事件，以及相关 Service 或外部检查
API/资源可用已提供的 API 发现信息、已安装的 CRD/控制器支持，以及服务端验证
命令在操作层面成功有界的命令结果，以及资源条件和用户可见边界

组件级命令结果只能证明该组件的情况；不要将其升级为集群或集成级结论。

严格边界

  • 绝不泄露 Secret 数据或原始 kubeconfig 凭据。
  • 未解释操作范围并获得所需确认之前，绝不使用 --force-conflicts、delete、drain、patch、upgrade 或集群重置流程。
  • 绝不能仅凭 Running 就称 Pod 为“健康”。
  • 绝不能仅凭组件级测试就称集成成功。
  • 未加载相应覆盖配置之前，绝不能将上游流程用于 k3s、RKE2、托管服务商、Talos 或 OpenShift。

评论

支持 Markdown