用途:面向 ant-design 仓库的真实发版流程,覆盖两类任务——在 changelog 已准备好时准备 release PR 并更新 package.json,以及正式执行 npm publish。触发场景包括发版、发布版本、release、release PR、升级版本号、publish antd。
主要能力与规则:release PR 始终向 master 提交,patch 与 minor 均如此;维护分支发版沿用已有稳定分支(如 5.x-stable、4.x-stable)。发布准备是手动维护的普通 PR,主要更新 CHANGELOG.en-US.md、CHANGELOG.zh-CN.md 和 package.json,不要假设 CI 会代改版本号。正式发布发生在 release PR 合并之后,使用 npm publish,不要用 npm run pub;准备 PR 时不要手动创建 Git tag,postpublish 会推送 tag 并触发后续工作流。默认只处理 Patch(x.y.z→x.y.(z+1))与 Minor(x.y.z→x.(y+1).0)两类。
使用方式:先确认目标分支与当前版本,检查 git branch -vv、git rev-parse --abbrev-ref HEAD、cat package.json、git tag --list | grep -v -E '(experimental|alpha|resource)' | sort -V | tail -20;确认 changelog 已由 changelog-collect 或用户提前准备好;更新三个发布文件,中英文条目对齐、section 标题与目标版本一致、含接近发布日的日期行、package.json 版本与 changelog 一致;提交前运行 npm run lint:changelog,必要时运行 npm run version;用带版本号的 docs: 标题提交,按官方模板创建 PR。发布前确认分支已切到合并后目标分支、工作区干净、远端同步、版本号与 changelog 条目齐备,再执行 npm publish。
限制:不负责 changelog 的收集、筛选与改写;changelog 或版本号缺失时不要发布;不要在 publish 前手动创建或推送 tag;若任务只是准备 release PR,创建 PR 后即停止。