k8s-manifest-generator
生产级 Kubernetes 清单生成器:以分层参考文档与占位符模板引导 agent 按 10 步工作流生成 Deployment/Service/ConfigMap/Secret/PVC,内置资源限额、三类健康探针、非 root 安全上下文等云原生最佳实践。
仓库:wshobson/agents
热度证据:所属 marketplace 38.7k star,175 技能之一
五维评分
热度4/5
质量4/5
创新3/5
易用4/5
文档5/5
优秀点拆解
- 渐进式披露的分层文档架构:SKILL.md 摘要层→references/details.md 10步工作流层→字段级 spec 层→assets 模板层,每层标注何时下沉,兼顾上下文预算与内容完备性
- 把「生产就绪」固化为可勾选 checklist:SKILL.md 10 条最佳实践、deployment-spec 12 项 Production Checklist、details.md 7 项测试清单,质量门槛可逐条验证
- 占位符+内嵌理由的即拷即用模板:统一 <app-name> 等占位符标注替换点,关键行注释解释原因(maxUnavailable: 0 # Zero-downtime),可选能力以注释块保留
- 需求收集前置:工作流第一步是 8 项负载信息+7 个提问,先问后写避免对应用类型/存储/暴露方式做错误假设
- 验证闭环内建流程:第 10 步给出 kubectl dry-run、kubeval、kube-score、kube-linter 四级校验命令和验收清单
可复用的设计模式
- 分级参考文档+显式导航指令:主文档只放摘要,细节下沉 references/,每层注明何时读下一层
- 占位符模板+注释内嵌理由:模板即文档,对 agent 和人类开发者同时友好
- Checklist 固化质量门槛:把模糊最佳实践转成 [ ] 可勾选验收条目
- 生成类 skill 的「先问后写」需求收集前置步骤
适用场景
从零生成无状态 Web 应用/微服务的 Deployment+Service+ConfigMap 清单有状态数据库应用(StatefulSet+Headless Service+PVC)骨架K8s 新手团队的生产级清单教学与脚手架起步配合 kubectl/kubeval 做「AI 生成-工具校验」的清单生产流水线
边界与注意:纯文档型 skill,无脚本、不调用任何工具,校验命令需用户环境自备 kubectl 才能真正闭环;模板偏 AWS(LoadBalancer 注解);details.md 声称的 secret-template.yaml/pvc-template.yaml 实际未提交(to be generated),Secret 只有建议没有落地模板;内容锚定 Kubernetes 1.28。
完整拆解分析文档
本页为摘要版,完整精读分析(核心机制、逐条优秀点拆解、写作过程)见本地 Markdown 文档:
analysis/wshobson-k8s-manifest-generator.md