用途:该技能用于 Archon 项目的版本发布流程,从 dev 分支创建一次正式发布,自动生成变更日志、递增版本号并创建指向 main 的 PR。
主要能力:比较 dev 与 main,从提交生成变更日志条目;按 patch/minor/major 规则递增版本;更新版本文件、工作区包版本与锁文件;创建 dev→main 的发布 PR;合并后打标签、创建 GitHub Release,并在发布工作流构建二进制后,用已发布 checksums.txt 中的真实 SHA256 更新 Homebrew 公式、同步 coleam00/homebrew-archon tap,并通过 /test-release 验证端到端安装路径。
使用方式:技能按步骤执行。先校验状态(必须在 dev 分支且工作树干净,并确认 dev 包含 main);随后进行强制的编译二进制冒烟测试(bun build --compile 后运行 --help,失败则中止发布);再检测技术栈与当前版本(pyproject.toml、package.json、Cargo.toml、go.mod);确定版本递增;收集提交(以 dev 上最后一次 Release x.y.z 提交为边界,而非 git log main..dev);起草并写入 CHANGELOG.md;展示给用户确认后提交并创建 PR;合并后打标签、创建 Release、同步 dev 与 main。
适用场景:适用于采用该发布流程的 Archon 仓库,尤其是需要同时维护 Homebrew 公式与 tap 的 Node/Bun CLI 项目。
限制:Homebrew 公式的 SHA256 只能在发布工作流构建二进制后获得,版本字段与 sha256 必须原子更新,否则会产生校验和不匹配;若 dev 未包含 main 或编译二进制冒烟测试失败,必须中止发布;无新提交时报告无可发布内容。具体命令与流程细节以资料为准。