版本发布管理

技能简介

版本发布管理技能用于在修复提交完成后，对ralph-orchestrator进行版本升级并触发新版本发布。所有版本号统一存储在工作区的Cargo.toml中，各crate通过 version.workspace = true 继承。

业务背景

版本发布管理解决Ralph编排器升级繁琐的问题。传统方式需手动修改7处版本号，易遗漏导致构建失败。该工具实现一键统一升级、自动测试验证、智能推送标签并触发CI全流程，让开发人员从重复操作中解放，专注核心功能开发，同时降低人为失误导致的发布事故风险。

落地案例：某次修复关键Bug后，开发人员在工具中输入新版本号"2.3.1"，系统自动扫描Cargo.toml完成7处版本号替换，执行构建与测试套件验证通过后，创建提交、推送至仓库并打上v2.3.1标签。GitHub Actions随即接管，自动生成Release页面、编译Linux/Mac/Windows二进制文件，同步发布至crates.io和npm，全程无需人工干预。

能做什么

• 统一升级工作区中所有7处版本号
• 自动构建并运行测试验证
• 创建版本提交并推送
• 打Git标签触发CI发布流程
• 跟踪发布进度

使用说明

安装指令：

clawhub install release-bump

发布流程：

1. 升级版本号：编辑Cargo.toml，替换所有7处version = "X.Y.Z"
2. 构建：运行cargo build更新Cargo.lock
3. 测试：运行cargo test确保通过
4. 提交：git add Cargo.toml Cargo.lock && git commit -m "chore: bump to vX.Y.Z"
5. 推送：git push origin main
6. 打标签：git tag vX.Y.Z && git push origin vX.Y.Z

版本号位置（全部在Cargo.toml中）：

• 第17行左右：workspace.package.version
• 第113-118行：6个内部crate依赖（ralph-proto、ralph-core、ralph-adapters、ralph-tui、ralph-cli、ralph-bench）

CI自动流程：推送标签后，.github/workflows/release.yml自动执行：创建GitHub Release、构建多平台二进制文件、发布到crates.io、发布到npm。

常见错误避免：

• 只更新workspace.package.version，忘记更新内部依赖版本
• 提交前未运行测试
• 手动创建GitHub Release（应让CI自动创建）
• 先推送标签再推送main分支

输入与输出

见下方输入与输出表格。

见下方输入输出表格。

风险提示

• 版本号更新不完整会导致构建失败
• 测试未通过就推送会触发失败的发布
• 标签推送后无法撤销，需谨慎确认版本号
• 原始页面信息不足，缺少自动化脚本和错误处理说明

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/paulpete/release-bump/SKILL.md
来源类型：github