用途:bump-skill-version 用于更新技能目录下 SKILL.md 的 frontmatter 中的 version 字段(语义化版本),执行规则来自 CLAUDE.md 的 Versioning 部分。适合在修改技能逻辑或文档后、提交发布前使用。
主要能力:patch 对应缺陷修复、错别字修正、文档澄清;minor 对应新功能、新命令、新章节;major 对应脚本 CLI、清单格式或技能结构的不兼容变更。脚本会就地读取并重写 YAML frontmatter 的 version 字段,保留其他字段,并输出旧版本与新版本号。
使用方式:
bash "$CLAUDE_PROJECT_DIR/.claude/skills/bump-skill-version/scripts/bump.sh" <skill-name> <patch|minor|major>
当目标 SKILL.md 存在未提交的工作区改动时,脚本会拒绝运行,以保证版本变更成为一次独立的原子编辑;可用 --force 覆盖该限制。
适用场景:在编辑 skills/<skill-name>/ 内除琐碎空格外任意文件之后;在提交由智能体或人工审阅者发布的改动之前。
限制与注意事项:需要提供技能名与 patch/minor/major 参数;规则依赖 CLAUDE.md 的 Versioning 定义;工作区干净检查会阻止带未提交改动的执行,除非使用 --force。SKILL.md 被编辑后,package-skill.sh 的 PostToolUse hook 会自动重建 dist/<skill-name>.skill。价格、平台、效果等更多信息暂未提供。