资讯动态

DevOps-Security-Agent-Skills 完整开发者指南:5步编写你的SKILL.md(附模板、命名规范与PR流程)

发布时间:2026/10/15 18:37:01 来源:尧图企业网站定制
【免费下载链接】DevOps-Security-Agent-SkillsAgent-ready DevOps, security, infrastructure, and compliance knowledge base with 80 skills across Kubernetes, Terraform, AWS/Azure/GCP, AI platform operations, container hardening, SOC2/ISO27001, and incident response—plus ready-to-run scripts, templates, and playbooks for SRE, platform, and security teams.项目地址https://gitcode.com/gh_mirrors/de/DevOps-Security-Agent-Skills点击查看免费下载DevOps-Security-Agent-Skills 是一个面向 AI Agent 的 DevOps、安全与合规知识库收录了 80 个技能而每个技能的核心就是一个 SKILL.md 文件。本文将从零讲清如何编写 SKILL.md包含完整模板、命名规范与 PR 提交流程助你向这个项目贡献自己的第一个技能。 为什么要编写 SKILL.mdAgent Skills 是一种扩展 AI Agent 的开放格式。每个技能本质上是一个文件夹工作流程分为三步DISCOVERAgent 启动时扫描所有技能目录MATCH根据 SKILL.md 前置元数据frontmatter中的name和description匹配用户提问ACTIVATE命中后加载完整 SKILL.md并按需执行 scripts/ 中的脚本所以写一份高质量的 SKILL.md就是给 Claude Code、Cursor、Codex 等 Agent 装上能直接执行的专业知识。想快速建立标准印象可以阅读 devops/orchestration/kubernetes-ops/SKILL.md它完整展示了When to Use、Prerequisites、配置示例、Common Issues、Best Practices、Related Skills这些章节。第 1 步理解技能的目录结构每个技能是一个独立目录最少只需一个 SKILL.mdskill-name/ ├── SKILL.md # 必需说明 元数据 ├── scripts/ # 可选可执行脚本 ├── references/ # 可选详细文档 └── assets/ # 可选模板、配置各可选目录的使用时机目录什么时候加scripts/技能受益于自动化校验脚本、初始化助手references/详细技术文档放这里避免撑大 SKILL.mdassets/模板、配置文件、示例资源例如 security/hardening/linux-hardening/ 技能把加固配置模板放在 assets/ 下如 ssh-hardening.confCIS 检查清单放在 references/ 下。第 2 步填写 SKILL.md 模板 官方模板原文见 CONTRIBUTING.md。SKILL.md 由两部分组成YAML Frontmatter元数据头部--- name: skill-name description: 说明这个技能做什么、什么时候使用。要包含能帮助 Agent 识别任务的具体关键词。 license: MIT metadata: author: your-username version: 1.0 ---其中description 是 Agent 匹配的关键字段三条写作要点长度 1~1024 字符既要说明做什么也要说明何时用包含具体的匹配关键词对比感受一下差别❌ 差Helps with Docker.✅ 好Deploy and manage Docker containers including building images, optimizing Dockerfiles, managing volumes, and troubleshooting container issues. Use when working with Docker, containers, or containerization.正文标准章节章节作用# 技能标题一句话简介## When to Use This Skill列出触发条件与关键词## Prerequisites工具、权限、环境要求## Instructions分任务、分步骤的指令 命令示例## Common IssuesProblem → Solution 成对出现## Best Practices最佳实践清单## Related Skills用相对路径链接相关技能写作时记得解释为什么而不只是怎么做示例命令提交前必须亲自测试过命令加注释关键处附上预期输出。第 3 步遵循技能命名规范 ⚠️这是最容易被打回的环节共 5 条硬性规则只允许小写字母、数字、连字符最长64 个字符不能以连字符开头或结尾不能出现连续连字符目录名必须与 frontmatter 中的name字段完全一致✅ 好例子github-actions、terraform-aws、linux-hardening❌ 坏例子GitHub-Actions大写、-github-actions开头连字符、github--actions连续连字符文件命名也有约定Markdown 文档小写 连字符如pipeline-syntax.md脚本文件小写 下划线如cluster-health-check.sh第 4 步选对领域目录放置技能项目按领域组织新技能要放进正确的领域和分类下领域目录分类示例适合的技能devops/ci-cd、containers、orchestration、observability、releaseCI/CD、K8s、监控告警security/scanning、secrets、hardening、network、operations、ai漏洞扫描、密钥管理、加固infrastructure/cloud-aws、cloud-azure、cloud-gcp、servers、databases、networking、storage云服务、服务器、数据库、存储compliance/frameworks、governance、auditing、continuitySOC2、ISO27001、审计日志不确定放哪里时先浏览 README.md 的技能目录找到主题最接近的已有技能放进同一分类即可。第 5 步PR 前的清单与提交流程 提交前 5 项自查校验技能在本地运行skills-ref validate ./path/to/your-skill测试指令确保每条命令都能按文档执行成功检查重复确认仓库中不存在类似技能风格一致对照现有技能如 security/scanning/vulnerability-scanning/SKILL.md核对风格控制篇幅主 SKILL.md 保持在500 行以内超出部分移到 references/渐进式披露原则为高效利用 Agent 的上下文技能内容应分层组织Frontmatter约 100 tokens只有 name 和 description主指令5000 tokensSKILL.md 核心内容References按需加载详细文档放在独立文件中PR 提交流程# 1. 在平台 Fork 项目后克隆你的 fork git clone https://gitcode.com/gh_mirrors/de/DevOps-Security-Agent-Skills # 2. 新建分支 → 添加技能 → 提交 Pull RequestPR 描述建议包含清晰描述性的标题、关联 issue、技能做什么及为何有价值、你做过哪些测试。维护者会从 5 个维度评审Accuracy准确、Clarity清晰、Completeness完整、Consistency一致、Value价值。对贡献有疑问或想提新技能想法直接开一个 Issue 讨论即可。 总结要点一句话记忆目录结构一个技能 一个目录SKILL.md 必需scripts/references/assets 可选description 字段决定 Agent 能否找到你的技能写清做什么 何时用 关键词命名全小写连字符目录名 name 字段篇幅主文件 500 行以内细节放 references/提交先本地校验和实测PR 附测试说明按这 5 步走你的第一个技能就能顺利合入。参考 CONTRIBUTING.md 中的完整规范开始你的贡献之旅吧赞分享【免费下载链接】DevOps-Security-Agent-SkillsAgent-ready DevOps, security, infrastructure, and compliance knowledge base with 80 skills across Kubernetes, Terraform, AWS/Azure/GCP, AI platform operations, container hardening, SOC2/ISO27001, and incident response—plus ready-to-run scripts, templates, and playbooks for SRE, platform, and security teams.项目地址https://gitcode.com/gh_mirrors/de/DevOps-Security-Agent-Skills点击查看免费下载相关推荐如何编写自己的 Agent SkillHugging Face Skills 的 SKILL.md 规范与开发实战如何编写自己的 Agent SkillHugging Face Skills 的 SKILL.md 规范与开发实战 核心关键词Agent Skill、SKI人工智能AI 技能/插件大模型AI 评测Next.js 仓库 Agent Skills 编写指南SKILL.md 规范、描述匹配与 AGENTS.md 的分工Next.js 仓库 Agent Skills 编写指南SKILL.md 规范、描述匹配与 AGENTS.md 的分工 本文以 Next.js 仓库内的 au前端后端Web框架SSR前端构建为 Anthropic-Cybersecurity-Skills 贡献 AI Agent 网络安全技能SKILL.md 编写规范与提交流程实战指南为 Anthropic Cybersecurity Skills 贡献 AI Agent 网络安全技能SKILL.md 编写规范与提交流程实战指南 本文以 C网络安全AI 技能/插件渗透测试红蓝对抗创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

读完文章,也想定制专属网站?

尧图设计师 24 小时内与您沟通定制方案

免费获取报价 →
↑