用途：在发布 GodotPrompter 或提升版本号时使用，提供版本升级顺序、tag 触发的工作流以及需要同步的 marketplace 清单说明。当前版本需查看 package.json 与 .claude-plugin/plugin.json，两者必须一致；完整命令序列见 CONTRIBUTING.md。
主要流程：运行 node scripts/bump-version.mjs <version>，它会升级全部五个文件；release.yml 会校验 package.json、根 plugin.json（Antigravity）、.claude-plugin/plugin.json、.claude-plugin/marketplace.json、.cursor-plugin/plugin.json，以及存在时的同级 marketplace，并把实时技能数量同步进各清单描述中的“N domain-specific skills”文本。
升级脚本不处理的两件事需手动完成：一是重新生成 docs/token-budget.md 中的表格（npm ci --prefix scripts && node scripts/count-tokens.mjs --tokenizer --markdown，粘贴在 TOKEN-TABLE 标记之间），并修正其上方简介中的技能/智能体数量；二是把 README.md 中 Grok 的 pin to a release 示例设为新 tag（它曾在三个版本里停留在 v1.11.0）。随后更新 CHANGELOG.md，提交、打 tag（v<version>）、带 tag 推送，release.yml 将进行校验、创建 GitHub release 并在配置 MARKETPLACE_TOKEN 时开启 marketplace PR。
限制与注意：根 plugin.json（Antigravity）也必须与 package.json 一致，打 tag 前需再核实；若工作流的 marketplace 步骤被跳过，需手动升级 skillsmith/.claude-plugin/marketplace.json（主）与旧版 godot-prompter-marketplace/.claude-plugin/marketplace.json；自动开启的 marketplace PR 需在兄弟仓库人工评审批准；推送前应重置本地兄弟克隆以避免冲突。