用途：这是 MAG Claude Plugins 市场的插件发布流程指南，用于把插件新版本正确发布到 Claude Code 插件市场，避免用户看不到更新。
主要能力：说明 Claude Code 插件发现依赖两个必须同时更新的配置文件——plugins/{plugin-name}/plugin.json（插件自身版本元数据）与 .claude-plugin/marketplace.json（市场目录，用户浏览时看到的内容）。用户执行 /plugin marketplace update 时读取的是 marketplace.json，因此只改 plugin.json 不会让用户看到新版本。
使用方式：按清单执行。第一步更新插件文件：plugin.json 的 version 字段，以及 agents、commands、skills 目录下的新增或修改内容。第二步更新文档：CHANGELOG.md、RELEASES.md 顶部新增版本条目，并更新 CLAUDE.md 中所有版本引用。第三步更新市场目录 .claude-plugin/marketplace.json 中的两处字段：metadata.version 与 plugins 数组中对应插件的 version。第四步提交并打标签，标签格式必须为 plugins/{plugin-name}/v{X.Y.Z}，例如 plugins/frontend/v3.3.0，然后推送 main 与标签。第五步用 /plugin marketplace update mag-claude-plugins 验证是否显示新版本。
版本号规则：MAJOR 用于破坏性变更，MINOR 用于向后兼容的新功能，PATCH 用于向后兼容的缺陷修复。
常见错误：忘记更新 marketplace.json 会导致用户仍看到旧版本；标签格式错误（如 frontend-v3.3.0、v3.3.0、frontend/v3.3.0 均不正确）；两个文件版本不一致，可用 grep -r "3.2.0" . 排查。标签已存在时可先删除本地与远程标签再重建；本地测试可用 /plugin marketplace add /path/to/claude-code。
限制：资料仅覆盖该市场的发布流程，未提供其他平台或自动化发布工具的说明。