如何给Wondel.ai Agent Skills贡献技能技能开发、语义化版本与发布规范完整教程【免费下载链接】skillsWondel.ai Agent Skills — Business, Marketing, UX Coding Frameworks from Bestselling Books. 50 skills 12 guided journeys for Claude Code, Codex, Cursor other agentskills.io agents.项目地址: https://gitcode.com/gh_mirrors/skills25/skillsWondel.ai Agent Skills 是一个收录 62 个 Agent 技能Skills的开源框架库涵盖产品策略、UX 设计、营销、销售与系统架构等领域可在 Claude Code、Codex、Cursor 等智能体中使用。本文是一份面向新手贡献者的完整教程带你走通技能开发 → SKILL.md 编写 → 语义化版本升级 → 同步与发布的全流程。 先看懂仓库结构技能是怎么组织的每个技能就是一个文件夹包含主文件SKILL.md和可选的参考资料目录。核心结构如下引自 CLAUDE.md路径说明{skill-name}/SKILL.md技能主文件YAML frontmatter Markdown 指令{skill-name}/references/*.md支撑参考文件可选每篇 1500–3000 词.claude-plugin/marketplace.json插件市场清单集合与版本的唯一事实来源scripts/同步脚本IDE 镜像、Codex 插件、版本号.claude/ .cursor/ .windsurf/ .pi/ .agents/⚠️ 生成的符号链接镜像切勿手工编辑克隆仓库后即可开始贡献仓库只读镜像地址git clone https://gitcode.com/gh_mirrors/skills25/skills️ 技能开发SKILL.md 编写规范1. YAML frontmatter 必填与推荐字段每个技能的SKILL.md头部必须包含 YAML 元数据以 clean-code/SKILL.md 为例name: clean-code description: Write readable, maintainable code... Use when the user mentions clean up this code... license: MIT metadata: author: wondelai version: 1.4.0字段规范清单name唯一标识符小写字母 连字符最长 64 字符description技能做什么、何时触发最长 1024 字符。这是技能被发现的关键要用编号使用场景(1) ..., (2) ..., (3) ...并包含触发短语license统一使用MITmetadata.version语义化版本号详见下一节⚠️ YAML 单引号字符串里的单引号要用两个转义这是新手最常踩的坑。2. 正文结构模板一个书籍型技能推荐采用统一章节顺序# 技能标题 简介段落## Core Principle— 加粗的核心原则## Scoring— 0–10 的可复现评分规则与 Quick Diagnostic 对应各###框架章节包含Core concept / Key insights / 应用表格 / Ethical boundary## Common Mistakes— 三列表格错误 | 为何失败 | 修复方式## Quick Diagnostic— 表格问题 | 若为否 | 行动## Further Reading与## About the Author需要细节时用行内指针引用资料例如See [references/naming-conventions.md](https://link.gitcode.com/i/c29b4b50a749bbd377c949bee90e9a46) when 场景 — 补充内容。3. 参考资料references/规范每个.md文件1500–3000 词聚焦单一主题在正文中按需引用不要在文末堆一长串目录式罗列4. 元技能Metaskills是另一套格式12 个引导式旅程如 create-business/SKILL.md是编排器而非书籍技能章节顺序为Intro → Core Principle → Journey Map → Operating Rules → Intake → Phases每阶段含 Purpose/Brief/Invoke/Decide/Artifact/Done when 六要素→ Optional Phases → Common Mistakes → Completing the Journey。其产物骨架规范见 docs/ARTIFACT-REGISTRY.md各元技能的 references/artifact-templates.md 必须与之一致。️ 语义化版本版本号升级规则技能采用MAJOR.MINOR.PATCH语义化版本级别触发条件示例MAJOR破坏性变更或完全重写1.4.0 → 2.0.0MINOR新增内容、显著增强、新章节1.0.0 → 1.1.0PATCHBug 修复、错别字、小澄清1.1.0 → 1.1.1自动升级铁律只要你修改了某个技能的SKILL.md或references/文件就必须 bump 该技能 frontmatter 中的版本号——新增/增强升 MINOR小修升 PATCH。忘记这一步是最常见的贡献者失误。 发布规范从清单到自动同步单一事实来源marketplace.json新增技能时只需在 .claude-plugin/marketplace.json 对应集合的skills数组中加入./skill-name条目。不要手工指定版本——版本由 CI 自动同步。同步 IDE 镜像与 Codex 插件完成技能文件后运行scripts/sync-ide-skills.sh它会自动重新生成.claude/ .cursor/ .windsurf/ .pi/ .agents/skills/的符号链接镜像通过 scripts/generate-codex-plugins.sh 再生成plugins/下的 Codex 插件清单以 Claude 市场为唯一来源这些生成目录永远不要手工编辑。发布即同步版本号发布流程bump 受影响技能的版本 → 合并 → 发布vX.Y.ZRelease。.github/workflows/sync-marketplace-version.yml 会在每次 Release 时运行 scripts/sync-marketplace-versions.sh把marketplace.json顶层与所有插件集合的版本统一为X.Y.Z并自动提交回 main。本地也可手动执行scripts/sync-marketplace-versions.sh 1.6.0预览效果。✅ 完整贡献流程清单7 步新建文件夹{skill-name}/小写连字符命名编写SKILL.mdfrontmatter 含name、description、license、metadata.version添加references/参考资料每篇 1500–3000 词更新 README.mdskills.sh 安装列表、Available Skills 表格、Skill Details 章节简介/作者/适用场景/示例提示词、版权说明在 marketplace.json 对应集合中加入./skill-name不写版本运行scripts/sync-ide-skills.sh再生成 IDE 镜像与 Codex 插件提交到 main本项目直接提交 main发布vX.Y.ZRelease 触发版本同步⚠️ 常见错误速查错误后果修复改内容不 bump 版本市场版本失真按 MINOR/PATCH 规则升级单引号未转义frontmatter 解析失败YAML 内双写单引号手工编辑.claude/等镜像下次 sync 时被覆盖只改源目录跑脚本生成手写 marketplace 版本与 CI 同步冲突只加路径条目交给 Release 流程按这份清单操作你的第一个 Wondel.ai Agent Skills 技能就能规范地走完开发、版本与发布全流程。【免费下载链接】skillsWondel.ai Agent Skills — Business, Marketing, UX Coding Frameworks from Bestselling Books. 50 skills 12 guided journeys for Claude Code, Codex, Cursor other agentskills.io agents.项目地址: https://gitcode.com/gh_mirrors/skills25/skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考