技能介绍

解决什么问题

kubectl apply 失败的常见原因之一，是清单本身不符合 Kubernetes 的预期结构：字段写错、版本与 apiVersion 不匹配、误删了必填字段。这类错误往往要到 apply 那一刻才暴露，此时变更已经进入集群，回滚和排障都要额外成本。理想的做法是在把清单提交到集群之前，先做一次静态校验。但传统的 kubectl --dry-run=client 对客户端验证支持有限，--dry-run=server 则需要真实的集群凭据和连接。

它如何工作

这个技能把校验环节前移到 apply 之前，基于 kubeconform 按上游版本化 schema 验证清单，不依赖任何实时集群：

多形态输入：既支持原始清单文件，也能审查渲染后的 Helm 输出或 PR diff，覆盖从本地编写到 CI 校验的不同阶段。
结构化反馈：校验结果返回无效资源、缺失 schema 以及严格模式（strict mode）下的失败项，定位到具体资源而非笼统报错。
零凭据依赖：整个校验过程不需要连接集群，适合在 CI 流水线或本地 pre-commit 场景中运行。

典型流程是：拿到清单输入 → 由 kubeconform 按对应 Kubernetes 版本的上游 schema 逐资源校验 → 汇总输出失败明细，供 Agent 或开发者直接修正。

适用边界

前置条件：需要 Kubernetes 清单文件，以及环境中已安装 kubeconform 二进制；技能本身不负责安装该工具。
不覆盖的验证：schema 校验只保证结构合规，不会检查资源之间的业务约束（如命名冲突、配额逻辑、控制器行为），这类问题仍需集群侧验证。
安装说明缺失：SKILL.md 中没有自动提取到经过验证的安装与使用步骤。在敏感或生产工作流中引入前，建议先审阅上游仓库（https://github.com/1991513ccie-png/skills）的实际实现。