K8s清单生成入门

Kubernetes YAML清单生成工具，支持常用资源模板与基础校验。Use when 需要代码生成、编程辅助、调试测试、开发部署时使用。不适用于无明确技术栈的模糊需求。适用于独立开发者、企业团队和自动化工作流场景。支持中文交互，无需复杂配置即开即用。输出结果可直接使用，减少二次加工成本。提供结构化输出和错误处理机制。

功能说明: 本技能涵盖 中文交互、化工作流场景 等核心能力。

K8s清单生成入门（免费版）

概述

本工具为个人开发者提供K8s YAML清单生成能力。支持常用K8s资源的清单生成、模板化创建和基础校验，帮助开发者快速编写规范的K8s配置文件。

核心能力

清单生成功能

资源类型	生成	校验	模板
Deployment	支持	支持	Web应用/任务
Service	支持	支持	ClusterIP/NodePort
ConfigMap	支持	支持	配置文件
Secret	支持	支持	密码/证书
Ingress	支持	支持	基础路由
Job/CronJob	支持	支持	定时任务
PVC	支持	支持	存储卷
Namespace	支持	支持	命名空间
Helm Chart	不支持	不支持	-
Kustomize	不支持	不支持	-

输出: 返回清单生成功能的执行结果,包含操作状态和输出数据。

核心功能执行

用input_params参数进行配置。

输出: 返回核心功能执行的执行结果,包含操作状态和输出数据。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

参数配置与调用

用config_options参数进行配置。

输出: 返回参数配置与调用的执行结果,包含操作状态和输出数据。

• 执行此能力时使用config_options参数,支持修改/重置/导入操作 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：Kubernetes、YAML、清单生成工具、支持常用资源模板、与基础校验、面向个人开发者的、等常用资源的清单、生成与基础校验、Use、when、需要代码生成、编程辅助、调试测试、开发部署时使用、不适用于无明确技、术栈的模糊需求、适用于独立开发者、企业团队和自动化、工作流场景等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

使用场景

场景一：生成Deployment清单

用户输入："帮我生成一个Web应用的Deployment清单"

bash

# 生成Deployment清单
python3 scripts/generate.py deployment \
  --name web-app \
  --image nginx:1.25 \
  --replicas 3 \
  --port 80 \
  --output deployment.yaml

# 输出文件内容
cat deployment.yaml

场景二：生成完整应用栈

用户输入："生成Web+数据库的完整K8s清单"

bash

# 生成应用栈
  --template "web_db" \
  --app-name my-app \
  --app-image my-app:v1 \
  --db-image postgres:15 \
  --output-dir ./manifests/

# 输出：
# ./manifests/deployment.yaml
# ./manifests/service.yaml
# ./manifests/configmap.yaml
# ./manifests/secret.yaml
# ./manifests/pvc.yaml

场景三：校验清单

用户输入："检查我的YAML清单有没有问题"

bash

# 校验清单
  --file deployment.yaml \
  --dry-run

# 输出：
# [OK] 语法正确
# [OK] 必填字段完整
# 已知限制
# [建议] 添加livenessProbe

快速开始

1. 阅读## 核心能力章节了解skill功能
2. 按## 依赖说明配置环境
3. 执行所需能力对应的命令
4. 参考## 错误处理章节处理异常
5. 查看## FAQ解答常见疑问

环境准备

bash

# 依赖说明
pip install pyyaml jsonschema

# 生成清单
py deployment --name my-app --image nginx:1.25

常用命令

bash

# 生成单个资源
py deployment --name my-app --image my-image:v1 --replicas 3
py service --name my-service --port 80 --type ClusterIP
py configmap --name my-config --from-file ./config.yaml

# 生成应用栈
py stack --template "web_db" --app-name my-app

# 校验清单
py validate --file deployment.yaml --dry-run

# 查看模板列表

结果处理: 执行完成后,查看输出结果确认操作状态。成功时输出包含处理摘要和结果数据;失败时根据错误信息排查问题,查阅错误处理章节获取恢复步骤。

示例

