插件清单构建器

生成插件清单，并看清它周围需要的目录结构。

清单在浏览器里生成。你插件里的任何内容都不会被发送到别处。

给插件加上钩子

关于 插件清单构建器

插件把你已经写好的东西——命令、子智能体、技能、钩子——收进一个别人可以安装的文件夹。清单本身很小，也没什么争议，正因如此它里面的错误才格外恼人：一个不成其为版本的版本、一个带大写字母的名称、一个缺协议头的网址。它们都不妨碍文件是合法 JSON，也都会在之后添麻烦。这个构建器把字段填好，检查那些有规则的项，并展示清单周围应有的结构——因为清单本身什么都不做，真正被加载的是它旁边的那些文件夹。

功能特性

• 按命名规则检查名称
• 按语义化版本检查版本，含预发布版
• 作者名与邮箱按嵌套结构输出，而非摊平
• 检查主页是否带协议头
• 空字段直接省略，而不是写成空白
• 在清单旁展示目录结构
• 关键词逐行输入
• 下载为 plugin.json

如何使用 插件清单构建器

1. 给插件命名，并给一个起始版本
2. 写清它收纳了什么
3. 如果要分享，补上作者、主页和许可证
4. 把 plugin.json 下载到 .claude-plugin 文件夹

示例

输入

"version": "1.0"

输出

Error: not a semantic version — use major.minor.patch

两段式的版本号是最常见的退回原因。

常见错误与故障排除

• 版本被拒绝。 — 语义化版本有三段：是 1.0.0，不是 1.0。像 1.0.0-beta.1 这样的预发布后缀没问题。
• 装好后找不到插件。 — 清单要放在插件文件夹内的 .claude-plugin/plugin.json，而不是它的根目录。输出下方的结构图标明了各项的位置。
• 名称被拒绝。 — 小写字母、数字和单个连字符。它被当作标识符使用，所以大写字母和空格都不行。
• 清单合法，却什么都没加载。 — 清单只是描述插件。命令、智能体、技能和钩子是从旁边的文件夹加载的——一个空插件即便清单完美，也什么都不做。

常见问题

插件里能放什么？

斜杠命令、子智能体定义、技能和钩子的任意组合，各自放在清单旁的专属文件夹里。它们全都是可选的：只带一个有用命令的插件，也是完全站得住的插件。

哪些字段是真正必需的？

实际上是名称。其余是让别人能用起来的元数据：一段描述让人知道这是什么，一个版本让人看出何时变过，一个主页让人找到源码。

版本该怎么定？

还在变动时从 0.1.0 开始，并把第一位数字当作你对兼容性的承诺。改掉一个命令名或删掉一个技能，对使用者来说就是破坏性变更。

需要许可证字段吗？

只有分享时需要。而如果要分享，写明白能省掉一场对话：没有许可证的仓库，即便明显是给人复用的，在法律上也让人别扭。

能用手头已有的东西做插件吗？

通常就是这么开始的。已经能用的命令和技能原样挪进相应文件夹即可，唯一新增的文件就是清单。

相关工具

• 斜杠命令构建器 — 构建自定义命令，带参数与工具白名单。
• 子代理构建器 — 生成子代理定义文件，含工具与模型设置。
• 技能构建器 — 编写 SKILL.md，边输入边检查 frontmatter。
• 钩子构建器 — 构建 settings.json 钩子，找出永远不会触发的匹配式。
• MCP 服务器配置 — 为 stdio、HTTP 或 SSE 生成 MCP 服务器条目。
• 项目说明构建器 — 写一份对得起每次请求开销的 CLAUDE.md。

更多AI 与智能体工具

• 技能构建器 — 编写 SKILL.md，边输入边检查 frontmatter。
• 技能检查器 — 粘贴 SKILL.md，看清是什么让它无法与任务匹配。
• 子代理构建器 — 生成子代理定义文件，含工具与模型设置。
• 斜杠命令构建器 — 构建自定义命令，带参数与工具白名单。
• 项目说明构建器 — 写一份对得起每次请求开销的 CLAUDE.md。
• 钩子构建器 — 构建 settings.json 钩子，找出永远不会触发的匹配式。
• 权限规则测试器 — 用真实命令测试允许、询问与拒绝规则。
• MCP 服务器配置 — 为 stdio、HTTP 或 SSE 生成 MCP 服务器条目。
• MCP 工具模式构建器 — 定义工具并得到 JSON Schema，严格模式一并校验。
• 工具模式校验器 — 粘贴工具定义，查清它为何被拒绝或被错误调用。
• 提示模板填充 — 把一条提示展开到整张表格，并看清缺了哪些值。
• 系统提示检查器 — 找出自相矛盾、无效指令与未替换的占位符。
• 提示差异比较 — 逐词比较两个提示版本，并给出 token 差额。
• 少样本示例构建器 — 把输入输出对转成带标签、JSON 或对话格式的示例。
• XML 提示分节构建器 — 用内容无法越出的标签包裹提示的各个部分。
• JSONL 查看与校验 — 逐行读取、筛选并检查 JSONL 文件。
• 对话记录转换 — 把消息数组转成可读记录，也能转回去。
• 微调数据集校验 — 检查 chat 格式 JSONL，找出会中断训练的错误。
• SSE 流查看器 — 粘贴原始流式响应，取回正文、工具调用与用量。
• 上下文窗口规划 — 在提示、工具、历史与回复之间分配上下文窗口。
• 提示缓存规划 — 重排请求的各块，让可缓存前缀尽可能长。
• 文本切分 — 把文档切成有重叠的片段，只在真正的边界处断开。
• 代理循环成本估算 — 逐轮估算成本，计入重发的历史与缓存。
• 批量请求构建器 — 把表格转成批量任务，每条请求都有唯一 id。

查看全部AI 与智能体工具 · 全部工具