用途:为设计系统发布做语义化版本(semver)判断。它把设计系统变更按统一框架分类,输出 bump 建议、变更构成、CHANGELOG 条目和迁移输入,减少团队在版本级别上的争论。它是该技能包中 semver 判定的唯一来源,其他技能(change-communication、contribution-workflow、deprecation-process、decision-record)指向这里而不自行分类。
主要能力:建立基线(读取每个已发布包的 package.json 当前版本,对比上次发布标签,检查导出组件、prop 类型与默认值、token、CSS 自定义属性、exports 映射);接受 git diff、PR 描述、自然语言变更列表等输入;将每项变更归为 Breaking→major、Minor→minor、Patch→patch 三类;按最高严重级别决定 bump;识别伪装成修复的破坏性变更、pre-1.0 约定、仅弃用发布、peer 依赖变化、CSS 特异性变化、token 值变化等边缘情况;生成按 Keep a Changelog 分类的条目和 [migration: ...] 说明;为每个破坏性变更列出迁移前的 before/after 行;major 时提供决策记录骨架。
使用方式:优先使用团队现有发布工具,如 .changeset/ 生成 changeset 文件,或按 conventional commits 措辞(feat、fix、feat!),或交由 release-please/semantic-release 决定版本。安装前需验证 frontmatter 中 references 路径存在;若因扁平化安装器丢失 references,应重新安装并运行 verify-install.sh。
限制:迁移原因必须来自用户、PR 描述或关联决策记录,否则写 [ask author],不得编造理由、日期、链接、负责人或百分比。若无法读取仓库或 diff,只能基于变更列表分类。具体命令、链接、日期等资料未提供。