生成模板配置

yaml

generate_config:
  defaults:
    api_version: "apps/v1"
    namespace: "default"
    replicas: 2
    image_pull_policy: "IfNotPresent"

  resources:
    requests:
      cpu: "100m"
      memory: "128Mi"
    limits:
      cpu: "500m"
      memory: "512Mi"

  templates:
    - name: "web_app"
      resources: ["deployment", "service", "configmap", "ingress"]
    - name: "web_db"
      resources: ["deployment", "service", "configmap", "secret", "pvc"]
    - name: "cron_job"
      resources: ["cronjob", "configmap"]

  validation:
    schema_check: true
    dry_run: true               # kubectl dry-run验证
    best_practices: true         # 优选实践检查

优选实践

1. 模板复用：将常用配置保存为模板，避免重复编写
2. 校验优先：生成后先校验再应用，避免配置错误
3. 版本控制：将清单文件纳入Git管理
4. 标签统一：使用统一的标签规范

实践要点	说明
资源限制	生成的清单包含resources默认值
健康检查	模板中预置探针配置
镜像版本	使用具体版本号，避免latest
命名规范	资源名使用小写和中划线

已知限制

• 本skill的能力范围受限于核心能力章节中定义的功能,不支持超出范围的操作
• 复杂业务场景建议结合人工经验判断
• 执行效率受模型能力与网络环境影响

常见问题

Q1：免费版支持Helm Chart吗？

免费版不包含Helm Chart生成。如需Helm支持，建议升级PRO版。

Q2：生成的清单可以直接apply吗？

可以。生成后通过 kubectl apply -f 直接应用。建议先用 --dry-run 校验。

Q3：支持Kustomize吗？

免费版不包含Kustomize支持。如需Kustomize覆盖层管理，建议升级PRO版。

Q4：模板可以自定义吗？

免费版提供预置模板，不支持自定义模板。如需自定义模板系统，建议升级PRO版。

依赖说明

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
• 操作系统: Windows / macOS / Linux
• Python版本: 3.8+
• kubectl: 可选（dry-run校验需要）

第三方依赖

依赖项	类型	是否必需	获取方式
LLM API	API	必需	由Agent内置LLM提供
Python	运行时	必需	系统安装或conda环境
PyYAML	Python库	必需	pip install pyyaml
jsonschema	Python库	可选	pip install jsonschema（校验）

API Key 配置

• 免费版无需API Key
• 纯本地生成与校验

可用性分类

• 分类: MD+EXEC（Markdown指令+Python脚本执行）
• 说明: K8s YAML清单生成与校验工具
• 免费版限制: 基础资源生成、不支持Helm/Kustomize与自定义模板

错误处理

错误场景	原因	处理方式
配置错误	参数缺失或格式错误	检查依赖说明中的配置要求
运行时错误	运行环境不满足	确认运行环境符合依赖说明
网络错误	连接超时或不可达	执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令，参考国内替代方案

安全注意事项

风险类型	防范措施
API密钥泄露	通过环境变量配置，禁止硬编码到代码或配置文件中
命令执行风险	仅执行白名单命令，避免拼接用户输入到命令行参数中
网络通信安全	使用HTTPS协议，验证SSL证书有效性
敏感数据暴露	输出结果中不包含密钥、令牌等敏感信息

使用前请确认已阅读依赖说明章节，确保运行环境满足安全要求。

核心功能

• 自动化执行: 基于指令驱动的自动化流程
• 文件处理: 支持多种文件格式的读取、解析和写入操作
• API集成: 通过标准化接口调用外部服务并处理响应
• 命令执行: 在安全沙箱中执行系统命令并收集结果
• 信息检索: 快速搜索和过滤目标数据

核心功能

• 自动化执行: 基于指令驱动的自动化流程
• 文件处理: 支持多种文件格式的读取、解析和写入操作
• API集成: 通过标准化接口调用外部服务并处理响应
• 命令执行: 在安全沙箱中执行系统命令并收集结果
• 信息检索: 快速搜索和过滤目标数据