企业官网建设流程全解析

发布你自己的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-toolkit

agent-toolkit 是一个面向 AI 编码代理的技能（Skills）合集，其中内置的plugin-forge技能提供了一条完整链路：从一键生成 Claude Code 插件目录骨架、plugin.json/marketplace.json双清单管理，到语义化版本升级与团队分发，全部自动化脚本加参考文档开箱即用。本文带你分步走通这条链路，5 步发布属于你自己的 Claude Code 插件。

一、准备工作：3 个前提条件与工具获取 🛠️

plugin-forge 的自动脚本基于 Python 编写，开始之前请确认 3 个前提：

1. Python 3.10+（运行脚手架与版本脚本）
2. 一个已存在的插件市场（即包含.claude-plugin/marketplace.json的目录）
3. Claude Code（用于本地测试与安装插件）

获取 plugin-forge 最简单的方式是把 agent-toolkit 仓库克隆到本地：

git clone https://gitcode.com/gh_mirrors/agentt/agent-toolkit

plugin-forge 的全部资产位于 skills/plugin-forge/ 目录，核心文件一览：

二、快速理解 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": "you@example.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.json：

python skills/plugin-forge/scripts/create_plugin.py my-first-plugin \ --marketplace-root /path/to/your-marketplace \ --author-name "你的名字" \ --author-email "you@example.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/docs/generate.md暴露为/docs:generate，commands/prime/vue.md暴露为/prime:vue。一个最简单的命令文件长这样：

--- description: 为当前项目生成文档 --- # Generate Docs 这里写命令要执行的具体指令……

五、第三步：本地测试插件安装步骤 🧪

在 Claude Code 中依次执行两条命令完成首次安装：

/plugin marketplace add /path/to/your-marketplace /plugin install my-first-plugin@your-marketplace

之后每次修改插件，都走一遍"卸载 → 重装"：

/plugin uninstall my-first-plugin@your-marketplace /plugin install my-first-plugin@your-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。语义化版本三档规则：

七、第五步：发布插件与团队分发流程 🚀

本地验证通过后，提交并推送即可发布：

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-plugin@your-marketplace

团队分发技巧：在项目的.claude/settings.json中配置extraKnownMarketplaces指向你的市场仓库，成员克隆项目后市场自动可用，无需手动 add。配置格式见 marketplace-schema.md 的 Team Distribution 一节，完整发布清单见 workflows.md。

八、常见问题排查清单 🩺

九、总结：5 步走通 Claude Code 插件发布 ✅

1. 准备：Python 3.10+、一个含marketplace.json的市场目录、Claude Code
2. 生成：create_plugin.py一键产出骨架与双清单
3. 填充：往commands/、skills/、agents/添加组件
4. 测试：/plugin install本地安装，改完记得重启清缓存
5. 发布：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