发布你自己的Claude Code插件agent-toolkit plugin-forge分步实战指南【免费下载链接】agent-toolkitA curated collection of skills for AI coding agents. Skills are packaged instructions and scripts that extend agent capabilities across development, documentation, planning, and professional workflows.项目地址: https://gitcode.com/gh_mirrors/agentt/agent-toolkitagent-toolkit 是一个面向 AI 编码代理的技能Skills合集其中内置的plugin-forge技能提供了一条完整链路从一键生成 Claude Code 插件目录骨架、plugin.json/marketplace.json双清单管理到语义化版本升级与团队分发全部自动化脚本加参考文档开箱即用。本文带你分步走通这条链路5 步发布属于你自己的 Claude Code 插件。一、准备工作3 个前提条件与工具获取 ️plugin-forge 的自动脚本基于 Python 编写开始之前请确认 3 个前提Python 3.10运行脚手架与版本脚本一个已存在的插件市场即包含.claude-plugin/marketplace.json的目录Claude Code用于本地测试与安装插件获取 plugin-forge 最简单的方式是把 agent-toolkit 仓库克隆到本地git clone https://gitcode.com/gh_mirrors/agentt/agent-toolkitplugin-forge 的全部资产位于 skills/plugin-forge/ 目录核心文件一览文件作用SKILL.md技能主文档完整工作流与规范README.md用户文档用法示例与最佳实践create_plugin.py一键生成插件骨架与双清单bump_version.py双清单同步升级版本号workflows.md开发、测试、发布分步工作流二、快速理解 Claude Code 插件结构双清单机制 动手前先记住一个核心事实每个插件有两份清单版本号必须同时出现在两处。plugin-name/ ├── .claude-plugin/ │ └── plugin.json # 插件自身元数据清单必须 ├── commands/ # 自定义斜杠命令 ├── agents/ # 代理定义 ├── skills/ # Agent Skills └── README.md # 插件文档推荐plugin.json只有name是必填字段通常还会写上version、description、author、keywords{ name: my-plugin, version: 0.1.0, description: 一句话介绍插件用途, author: { name: 你的名字, email: youexample.com }, keywords: [关键词1, 关键词2] }另一份是市场级的.claude-plugin/marketplace.json它维护plugins数组每条记录声明插件的name与source相对路径或远程仓库。本仓库根目录的 marketplace.json 就是一个现成样例——它把整个技能库都按一个技能一个插件的方式收录了进去可以打开对照阅读。 完整字段说明plugin-structure.md、marketplace-schema.md三、第一步用 create_plugin.py 一键生成插件骨架 ⚡运行脚手架脚本即可自动生成插件目录、plugin.json清单、README 模板并把插件条目写入marketplace.jsonpython skills/plugin-forge/scripts/create_plugin.py my-first-plugin \ --marketplace-root /path/to/your-marketplace \ --author-name 你的名字 \ --author-email youexample.com \ --description 我的第一个 Claude Code 插件 \ --keywords demo,productivity \ --category productivity执行成功后会看到三类产物✅ 插件目录plugins/my-first-plugin/含.claude-plugin/plugin.json、commands/、skills/✅ 预填好安装命令的 README 模板✅marketplace.json中新增插件条目初始版本0.1.0⚠️ 脚本不会覆盖已存在的同名插件目录重名时会直接报错退出。四、第二步为插件添加命令、技能与代理组件 骨架生成后只需往对应目录放文件。各类组件的位置与格式组件位置格式斜杠命令commands/Markdown frontmatter技能 Skillskills/名称/SKILL.md目录 SKILL.md代理 Agentagents/Markdown 定义钩子 Hookhooks/hooks.json事件处理器MCP 服务.mcp.json外部集成配置命令命名小技巧子目录会自动变成命名空间。commands/docs/generate.md暴露为/docs:generatecommands/prime/vue.md暴露为/prime:vue。一个最简单的命令文件长这样--- description: 为当前项目生成文档 --- # Generate Docs 这里写命令要执行的具体指令……五、第三步本地测试插件安装步骤 在 Claude Code 中依次执行两条命令完成首次安装/plugin marketplace add /path/to/your-marketplace /plugin install my-first-pluginyour-marketplace之后每次修改插件都走一遍卸载 → 重装/plugin uninstall my-first-pluginyour-marketplace /plugin install my-first-pluginyour-marketplace⚠️最容易踩的缓存坑Claude Code 会缓存插件文件。重装后如仍未生效请完全重启 Claude Code再用/plugin list确认插件在列。六、第四步语义化版本管理最快方法 版本必须同步更新在两份清单里手工改极易漏掉一处。直接用 bump_version.py 一条命令搞定python skills/plugin-forge/scripts/bump_version.py my-first-plugin minor \ --marketplace-root /path/to/your-marketplace脚本会自动读plugin.json中的当前版本、按规则计算新版本并同时写回plugin.json与marketplace.json。语义化版本三档规则类型含义示例major破坏性变更1.0.0 → 2.0.0minor新功能、重构1.0.0 → 1.1.0patch修 Bug、改文档1.0.0 → 1.0.1七、第五步发布插件与团队分发流程 本地验证通过后提交并推送即可发布git add . git commit -m feat: add my-first-plugin git push origin main用户侧只需两条命令就能装上你的 Claude Code 插件/plugin marketplace add owner/your-marketplace /plugin install my-first-pluginyour-marketplace团队分发技巧在项目的.claude/settings.json中配置extraKnownMarketplaces指向你的市场仓库成员克隆项目后市场自动可用无需手动 add。配置格式见 marketplace-schema.md 的 Team Distribution 一节完整发布清单见 workflows.md。八、常见问题排查清单 症状原因与解法Plugin directory already exists同名插件已存在删掉目录重建或手工修改现有插件bump 时 not found in marketplace manifest插件名需与marketplace.json中完全一致区分大小写且条目必须存在重装后改动不生效插件文件被缓存完全重启 Claude Code/plugin list验证提示找不到 marketplace.json脚本运行目录不对用--marketplace-root显式指定市场根目录九、总结5 步走通 Claude Code 插件发布 ✅准备Python 3.10、一个含marketplace.json的市场目录、Claude Code生成create_plugin.py一键产出骨架与双清单填充往commands/、skills/、agents/添加组件测试/plugin install本地安装改完记得重启清缓存发布bump_version.py升版 → 提交推送 → 用户两条命令安装plugin-forge 把最容易出错的目录结构、清单同步、版本一致性都固化成了脚本与文档照着 SKILL.md 一步步走就能避开大部分坑。现在去发布你的第一个 Claude Code 插件吧 【免费下载链接】agent-toolkitA curated collection of skills for AI coding agents. Skills are packaged instructions and scripts that extend agent capabilities across development, documentation, planning, and professional workflows.项目地址: https://gitcode.com/gh_mirrors/agentt/agent-toolkit创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考