一份技能、五个IDEWondel.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是一套面向 Claude Code、Codex、Cursor 等 AI 智能体的技能库包含 62 个来自畅销商业与编程书籍的专家框架。它的工程亮点在于一份 SKILL.md 源码同步到五个 IDE 目录并自动生成 Claude 与 Codex 双端插件市场。本文带你拆解这套「单一数据源 符号链接 脚本生成」的跨平台同步机制即使你不是工程师也能看懂它的设计思路。 想动手验证可以克隆仓库git clone https://gitcode.com/gh_mirrors/skills25/skills为什么需要跨平台同步AI 智能体生态有一个事实标准SKILL.md技能文件。一个技能就是一个目录内含SKILL.md定义名称、描述、触发条件和references/参考文档例如 lean-startup/SKILL.md。问题来了不同 IDE 读取技能的路径不同——IDE / 工具技能目录Claude Code.claude/skills/Cursor.cursor/skills/Windsurf.windsurf/skills/Pi.pi/skills/通用 agents 目录.agents/skills/如果手动把 62 个技能复制 5 份改一处忘三处是必然的噩梦。本项目的答案是技能本体只存一份其余位置全部用符号链接symlink指回去。一键同步五个 IDE 的脚本原理核心脚本是 scripts/sync-ide-skills.sh逻辑只有三步发现技能扫描仓库根目录凡含有SKILL.md的目录即为一个技能重建链接清空并重建.claude/skills/、.cursor/skills/、.windsurf/skills/、.pi/skills/、.agents/skills/五个目录为每个技能创建形如../../lean-startup的相对符号链接自检用find -type l ! -exec test -e检测所有链接是否可正常解析任何「断链」都会让脚本以失败退出。# 发现技能顶层目录中含 SKILL.md 即视为技能 for dir in */; do dir${dir%/} [[ -f $dir/SKILL.md ]] skills($dir) done由于是纯相对链接仓库可以整体拷贝到任何路径下使用无需重新配置。脚本末尾还会自动调用插件生成脚本见下文保证「技能集合变化 → 插件市场跟着变化」。 你可以在 CLAUDE.md 和 .cursorrules 中看到维护规范修改技能必须更新SKILL.md的语义化版本号——这条纪律正是后续「版本同步自动化」的前提。插件市场一个 JSON 当「唯一事实源」Claude Code 用户通过插件市场安装技能合集collections。市场的「唯一事实源」是 .claude-plugin/marketplace.json{ name: wondelai-skills, metadata: { version: 1.5.1 }, plugins: [ { name: product-strategy, version: 1.5.1, skills: [./jobs-to-be-done, ./negotiation, ./mom-test] } ] }它定义了 10 个合集产品战略、UX 设计、营销转化、销售影响、代码手艺、系统架构等每个合集是若干技能的打包供/plugin install 合集名wondelai-skills一条命令安装。Codex 市场如何自动「镜像」出来Codex 有自己的插件标准但项目从不手写 Codex 配置——scripts/generate-codex-plugins.sh 完全由jq从 Claude 市场文件生成三类产物生成产物作用plugins/合集/.codex-plugin/plugin.json每个合集一个 Codex 插件清单名称、版本、描述、关键词全部复用 Claude 侧元数据plugins/合集/skills/技能符号链接 → 仓库根目录的技能本体.agents/plugins/marketplace.jsonCodex 插件市场清单克隆仓库后 Codex 自动发现脚本的注释写得很直白Fully generated and idempotent: safe to re-run完全生成、幂等、可安全重跑。生成后还有三重校验JSON 合法性、所有plugin.json合法、零断链。.claude-plugin/marketplace.json ← 唯一事实源手写 │ ├─→ Claude Code 插件市场原生支持 │ └─→ generate-codex-plugins.sh ├─→ plugins/合集/.codex-plugin/plugin.json ├─→ plugins/合集/skills/符号链接 └─→ .agents/plugins/marketplace.json版本同步发布即自动对齐第三个脚本 scripts/sync-marketplace-versions.sh 解决「发新版后用户装到的还是旧技能」的问题它把marketplace.json里metadata.version和所有合集的version统一改成发布版本号默认取最近的 git tag完成后自动触发 Codex 市场重新生成保证两端版本一致该脚本由 CI 工作流 .github/workflows/sync-marketplace-version.yml 在每次 release 发布时自动执行必要时也会提交回 main 分支。⚙️ 于是形成完整的自动化闭环改技能 → 更新SKILL.md版本号人工纪律新增/删除技能 → 跑sync-ide-skills.sh五个 IDE 目录 Codex 市场全部重建发布 release → 工作流跑sync-marketplace-versions.sh双端市场版本号自动对齐。设计启示普通用户能学到什么单一事实源所有配置只在一处手写marketplace.json其余全部生成杜绝「改了 A 忘了 B」符号链接代替复制62 个技能 × 5 个 IDE 310 个链接但磁盘上只有 62 份内容幂等 自检脚本可无限重跑且自带断链检测与 JSON 校验失败即大声报错自动化兜底人负责纪律版本号机器负责一致CI 同步。这套机制让 62 个技能、12 条元技能旅程guided journeys能以完全相同的体验同时服务五个 IDE 生态。想深入了解每条旅程如何跨会话保存状态可继续阅读 docs/ARTIFACT-REGISTRY.md 与各技能目录如 create-business/下的references/artifact-templates.md。【免费下载链接】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），仅供参考