用途:在准备发布、部署镜像、创建 Git 标签或跨环境晋级时,由 $specsfy-specialist-deploy 调用,负责版本号(SemVer)的准备与校验。完整发布或部署流程仍由 $specsfy-specialist-deploy 统一协调。
主要能力:定位项目根目录并读取 SEMVER、Git 标签、changelog 与交付相关产物;在缺失且初始版本已确认时创建 SEMVER;将改动分类为 patch、minor 或 major 并说明影响、提出下一版本;在授权准备阶段更新 SEMVER 并同步到元数据、镜像与清单;运行测试并确认版本高于上次发布;有发布授权时先推送不可变产物,再创建 Git 标签与 GitHub Release;交付版本、digest、commit、涉及环境和回滚命令。
用法:使用本地工具执行确定性操作,如 node scripts/semver.mjs current --project .、bump patch、verify 1.4.1、docker-tag registry.example/app、verify-docker-tag registry.example/app:1.4.1;安装技能时需将首个路径调整为代理技能库内 specsfy-specialist-versioning/scripts/semver.mjs。构建、推送或部署前用 docker-tag 生成标签并通过 verify-docker-tag 校验,标签与 SEMVER 不一致则中断流程。
限制:未经明确授权不得发布镜像、标签、GitHub Release 或执行部署;本地准备可创建或更新 SEMVER。SEMVER 保持根目录单一稳定 MAJOR.MINOR.PATCH 并含末尾换行。禁止用 latest 标识交付、镜像编译后改版本、未确认镜像在 registry 存在即打 Git 标签、复编译同号修补发布、混淆本地准备与隐式发布授权。相关技能:$specsfy-specialist-deploy 协调完整流程,$specsfy-specialist-docker 构建发布镜像,$specsfy-specialist-docker-swarm 应用镜像与 digest,$specsfy-specialist-ansible 传输清单并预检主机,$specsfy-specialist-delivery-engineering 协调测试、晋级、标签与发布。标准映射见 references/standards.md。