用途:自动化完整发布周期,把版本号递增、变更日志生成、Git 标签、推送与 GitHub Release 创建串联起来,减少手工操作。
主要能力:支持 patch、minor、major 三种语义化版本递增,支持 --alpha 预发布后缀(如 1.2.4-alpha.1),支持 --dry-run 预览、--no-push 仅本地打标签,以及 status 查看当前版本与未发布变更。执行前做预检:确认当前分支(非 main 会警告并等待确认)、工作区干净(排除 ψ/ 目录文件)、与 origin/main 同步。会自动识别 package.json、Cargo.toml 或 VERSION 文件中的版本,按约定式提交前缀分类变更日志,创建注释标签并推送,调用 gh release create 生成 Release。
使用方式:在支持该技能的环境中运行 /release patch、/release minor、/release major、/release patch --alpha、/release patch --dry-run、/release patch --no-push 或 /release status。执行前始终请求用户确认,dry-run 只展示计划。
限制:必须存在可识别的版本文件;要求工作区干净,否则退出;发布前需用户明确批准,不会自动发布;不打标签不推送需显式加 --no-push;禁止强制推送,标签已存在则失败并询问;标签格式固定为 vX.Y.Z 或 vX.Y.Z-alpha.N;非 main 分支可发布但会警告。具体依赖环境与 GitHub CLI 状态暂未提供。