用途:在插件市场仓库中发布插件新版本,包括升级版本号、创建 git 标签和发布 GitHub Release。
主要能力与关键区分:metadata.version 与插件版本是不同概念。plugins[].version 跟踪单个插件版本,每次插件发布都要更新;metadata.version 跟踪市场目录结构,仅在新增或移除插件时更新。常见错误是认为 metadata.version 应与插件版本保持同步,实际不应如此。
版本更新位置(发布插件时需全部更新 4 处):plugins/<name>/.claude-plugin/plugin.json 的 version;.claude-plugin/marketplace.json 中 plugins[].version;插件 README.md 的 Version 部分;根目录 README.md 的 Available Plugins 表格。
发布命令:git add -A;git commit -m "Release swift v1.3.0 ...";git tag v1.3.0;git push && git push origin v1.3.0;gh release create v1.3.0 --title "v1.3.0" --notes "..."。
标签格式:使用 v1.3.0,而非 swift-v1.3.0。可用 git tag --sort=-v:refname | head -5 查看现有标签。
不应更新 metadata.version 的情况:发布插件新版本、修复插件缺陷、为现有插件添加功能、更新插件文档。应更新 metadata.version 的情况:向目录新增插件、从目录移除插件、更改市场所有者或名称。
限制:资料未提供该技能的具体安装方式、依赖环境、适用平台及收费信息。