用途：为 swarm-tools 单仓库处理版本号递增与 npm 发布，涉及 opencode-swarm-plugin、claude-code-swarm-plugin、swarm-mail、swarm-queue 四个包。标准流程为 changesets → CI → npm，除 CI 故障外不手动发布。
主要能力：创建 changeset 并选择 patch/minor/major 级别；仅对实际变更的包做版本递增；推送后由 CI（publish.yml）检测 changeset、执行 changeset version 与 bun update、同步 plugin.json 版本、在 changeset-release/main 分支创建或更新发布 PR，并用 vercel/ai-action 生成 PR 标题；合并后 CI 构建全部包、校验 tarball、运行 scripts/ci-publish.sh 打包发布、打标签并生成发布推文。
使用方式：用 heredoc 写入 .changeset/<name>.md，指定包名与 bump 级别；git add/commit/push 到 main；用 gh pr merge <number> --squash --delete-branch 合并发布 PR；用 npm view 校验发布结果，重点确认依赖中不含 workspace:*。手动递增可用 ./scripts/bump-version.sh <version>，需同步更新各包 package.json 与 plugin.json。
适用场景：维护该单仓库的发布者。限制：依赖 CI 与 changesets 配置；若发布包出现 workspace:*、CI 报 E403、plugin.json 版本不一致或发布 PR 未创建，需按故障排查处理，例如检查 bun 版本是否 >= 1.3.5、确认安全网是否运行，或对损坏包做 patch 递增后重新推送合并。