用途:把“该发版了”变成一次带标签、已推送、已触发流水线并公开发布的版本发布,同时生成整理过的 CHANGELOG。该技能是项目本地技能,因为步骤依赖本仓库的具体结构(三个版本文件、两个 lockfile、v* 标签触发 GH Actions 发布、spec-drift 与 test-reflection 这对 pre-commit 钩子)。
主要能力与默认规则:范围始终为线性,即 git describe --tags --abbrev=0 之后的所有提交;版本升级层级取子集中最高的 conventional-commit 层级,BREAKING CHANGE: 或 !: 在 0.X.Y 阶段产生 minor 升级,否则产生 major 升级,技能不会静默升到 1.0.0;CHANGELOG 的每条 Added/Fixed 由提交主题加 diff 阅读写成,chore:/docs:/test:/ci: 一律跳过;推送顺序为先标签后 main。
使用方式:技能全自动、全同步,从不调用 AskUserQuestion、不等待确认、不按用户偏好分支、不在后台运行命令,所有 Bash 调用都在前台执行,包括 gh run watch 这类长步骤,应设置匹配的 Bash 超时(如发布流水线 1800000 ms)而非分离进程。执行分九个阶段:检查与确定范围、构建发布分支、升级版本文件、写 CHANGELOG、验证并提交打标签、推送标签(含重复版本预检)、观察流水线并确认发布公开、把发布提交推回 main、清理。首次调用需阅读 references 下的 project-shape.md、conventional-commits.md,进入 Phase 4 时加载 changelog-template.md。
限制:仅在硬性前置条件会破坏发布时中止,包括目标 vX.Y.Z 标签已存在于 origin、工作区有非技能产生的未提交改动、npm run check 失败。技能不会用 --no-verify 绕过 pre-commit 钩子、不会强制推送、不会删除远程标签或分支、不会在 0.X.Y 阶段做 major 升级、不会重复打标签。对共享分支的推送可能被运行环境的自动模式分类器拦截,这超出技能范围,需用户自行解决。其他细节暂未提供。