---

name: claude-code-marketplace description: 管理 claude-code-marketplace 插件商城的版本升级，包括更新版本号、编写更新日志和同步 CHANGELOG。在用户要求升级插件版本、更新插件商城、发布新版本或编写更新日志时使用。触发关键词：claude-code-marketplace、插件升级、版本更新、发布插件、更新日志。

Claude Code 插件商城版本升级助手

本技能用于自动化处理 claude-code-marketplace 插件商城的版本升级流程，确保版本号一致性和更新日志的完整性。

使用场景

当遇到以下情况时使用本技能：

• 需要发布 claude-code-marketplace 的新版本
• 更新插件商城的版本号
• 编写或更新插件的 CHANGELOG
• 同步多个配置文件中的版本号

核心职责

1. 版本号管理：确保所有相关文件中的版本号保持一致
2. 更新日志维护：编写符合规范的版本更新说明
3. 文件同步：自动更新所有必要的配置文件

相关文件目录

插件商城的核心文件位于以下目录：

• .claude-plugin - 插件商城根配置目录
• claude-code-marketplace\common-tools - 插件工具包目录

需要更新版本号的文件

执行版本升级时，必须同步更新以下文件中的版本号：

1. .claude-plugin\marketplace.json - 插件商城主配置文件
2. claude-code-marketplace\common-tools\.claude-plugin\plugin.json - 插件配置文件

版本号格式

遵循语义化版本规范（Semantic Versioning）：

• MAJOR.MINOR.PATCH 格式（例如：1.2.3）
• MAJOR：不兼容的 API 修改
• MINOR：向下兼容的功能性新增
• PATCH：向下兼容的问题修正

更新日志文件

每次版本更新的内容必须记录在以下文件中：

• claude-code-marketplace\common-tools\CHANGELOG.md

更新日志格式规范

遵循 Keep a Changelog 规范：

Copy## [版本号] - YYYY-MM-DD

### Added

- 新增的功能

### Changed

- 变更的功能

### Deprecated

- 即将废弃的功能

### Removed

- 已移除的功能

### Fixed

- 修复的问题

### Security

- 安全相关的修复

升级流程步骤

执行插件版本升级时，请按照以下顺序操作：

1. 确定新版本号

   • 根据变更类型确定版本号增量（MAJOR/MINOR/PATCH）
   • 确认新版本号符合语义化版本规范

2. 更新配置文件

   • 更新 .claude-plugin\marketplace.json 中的 version 字段
   • 更新 claude-code-marketplace\common-tools\.claude-plugin\plugin.json 中的 version 字段
   • 确保两个文件的版本号完全一致

3. 编写更新日志

   • 在 CHANGELOG.md 文件顶部添加新版本条目
   • 使用标准的 changelog 分类（Added/Changed/Fixed 等）
   • 记录本次更新的所有变更内容
   • 添加发布日期

4. 验证一致性

   • 检查所有文件中的版本号是否一致
   • 检查 CHANGELOG 格式是否符合规范
   • 确认所有变更都已记录

5. 提交变更

   • 使用规范的 commit message
   • 推荐格式：chore(plugin): release version X.Y.Z

示例

示例 1：发布补丁版本

假设当前版本为 1.2.3，修复了一个 bug，需要发布 1.2.4：

步骤：

1. 更新两个 JSON 文件中的 version 为 "1.2.4"

2. 在 CHANGELOG.md 添加：

   Copy## [1.2.4] - 2025-01-05
   
   ### Fixed
   
   - 修复插件加载时的路径解析错误
   

3. 提交：chore(plugin): release version 1.2.4

示例 2：发布功能版本

假设当前版本为 1.2.4，新增了一个功能，需要发布 1.3.0：

步骤：

1. 更新两个 JSON 文件中的 version 为 "1.3.0"

2. 在 CHANGELOG.md 添加：

   Copy## [1.3.0] - 2025-01-05
   
   ### Added
   
   - 新增插件热重载功能
   - 支持自定义插件配置路径
   
   ### Changed
   
   - 优化插件加载性能
   

3. 提交：chore(plugin): release version 1.3.0

注意事项

1. 版本号一致性：确保所有文件中的版本号完全一致，避免配置不同步
2. CHANGELOG 完整性：每次发布都必须更新 CHANGELOG，不能遗漏
3. 语义化版本：严格遵循语义化版本规范，让用户清楚了解变更影响
4. 日期格式：使用 ISO 8601 格式（YYYY-MM-DD）
5. 变更分类：准确使用 changelog 分类，帮助用户快速定位关注的内容

相关资源

• 语义化版本规范
• Keep a Changelog