1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | k8s-manifest-generator-wshobson-agents |
| 作者/维护者 | Seth Hobson（wshobson，个人维护） |
| 来源链接 | https://github.com/wshobson/agents/tree/main/plugins/kubernetes-operations/skills/k8s-manifest-generator |
| 许可证 | MIT（GitHub API 获取） |
| GitHub Stars / Forks | 38,361 / 4,104（GitHub API 获取；为 wshobson/agents 整个插件市场仓库的数字，仓库含 175 个技能，不代表本技能个体热度） |
| 最新版本 | 无独立版本号，持续滚动更新；本技能最近一次实质性提交为 2026-05-22（将详细内容拆分至 references/details.md 的三层结构重构） |
| 安装方式 | Claude Code 插件市场 / Codex CLI / OpenCode 等多宿主安装（见第 10 章） |
2. 功能介绍与亮点
k8s-manifest-generator 提供从零生成生产级 Kubernetes 核心资源 manifest 的完整指导，覆盖 Deployment、Service、ConfigMap、Secret、PersistentVolumeClaim 五类资源，并给出资源请求/限制、健康检查、安全上下文、标签规范等最佳实践清单。
主要亮点：
- 端到端覆盖：不止步于生成 YAML，还附带常见故障排查命令（
kubectl describe pod、kubectl get events等）以及“下一步”指引（Git 版本管理、CI/CD 接入、Helm/Kustomize 模板化、GitOps、监控可观测性）。 - 可直接复制的模板资产：
assets/目录内置 configmap-template.yaml、deployment-template.yaml、service-template.yaml 三份可直接使用的 YAML 模板。 - 分层深度参考文档：
references/目录含 deployment-spec.md、service-spec.md、details.md 三份详细文档，SKILL.md 正文作为导航层，按需指向具体细节，避免一次性加载过多上下文。
3. 适用场景
固定分类：DevOps 与基础设施。适用于刚开始为应用编写生产级 Kubernetes YAML 的开发者与 SRE，尤其是容易漏配资源限制、健康检查、安全上下文等最佳实践细节的初中级用户；也适用于需要一套合规起始模板、再自行按业务调整的团队。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——仓库以
.claude-plugin插件市场形式分发，README 将 Claude Code 列为一级宿主。 - Codex：✅ 原生支持——README「Quick start」章节明确列出通过
npx codex-marketplace add wshobson/agents原生安装。 - OpenClaw：❓ 未验证——README 与文档未提及该生态。
- Hermes Agent：❓ 未验证——同上。
（仓库同一份 Markdown 源另原生支持 Cursor、OpenCode、Gemini CLI、GitHub Copilot。）
5. 推荐理由
比起分散在各类通用文档里的 K8s 最佳实践碎片，这份技能把 Deployment/Service/ConfigMap/Secret/PVC 五类核心资源的生产级写法、常见故障排查命令与后续演进路径（Helm、GitOps、监控）整合进同一套导航式文档，配合可直接套用的 YAML 模板，能显著降低从零编写规范 K8s manifest 的试错成本；作为 wshobson/agents 多宿主插件市场的一部分，同一内容可原生用于 Claude Code 与 Codex 等多个 agent 生态。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 6 | 本技能子目录自身缺乏独立于仓库整体之外的第三方讨论证据（未发现该子目录专属的已合并外部 PR 或 issue），仅见聚合技能目录站的自动收录列表，不构成独立评价 |
| 可用性 | 9 | SKILL.md 采用“导航—指南—深度参考”三层结构，2026-05-22 完成重构（新增 references/details.md 462 行深度内容），另有 deployment-spec.md、service-spec.md 及 3 份 YAML 模板资产，全部引用路径均实际存在、无死链；一条插件安装命令即可用 |
| 安全性 | 9 | 全部内容为 Markdown 文档与声明式 YAML 模板，无可执行脚本、无运行时联网、无需任何 API Key 或凭据 |
综合评分：8.0（三项均值）
安全检查清单逐项结果：①无 shell 命令执行（纯文档 + 声明式 YAML 模板）②无运行时联网外发③不要求任何 API Key/凭据④通读 SKILL.md 及三份 references 文档未发现可疑指令或 prompt injection 迹象⑤作者 Seth Hobson 为该仓库长期维护者，同仓库另一技能 github-actions-templates 此前已通过评估⑥License 明确（MIT）⑦本技能子目录最近一次实质性提交 2026-05-22，距今约 2 个月。
7. 跟同类 Skills 相比的优势
| 竞品 | 定位 | 与本技能的差异 |
|---|---|---|
| kubernetes-skill（LukasNiessen/kubernetes-skill） | 失效模式优先诊断工作流：先按不安全默认值、资源饥饿、网络暴露、权限扩散等六大常见反模式诊断已有配置，26 个按需加载的分主题参考文件覆盖 EKS/GKE/AKS/OpenShift/k3s 多平台差异 | kubernetes-skill 面向“诊断并修复已有配置问题、适配多云平台差异”，本技能面向“从零生成一套遵循最佳实践的核心资源起始模板”，两者可先后配合使用 |
| helm-chart-scaffolding（同仓库兄弟技能） | 面向 Helm Chart 的模板化封装与打包，产出 Chart.yaml/values.yaml 脚手架及校验脚本 | helm-chart-scaffolding 产出可参数化复用的 Helm Chart 包，本技能产出的是不经模板引擎的原始 K8s YAML，分别适用于未上 Helm 与已用 Helm 管理配置两个阶段 |
8. 用户评价
该技能目前在第三方平台尚无针对自身的具名用户评价。所属仓库 wshobson/agents 在 Hacker News 上有独立用户讨论，但内容聚焦仓库整体的多智能体协作能力，未点名本技能。
9. 其他补充
本技能隶属 wshobson/agents「Agentic Plugin Marketplace」（94 个插件、175 个技能），同一份 Markdown 源同时生成 Claude Code、Codex、Cursor、OpenCode、Gemini CLI 与 Copilot 六种宿主的原生产物。所在 kubernetes-operations 插件还包含 helm-chart-scaffolding、gitops-workflow、k8s-security-policies 三个兄弟技能，可按需单独触发使用。
10. 安装使用方式
Claude Code：
/plugin marketplace add wshobson/agents
/plugin install kubernetes-operationsCodex CLI：
npx codex-marketplace add wshobson/agents安装后在插件目录中选择 kubernetes-operations 插件。
手动方式：将仓库 plugins/kubernetes-operations/skills/k8s-manifest-generator/ 目录复制到所用 agent 的 skills 路径下即可，无需重启，符合“生成 Kubernetes manifest”“创建 K8s 资源”等触发条件时会被自动加载调用。
11. 注意事项
- 本技能只生成裸 K8s YAML，不含 Helm/Kustomize 模板引擎能力，若团队已采用 Helm 管理配置，应改用同插件的 helm-chart-scaffolding。
- 安装单元是 kubernetes-operations 整个插件（含 4 个技能），无法只安装单一技能，首次加载会一并引入其余三个兄弟技能。
- 内容覆盖的是通用 K8s 资源模式，不含云厂商专属注解（如 EKS IRSA、GKE Workload Identity），涉及云厂商特定配置需自行补充。