用途:在 GitHub 项目发布新版本时使用,适用桌面应用、CLI 工具、Web 应用、库/SDK 等基于 GitHub 的软件项目,也可用于 monorepo 多组件批量发布。
主要能力:统一版本号文件与 CHANGELOG 条目;综合 CHANGELOG、git log 与 PR 作者信息生成 Release Notes;创建并推送 tag;监控 CI 构建;更新与验证 Release 产物;发布后清理与镜像同步检查。项目发布配置集中在 config/projects.yaml 管理,模板见 config/projects.example.yaml,可按平台、自动更新、排除产物决定构建矩阵与预期产物。
必要用法与步骤:打 tag 前完成发布前检查,包括工作区干净、版本号一致、CHANGELOG 已更新、CI 工作流存在、本地测试门禁通过。打 tag 前须回答五个自检问题并打印结果,未获明确授权时先请用户确认,不得跳过验证直接打 tag。常用命令包括:git status、git tag "vX.Y.Z"、git show vX.Y.Z --stat、git push origin "vX.Y.Z"、gh run list --limit 3、gh run view <RUN_ID> --json jobs --jq '.jobs[] | "(.name): (.conclusion)"'、gh run view <RUN_ID> --log-failed、gh release edit vX.Y.Z --repo <owner>/<repo> --notes "..."、gh release view vX.Y.Z --json assets --jq '.assets[].name'。Release Notes 模板见 references/release-notes-guide.md,Tauri 桌面应用见 references/tauri-release.md,monorepo 发布 SOP 见 references/monorepo-release.md。
限制与边界:本技能不负责日常 Actions 配额治理,该部分由 git-workflow §11 负责;不用于跨仓库分发(用 subtree-publish skill);单应用项目与 monorepo 模式流程不同。禁止把 release 当测试,不得用 draft release、workflow_dispatch 触发 release workflow 或单平台 dry-run 做验证,应改用 pull_request 或 workflow_dispatch 触发的 preview workflow。正式发布只允许从干净、非 detached 且 HEAD 与 origin/main 一致的 main 工作树执行,已有同名 tag、身份缺失、CI 失败或资产数不一致时 fail-closed,设置 RELEASE_CONFIRMED=1 后方可执行。不删除或覆写已公开版本的 tag、二进制、签名与 manifest。资料未提供具体收费与价格信息,暂未提供。