antd-version-release - SKILL.md Agent Skill

name: antd-version-release description: ant-design 仓库的版本发布工作流。在用户提到发版、准备 release PR、升级发布版本号、执行正式 npm publish、或处理 release 分支与发布校验时使用。它不负责收集或生成 changelog；涉及 changelog 收集、整理、改写时应使用 changelog-collect。

Ant Design 发版指南

目标

这个 skill 面向 ant-design 仓库的真实发版流程，不是通用应用的自动发版模板。

它主要覆盖两类任务：

在 changelog 已准备好的前提下，准备 release PR 并更新 package.json
正式发布版本：执行 npm publish

触发场景

当用户提到以下任一场景时使用：

发版
发布版本
release
release PR
升级版本号
publish antd

核心规则

一、分支选择

新特性代码来自 feature 分支（通过 auto merge 合入 master），但 release PR 始终向 master 提交
无论是 patch 还是 minor 发布，release PR 的 base 分支都是 master
如果是维护分支发版，沿用已有稳定分支，例如 5.x-stable、4.x-stable

二、发布准备是手动维护的

ant-design 的发布准备通常就是一个普通 PR，主要更新：

CHANGELOG.en-US.md
CHANGELOG.zh-CN.md
package.json

不要假设 CI 会在 PR 合并时替你更新版本号。但 changelog 内容本身的收集、筛选、改写，不属于这个 skill 的职责。

三、正式发布发生在 PR 合并之后

真正的 npm 包发布动作，发生在 release PR 合并之后。

使用 npm publish
不要使用 npm run pub，仓库已经明确提示应使用 npm publish
在准备 release PR 时，不要手动创建 Git tag
发布完成后，postpublish 会处理 tag 推送，tag 再触发 GitHub Release 和钉钉通知等工作流

发布类型

除非用户明确要求其它流程，否则只处理常见的两类：

类型	代码来源	版本变化	使用场景
Patch	`master` 上的 bugfix	`x.y.z` -> `x.y.(z+1)`	Bug 修复、稳定性发布
Minor	`feature` 分支合入的新特性	`x.y.z` -> `x.(y+1).0`	特性批量发布

如果改动里明显包含未发布的新特性，优先判断为 minor；否则默认按 patch 处理。

流程

1. 确认目标分支与当前版本

开始前至少检查：

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

确认以下信息：

当前要发布的是哪条分支
package.json 里的当前版本号
最近一次有效 release tag
下一个版本应该升 patch 还是 minor

2. 确认 changelog 已经准备好

这个 skill 默认把 changelog 视为前置输入，而不是当前步骤的输出。

开始 release PR 前，确认：

CHANGELOG.en-US.md 已经有目标版本条目
CHANGELOG.zh-CN.md 已经有对应中文条目
changelog 文案已经过筛选与格式整理

如果还没有这些内容，先切换到 changelog-collect，不要在这个 skill 里临时生成。

3. 更新发布文件

发布准备通常只应检查并更新这三个文件：

CHANGELOG.en-US.md
CHANGELOG.zh-CN.md
package.json

要求：

中英文 changelog 必须已经存在且内容对齐
新增 section 标题必须与目标版本完全一致，例如 ## 6.3.6
必须有日期行，并且日期应接近当前发布日期，例如 `2026-03-31`
package.json 中的版本号必须与 changelog 版本一致

除非用户明确要求，否则不要额外引入别的 release 元数据文件。

4. 提交前校验

至少运行：

npm run lint:changelog

必要时再运行：

npm run version

npm run version 只在需要刷新本地生成的版本文件、做校验时才运行。不要把无关的生成文件顺手带进 release PR，除非仓库本来就预期它们会被更新。

5. 提交与 PR 规范

这个仓库里的 release 准备 PR，通常会使用类似标题：

docs: add changelog for 6.3.5
docs: release 6.3.5

注意：

如果 PR 标题里包含 release 或 changelog，就必须带上版本号
.github/workflows/verify-package-version.yml 会校验这件事
PR 标题保持英文
创建 PR 时必须使用仓库官方模板

如果需要生成 PR body：

保留模板原有 section
简要说明本次发布范围
changelog 类 PR 的正文可以简洁，因为详细内容已经写在 changelog 文件里

正式发布流程

这部分只在 release PR 已经合并，并且用户明确要求“现在发布”时才使用。

发布前提

发布前必须确认：

当前分支已经切到合并后的目标分支，通常是 master
工作区是干净的
远端分支已同步到最新
package.json 中的版本号已经是目标发布版本
CHANGELOG.en-US.md 中已经存在该版本对应的 changelog 条目
CHANGELOG.zh-CN.md 中也已经存在对应中文条目

scripts/check-version-md.ts 默认要求：

存在与当前版本完全匹配的 changelog section
日期格式正确，且接近当前发布日期

发布命令

执行：

npm publish

仓库里的相关行为：

prepublishOnly 会执行 scripts/pre-publish.ts
默认会检查远端 CI 状态，除非显式设置 SKIP_CI_CHECK
会下载构建产物
postpublish 会为当前版本推送 Git tag
该 tag 会触发后续 release 相关 GitHub workflow

不要做的事

不要使用 npm run pub
不要在 publish 前手动创建或推送版本 tag
changelog 或版本号缺失时不要直接发布

Agent 执行动作

当用户要求你协助发版时：

检查当前分支、版本号和最近 tags
根据目标分支和当前发布目标判断是 patch 还是 minor
确认 changelog 已由 changelog-collect 或用户提前准备好
更新 package.json
运行 npm run lint:changelog 和 tsx scripts/check-version-md.ts 校验
用带版本号的 docs: 标题提交
参考 .github/PULL_REQUEST_TEMPLATE.md，用正确的 base branch 创建 PR
只有在 PR 合并后、且用户明确要求时，才执行 npm publish