用途:自动化处理 claude-code-marketplace 插件商城的版本升级流程,保证版本号一致性与更新日志完整性。适用于发布新版本、更新版本号、编写或更新 CHANGELOG、同步多个配置文件中的版本号等场景。
主要能力:管理版本号一致性(.claude-plugin/marketplace.json 与 claude-code-marketplace/common-tools/.claude-plugin/plugin.json 必须一致);按需更新各 SKILL.md 的 metadata.version;维护符合 Keep a Changelog 规范的 CHANGELOG.md;同步 .claude-plugin/README.md 中的技能列表与安装命令,并清理已删除技能的条目。
使用方式:先确定新版本号(语义化版本 MAJOR.MINOR.PATCH),更新两个 JSON 配置文件的 version 字段;扫描 claude-code-marketplace/common-tools/skills 下所有 SKILL.md,仅对发生实际变更的技能更新 metadata.version,新增技能初始版本通常为 0.0.1 或 0.1.0;在 common-tools/CHANGELOG.md 顶部按 Added/Changed/Deprecated/Removed/Fixed/Security 分类添加带日期(YYYY-MM-DD)的条目;检查 README 技能条目与安装命令准确性;最终核对版本号一致性并用类似 chore(plugin): release version X.Y.Z 的提交信息提交。安装命令示例:npx skills add https://github.com/ruan-cat/monorepo/tree/main/claude-code-marketplace/common-tools/skills/<skill-name>。
限制:不强制所有技能与商城版本号同步,默认只更新实际变更的技能;资料未提供具体版本号、发布日期及实际执行脚本等细节。