AI 技能AI 插件【免费下载链接】agentic-awesome-skillsAAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,400 agentic skills. Includes CLI, local MCP, catalog, plugins, and Workbench.项目地址https://gitcode.com/gh_mirrors/an/agentic-awesome-skills点击查看免费下载本篇指南以仓库 docs/vietnamese/CONTRIBUTING.vi.md 的贡献规范为主线系统讲解在 agentic-awesome-skillsAAS中创建、验证并提交一个全新 Agentic Skill 的完整流程。你将掌握 5 步 Quality Bar 质量门禁、SKILL.md 的 frontmatter 与正文结构规范、npm run validate/npm run validate:strict验证命令的底层检查逻辑以及符合仓库规范的 Git 提交方式从而让自己的技能可靠地进入这个拥有 2,400 技能的本地优先、面向 Agent 的技能目录。先理解仓库的贡献哲学agentic-awesome-skills 不是一个简单的脚本合集而是一个本地优先、Agent 优先的控制平面它提供完整的技能目录发现catalog discovery、由 Agent 自主选型、栈验证与规划能力见 package.json 中的aasCore与description。正因为技能会被 AI 助手直接读取、理解并触发执行仓库对技能质量与安全制定了严格的自动化标准。贡献指南开篇就强调每位贡献者哪怕是从未接触过开源的初学者在提交前都必须仔细阅读并满足 Quality Bar质量门槛。这意味着任何新技能都不是写个 Markdown 就行而是要经得起脚本校验、结构审查与安全扫描三重检查。Quality Bar每个技能必须通过的 5 步检查根据贡献指南每个新提交的技能必须通过以下 5 步质量检查详见 docs/vietnamese/QUALITY_BAR.vi.md 和英文详版 docs/contributors/quality-bar.md元数据MetadataSKILL.md的 frontmatter 必须准确包含name、description、category、risk、source、date_added对于源自外部 GitHub 仓库的技能还需追加source_repo与source_type。安全性Safety不得包含未标注风险级别Risk的有害命令。清晰性Clarity必须包含明确的何时使用When to Use触发条件。示例Examples至少包含一个可复制、可直接使用的示例。可执行动作Actions必须为 AI 定义具体的行动步骤而不是泛泛的想法。风险分级risk是安全门禁的核心Quality Bar 为风险标签定义了严格取值这与验证脚本tools/scripts/validate_skills.py中的valid_risk_levels [none, safe, critical, offensive, unknown]完全对应级别含义典型场景unknown遗留或未分类内容仅限旧技能新技能应避免除非确实需要维护者人工分类none纯文本/推理头脑风暴Brainstorming类safe读取文件、运行安全命令Linter 类工具critical修改状态、删除文件、推送生产环境Git Push、数据变更类offensive渗透测试 / 红队工具必须附带仅限授权使用Authorized Use Only警告有趣的是仓库中真实的 skills/brainstorming/SKILL.md 将自身标记为risk: critical因为它会改变行为模式阻止直接实现、强制走设计流程可见风险分级衡量的是指令对系统状态的影响程度而非字面意义上的危险程度。更严格的英文版 Quality Bar英文详版 docs/contributors/quality-bar.md 在 5 步之上补充了更多要求description需在 200 字符内risk: unknown仅允许遗留内容技能必须列出明确限制Limitations涉及命令示例、远程拉取、密钥或变更指导的 PR除常规验证外还必须通过npm run security:docs该扫描针对curl ... | bash、wget ... | sh这类命令管道、内联令牌示例等高风险模式。自动化检查是必要条件但不能替代人工评审对逻辑、安全与失败模式的判断。四种贡献方式总有一种适合你贡献指南明确指出你不必是专家。仓库欢迎任何程度的贡献者主要有四条路径改进文档最容易修正拼写与语法错误、把解释写得更清晰、为现有技能补充示例、将文档翻译为其他语言。这也是仓库维护大量多语言文档docs/vietnamese/、docs_zh-CN/等的原因。报告问题Issues发现难懂的地方、技能不工作、或有改进建议都可以反馈。创建新技能Skill将你的专业经验固化为技能填补现有技能集合当前包含 2,400 技能的空白或改进已有技能。测试与验证在不同 AI 工具上试用技能报告哪些可用、哪些不可用并提出改进建议。创建新技能的完整 5 步流程贡献指南给出了从想法到提交的标准流程每一步都配有可执行的命令。第 1 步选择技能主题先问自己我希望 AI 助手更擅长什么 例如我很懂 Docker就创建一个 Docker 技能。 主题应聚焦于一个明确的、Agent 可以触发执行的场景而不是一个大而全的领域。第 2 步创建目录结构所有技能位于仓库的skills/目录下目录名必须使用kebab-case小写连字符格式# 进入 skills 目录 cd skills/ # 为技能创建目录 mkdir my-awesome-skill cd my-awesome-skill # 创建核心文件 SKILL.md touch SKILL.md从仓库实际布局看skills/下每个目录就是一个技能例如 skills/brainstorming、skills/git-pushing而 docs/vietnamese/SKILL_ANATOMY.vi.md 进一步给出了可选的辅助目录examples/示例文件、scripts/辅助脚本、templates/代码模板、references/参考资料、README.md补充文档。核心规则是只有SKILL.md是必需的其余全部可选。第 3 步编写 SKILL.md 内容每个技能都需要下面的基础结构。直接复制以下模板--- name: my-awesome-skill description: Mô tả ngắn gọn về chức năng của skill này risk: safe source: community date_added: 2026-06-25 --- # Tiêu đề Skill ## Tổng quan Giải thích skill này làm gì và khi nào nên sử dụng nó. ## Khi nào nên sử dụng Skill này - Sử dụng khi [tình huống 1] - Sử dụng khi [tình huống 2] ## Cách hoạt động Hướng dẫn chi tiết từng bước cho AI... ## Ví dụ ### Ví dụ 1code ví dụ ở đây## Thực hành tốt nhất - ✅ Nên làm điều này - ❌ Không nên làm điều này注上述模板为越南语原文中文贡献者可参考 docs/SKILL_TEMPLATE.md 或 docs/vietnamese/SKILL_ANATOMY.vi.md 的完整结构说明。frontmatter 字段详解验证脚本 tools/scripts/validate_skills.py 对 frontmatter 的检查逻辑非常明确写作时需严格遵守name必须为 kebab-case且必须与文件夹名完全一致。脚本中metadata[name] ! os.path.basename(root)时直接报错。description一句话说明功能与价值。脚本检查其必须为字符串、不能为空、不能仅为空白且不能超过 300 字符详版 Quality Bar 建议 200 字符内。risk取值none / safe / critical / offensive / unknown非法取值直接报错缺省时普通模式给警告、严格模式升级为错误。source来源归属community、self或源 URL缺省会有警告。date_addedYYYY-MM-DD格式如2026-06-25脚本用正则^\d{4}-\d{2}-\d{2}$校验。source_repo/source_type当技能源自外部 GitHub 仓库时必填。source_repo必须符合OWNER/REPO格式正则^[A-Za-z0-9_.-]/[A-Za-z0-9_.-]$source_type必须为official、community或self之一。正文核心When to Use 触发条件技能正文必须包含明确的触发条件小节。验证脚本内置了四个可接受的标题模式见WHEN_TO_USE_PATTERNS## When to Use## Use this skill when## When to Use This Skill## When to activate this skill好的触发条件示例当用户要求调试 React 组件时使用糟糕的示例这个技能帮助你处理代码。正因为 AI 依靠这一节决定何时激活技能它是决定技能可用性的关键。真实技能 skills/brainstorming/SKILL.md 展示了高质量的正文结构Overview → Operating Mode → 分步 Process → Exit Criteria → When to Use → Example → Limitations既给 AI 明确的分步动作也声明了边界。第 4 步本地验证提交前必做贡献指南强调未通过验证的 Pull Request 将不被接受。验证有两种模式# 普通模式 npm run validate # 严格模式CI 实际运行的模式 npm run validate:strict从 package.json 可以看到这两个命令的底层实现npm run validate→node tools/scripts/run-python.js tools/scripts/validate_skills.pynpm run validate:strict→ 追加--strict参数验证脚本会检查✅SKILL.md文件是否存在脚本遍历skills/目录统计含SKILL.md的技能数量并跳过符号链接✅ frontmatter 是否为合法 YAML使用 PyYAML 解析会报告具体语法错误✅ name 是否与文件夹名匹配✅risk是否在合法取值内offensive技能是否包含精确的仅限授权使用免责声明文本与每次操作前强制确认门禁security_disclaimer_pattern与offensive_confirmation_pattern逐字匹配✅ 是否包含 When to Use 小节✅ 正文中的相对链接是否悬空脚本解析text检查目标文件是否本地存在普通模式下警告不阻断但严格模式CI任何警告都会升级为失败。提交前还建议运行维护者级审计与安全扫描npm run audit:skills # 仓库级合规/可用性报告截断描述、缺示例、警告集中度等 npm run validate:references # 引用完整性检查 npm run security:docs # 高风险内容安全扫描命令管道、内联密钥等 npm test # 运行测试套件注意validate:strict是有效的加固手段但仓库仍存在未满足严格验证的遗留技能因此 CI 门禁与人工评审是最终裁决依据。第 5 步提交与推送验证通过后按以下流程提交git add skills/my-awesome-skill/ git commit -m feat: add my-awesome-skill git push origin my-branch提交信息需遵循仓库的语义化前缀规范见下节。涉及SKILL.md的 PR 还会触发 GitHub Actions 的自动化skill-review检查该检查被视为常规质量门禁的一部分应在合并前处理其可操作建议若无法获得自动化评审额度工作流会如实记录manual-review-required等待维护者对精确提交的人工背书而不会假装评审已通过。一键式技能模板Copy Paste 即用贡献指南提供了一份可直接复制的完整模板涵盖从 frontmatter 到故障排查的全部推荐小节--- name: your-skill-name description: Mô tả trong một câu về chức năng của skill và khi nào cần dùng risk: safe source: community date_added: 2026-06-25 --- # Tên Kỹ năng của bạn ## Tổng quan [2-3 câu giải thích skill này làm gì] ## Khi nào nên sử dụng Skill này - Sử dụng khi bạn cần [tình huống 1] - Sử dụng khi bạn muốn [tình huống 2] ## Hướng dẫn Từng bước ### 1. [Tên Bước đầu tiên] [Hướng dẫn chi tiết] ## Ví dụ ### Ví dụ 1: [Tên Trường hợp sử dụng] language // Code ví dụ ở đâyThực hành tốt nhất✅Nên:[Thực hành tốt]❌Không nên:[Điều cần tránh]Xử lý Sự cốVấn đề:[Lỗi thường gặp]Giải pháp:[Cách khắc phục]关于技能规模[docs/vietnamese/SKILL_ANATOMY.vi.md](https://link.gitcode.com/i/03b60a919d8c75c4f9a9f453ccff8e10) 给出了参考最小可用技能frontmatter 100–200 字 总览与指南、标准技能300–800 字含 When to Use、指南、示例、综合技能800–2000 字含全部推荐小节与 scripts/examples/templates。原则是**从小的开始基于反馈迭代扩展**。 ## Commit Message 规范 贡献指南要求使用以下语义化前缀 - feat: — 新技能或重大功能 - docs: — 文档改进 - fix: — 缺陷修复 - refactor: — 不改变功能的重构 - test: — 新增或更新测试 - chore: — 维护类任务 示例feat: add kubernetes-deployment skill docs: improve getting started guide fix: correct typo in stripe-integration skill## 安全与行为准则贡献的底线 贡献指南末尾明确了两条红线 1. **行为准则Code of Conduct**始终尊重与包容、欢迎新人、聚焦建设性反馈。仓库的安全护栏政策详见 [docs/vietnamese/SECURITY_GUARDRAILS.vi.md](https://link.gitcode.com/i/8c2694487a3eaeb9796f26a299176643)。 2. **禁止有害内容**攻击类技能必须附带精确的仅限授权使用Authorized Use Only免责声明并要求 Agent 在执行任何利用命令前征求用户确认同时建议在 Docker/VM 等隔离环境中运行防御类技能默认只读、不得未经同意将数据上传到第三方服务器。 这些要求并非纸面规定——如第 4 步所述验证脚本会对 offensive 技能进行**逐字匹配**的免责声明与确认门禁检查缺少任何一处都会直接产生 级错误并阻断提交。 ## 快速自查清单 提交 PR 前对照贡献指南完成最终自检 - [ ] SKILL.md 已创建于 skills/kebab-case-name/ 目录下 - [ ] frontmatter 为合法 YAMLname 与文件夹名一致 - [ ] description 简洁清晰≤200 字符risk 取值合法并如实标注 - [ ] 源自外部 GitHub 仓库时已补 source_repoOWNER/REPO 格式与 source_type - [ ] 正文包含 When to Use 触发小节 - [ ] 至少一个可复制使用的示例 - [ ] 列出了已知限制Limitations - [ ] npm run validate 通过命令型/风险型内容额外通过 npm run security:docs - [ ] Commit message 使用语义化前缀 完成以上步骤你的技能就达到了与仓库中 2,400 既有技能相同的质量标准。每一次贡献——哪怕只是修正一个拼写错误、改进一个句子或创建一个全新的技能——都在帮助成千上万的开发者与 AI 助手更高效地协作。赞分享AI 技能AI 插件【免费下载链接】agentic-awesome-skillsAAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,400 agentic skills. Includes CLI, local MCP, catalog, plugins, and Workbench.项目地址https://gitcode.com/gh_mirrors/an/agentic-awesome-skills点击查看免费下载相关推荐Agentic Awesome Skills 质量标准指南从技能提交到 Validated 徽章的完整验证流程Agentic Awesome Skills 质量标准指南从技能提交到 Validated 徽章的完整验证流程 本篇指南聚焦 Agentic AwesomeAI 技能AI 插件ESLint 贡献指南从创建分支到合并提交一个高质量 Pull Request 的完整流程ESLint 贡献指南从创建分支到合并提交一个高质量 Pull Request 的完整流程 ESLint 是一个基于 AST 的 JavaScript 模式开发工具Lint静态分析代码质量Agentic Awesome Skills 合并 PR 的受保护工作流merge:batch 与贡献者信用保障完整指南Agentic Awesome Skills 合并 PR 的受保护工作流merge:batch 与贡献者信用保障完整指南 导读 本文面向 agentic aAI 技能AI 插件创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考