企业官网建设流程全解析

DevOps-Security-Agent-Skills是一个面向 AI Agent 的 DevOps、安全与合规技能库，内含 160+ 个生产级 SKILL.md 技能，覆盖 Kubernetes、Terraform、AWS/Azure/GCP、密钥管理等领域。本新手教程将演示如何用它让 Claude Code、Cursor、Codex 等 AI Agent 自动产出可直接上生产的配置，零踩坑。

它为什么能写出生产级配置？

市面上大多数"资源合集"只是链接列表，而本项目提供的是可执行的专家知识。每个技能目录都遵循统一结构（参见 CONTRIBUTING.md）：

skill/ ├── SKILL.md # 专家级知识：使用时机、真实配置、CLI 命令、故障排查 ├── scripts/ # 可直接运行的自动化脚本 ├── references/ # 深度参考文档 └── assets/ # 配置模板（YAML、HCL、tf 等）

Agent 的工作原理分三步：扫描技能目录 → 匹配用户问题 → 读取对应 SKILL.md 并按需执行脚本。也就是说，你只需提出需求，Agent 就会加载专家级上下文，输出带资源限制、健康探针、安全上下文的"能上生产"的配置，而不是一段玩具代码。

一键安装：30 秒给你的 Agent 装上技能

方式一：git clone（最简单）

git clone https://gitcode.com/gh_mirrors/de/DevOps-Security-Agent-Skills.git ~/.skills/devops-security

方式二：skills CLI（支持 Claude Code、Cursor、Codex 等）

# 安装指定技能到指定 Agent npx skills add bagelhole/DevOps-Security-Agent-Skills \ --skill kubernetes-ops --skill hashicorp-vault -a cursor -y

💡 本地克隆后，在仓库根目录执行npx skills add . --list即可查看全部可安装技能。

实战一：让 Agent 自动写出生产级 Kubernetes 配置

长尾关键词场景：如何生成带资源限制和健康探针的 K8s Deployment？

安装 devops/orchestration/kubernetes-ops/ 技能后，只需对 Agent 说："帮我部署一个带健康检查和资源限制的 Web 应用"。Agent 会基于 devops/orchestration/kubernetes-ops/SKILL.md 中的生产级模板输出配置，关键亮点包括：

• ✅requests/limits资源配额，防止 Pod 抢占集群资源
• ✅livenessProbe+readinessProbe双探针，故障自动重启
• ✅ 敏感信息通过secretKeyRef从 Secret 注入，而非硬编码

配套资料同样完整：

• 部署模板：devops/orchestration/kubernetes-ops/assets/deployment-template.yaml
• 集群健康检查脚本：devops/orchestration/kubernetes-ops/scripts/cluster-health-check.sh
• Pod 故障调试脚本：devops/orchestration/kubernetes-ops/scripts/pod-debug.sh
• 故障排查手册：devops/orchestration/kubernetes-ops/references/troubleshooting-guide.md
• 最佳实践：devops/orchestration/kubernetes-ops/references/best-practices.md

实战二：让 Agent 配置 HashiCorp Vault 密钥管理

长尾关键词场景：如何初始化 Vault、编写最小权限 Policy？

security/secrets/hashicorp-vault/SKILL.md 技能覆盖了从开发模式到生产的完整链路，Agent 可以自动完成：

1. 开发服务器启动：vault server -dev快速验证
2. 生产集群部署：Raft 存储 + TLS 监听，配置模板见 security/secrets/hashicorp-vault/assets/vault-config.hcl
3. 初始化与解封：vault operator init -key-shares=5 -key-threshold=3（5 份密钥、3 份解封）
4. KV v2 密钥管理：写入、读取、版本历史一应俱全
5. 动态数据库凭据：为 PostgreSQL 自动生成短期数据库账号

深入资料：

• 密钥引擎详解：security/secrets/hashicorp-vault/references/secrets-engines.md
• 策略编写指南：security/secrets/hashicorp-vault/references/vault-policies.md
• Kubernetes 认证配置：security/secrets/hashicorp-vault/assets/kubernetes-auth.yaml
• 备份脚本：security/secrets/hashicorp-vault/scripts/vault-backup.sh

实战三：让 Agent 编写 Terraform 基础设施代码

长尾关键词场景：如何生成带远程 state 锁定的 Terraform AWS 模块？

infrastructure/cloud-aws/terraform-aws/SKILL.md 技能教会 Agent 遵循 IaC 最佳实践，而不是随手写几个resource：

• S3 远程状态后端：backend "s3"+ 状态锁，团队协作不冲突
• Provider 版本锁定：version = "~> 5.0"，避免升级意外
• 模块化引用：直接引用成熟的terraform-aws-modules/vpc/aws模块构建 VPC
• 数据源查 AMI：data.aws_ami动态获取最新镜像，不写死 ID

配套文件：

• VPC 模块模板：infrastructure/cloud-aws/terraform-aws/assets/vpc-module.tf
• IaC 最佳实践：infrastructure/cloud-aws/terraform-aws/references/best-practices.md
• 初始化脚本：infrastructure/cloud-aws/terraform-aws/scripts/tf-init.sh

标准工作流 Agent 也会自动执行：terraform init→terraform plan -out=plan.tfplan→terraform apply plan.tfplan。

技能速查：新手最常用的 5 个技能目录

完整 160+ 技能目录见 README.md 的 Skill Catalog 章节。

常见问题（FAQ）

Q1：不装 Agent，纯人类能用吗？

可以。所有 SKILL.md、模板和脚本都是纯文本，直接浏览、复制、执行即可，MIT 协议免费使用。

Q2：Agent 加载全部 160+ 技能会消耗大量上下文吗？

不会。技能采用渐进式加载：启动时 Agent 只读取每个技能的 YAML frontmatter（约 100 token），匹配到任务后才加载完整 SKILL.md 和参考资料。

Q3：如何让 Agent 输出的配置更安全？

同时安装安全类技能，如 security/hardening/kubernetes-hardening/ 和 security/ai/ai-coding-agent-guardrails/，Agent 会在生成配置时叠加安全上下文、权限边界检查。

总结

DevOps-Security-Agent-Skills 的价值在于：它把资深 SRE 和安全的隐性经验，变成了 AI Agent 可以直接消费的结构化技能。三步上手：

1. git clone仓库到你的 Agent 技能目录
2. 用自然语言描述需求（如"生成一个生产级 K8s Deployment"）
3. Agent 自动加载对应 SKILL.md，输出带脚本、模板和排查手册的完整方案

从 Kubernetes 到 Vault 再到 Terraform，你的 Agent 从此具备了"生产级"的判断力。🚀