| name | mcp_release |
| description | 发布新版本的完整流程。自动升级 package.json 版本号、构建项目、提交推送代码、创建 git tag、构建 Docker 镜像、创建 GitHub Release。当用户要求发布新版本、发版、release 时使用此 skill。 |
发布新版本
执行完整的版本发布流程，包括版本号升级、构建、提交、打标签、Docker 构建和 GitHub Release 创建。
前置条件
- 工作区干净或所有变更已暂存
- 已安装
gh CLI 并已登录
- 有远程仓库的推送权限
发布流程
按以下步骤顺序执行，每步完成后确认成功再继续：
Step 1: 读取当前版本号
node -p "require('./package.json').version"
记录当前版本号，计算新版本号（patch 位 +1）。
例如：0.3.17 → 0.3.18
如果用户指定了版本号，使用用户指定的版本号。
Step 2: 升级版本号
npm version patch --no-git-tag-version
如果用户指定了具体版本号，使用：
npm version <指定版本号> --no-git-tag-version
验证版本号已更新：
node -p "require('./package.json').version"
同步更新 common/version.ts 中的版本号（与 package.json 保持一致）：
使用 search_replace 工具将 common/version.ts 中的 VERSION 值替换为新版本号。
文件内容格式为：export const VERSION = "<旧版本号>";，替换为 export const VERSION = "<新版本号>";。
验证：
node -e "console.log(require('./common/version.ts'.replace('.ts','')))|| console.log('check common/version.ts manually')"
或直接读取 common/version.ts 确认版本号已更新。
Step 3: 运行测试
npm test
确认所有测试通过（退出码为 0）。如果测试失败，停止发布流程，先修复问题。
Step 4: 构建项目
npm run build
确认构建成功（退出码为 0）。
Step 5: 提交代码并推送（所有远端都要推）
本仓库配置了多个远端，用途不同：origin 承载 GitHub Release 与 npm 发布，另一个远端是部署链路的取码来源。git push 只会推当前分支的 upstream（一般是 origin），git hook 也不会自动推其余远端，因此必须逐个显式推送，否则会出现「npm 上有新版本、但部署环境仍是旧代码」。
git add -A
git commit -m "chore: release v<新版本号>"
for r in $(git remote); do
echo "--- push -> $r"
git push "$r" master
done
推完验证每个远端都已包含本次提交：
git fetch --all --quiet
for r in $(git remote); do
git merge-base --is-ancestor HEAD "$r/master" 2>/dev/null \
&& echo "$r/master ✓" || echo "$r/master ✗ 未包含本次提交"
done
全部为 ✓ 才继续下一步。
Step 6: 创建 Git Tag 并推送（所有远端都要推）
同 Step 5，tag 也要逐个远端推，不能只推 origin：
git tag v<新版本号>
for r in $(git remote); do
echo "--- push tag -> $r"
git push "$r" v<新版本号>
done
验证每个远端都有该 tag：
for r in $(git remote); do
git ls-remote --tags "$r" "refs/tags/v<新版本号>" | grep -q . \
&& echo "$r ✓ 有 v<新版本号>" || echo "$r ✗ 缺 tag"
done
Step 7: 构建 Docker 镜像
bash build_docker.sh
确认脚本执行成功。
Step 8: 创建 GitHub Release
gh release create v<新版本号> --title "v<新版本号>" --latest --generate-notes
使用 --generate-notes 自动生成 release notes，--latest 标记为最新 release。
Step 9: 验证 npm 发布
npm 发布由 GitHub Actions 自动触发（创建 Release 后），需要等待 Action 完成后再验证。
- 等待 GitHub Actions 的 publish workflow 完成：
gh run list --workflow=publish --limit=1
- 如果 workflow 仍在运行，等待其完成：
gh run watch $(gh run list --workflow=publish --limit=1 --json databaseId --jq '.[0].databaseId')
- 验证 npm 上的版本：
npm view alibabacloud-devops-mcp-server version
确认输出的版本号与本次发布的版本号一致。如果不一致，检查 GitHub Actions 日志排查原因。
完成确认
所有步骤完成后，输出发布摘要：
发布完成 ✅
- 版本: v<新版本号>
- Tag: v<新版本号>
- Docker: 构建完成
- Release: https://github.com/<owner>/<repo>/releases/tag/v<新版本号>
异常处理
- 构建失败：检查错误日志，修复后重新执行 Step 3
- 推送失败：检查远程仓库权限和网络连接
- Docker 构建失败：检查 Docker 是否运行、Dockerfile 配置
- gh 命令失败：检查
gh auth status，确保已登录
