用途:面向多仓库/微服务架构,统一管理版本号、检测版本冲突并校验跨仓库兼容性,减少发布时的版本不一致问题。
主要能力:
- 语义化版本(Semver)规则执行,含 MAJOR/MINOR/PATCH 升级判定与 alpha、beta、rc 预发布标签。
- 三种对齐策略:lockstep(所有仓库同版本)、independent(各自独立升级)、umbrella(产品版本加各服务版本矩阵)。
- 基于 Conventional Commits 分析提交,推断应升级的类型(如 feat! 或 BREAKING CHANGE 触发 MAJOR)。
- 版本冲突检测:依赖版本冲突、API 契约版本冲突。
- 兼容性校验:semver 范围检查与 OpenAPI 契约对比。
- 版本矩阵管理,记录产品版本与各组件版本及破坏性变更。
- 自动化版本升级:更新 package.json、创建 git tag、更新 CHANGELOG.md 与版本矩阵。
使用方式:通过发布命令交互操作,如 /sw-release:align(交互式对齐)、/sw-release:validate-versions(校验兼容性)、/sw-release:bump <repo> <type>(升级指定仓库)、/sw-release:matrix(查看版本矩阵)。依赖 Git、semver 库与 SpecWeave core;可选 NPM、Conventional Commits、GitHub CLI。
适用场景:多仓库发布前版本同步、依赖与 API 契约兼容性检查、umbrella 产品里程碑版本管理。
限制:资料未提供具体安装步骤、收费方式与平台支持范围;实际命令行为依赖 SpecWeave 环境。