Agent Skills
返回列表
💻

Rust 发布 PR 与日志助手

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/prepare-rust-release-prs-and-changelogs-from-workspace-changes-with-release-plz。

技能介绍

解决的问题

在 Rust 项目中,当工作区包含多个 crate 时,手动管理版本发布容易出错:比如遗漏某次变更的版本号提升、整理变更日志耗时费力,或发布 PR 内容混乱导致协作困难。尤其当多个 crate 相互依赖时,手动协调发布顺序和变更记录更是一大负担。

技能如何工作

该技能基于 release-plz 工具,核心能力包括:

  • 检查工作区变更:扫描 Rust 工作区的代码修改,识别需要发布的 crate
  • 生成发布 PR:自动为变更的 crate 创建发布 PR,包含版本号提升和更新日志
  • 版本号管理:根据语义化版本规则自动调整版本号(如 0.1.0 → 0.1.1)
  • 更新日志组装:整合提交记录生成规范的变更日志

关键步骤:

  1. 通过 GitHub Action 或 CLI 运行 release-plz
  2. 工具分析工作区变更,确定待发布的 crate 及版本号
  3. 自动创建发布 PR,包含版本更新和变更日志
  4. 支持从 CI 系统触发,或在终端手动执行

适用边界与注意点

  • 依赖要求:需已配置 Rust 和 Cargo 工作区,且项目中包含 release-plz
  • 工具依赖:实际功能依赖上游 release-plz 的配置和稳定性,建议参考官方文档(https://release-plz.dev/)
  • 变更范围:需确保工作区变更已提交并推送,否则可能无法正确识别待发布的修改
  • 兼容性:支持 GitHub、Gitea 和 GitLab 等代码托管平台,具体配置需参考对应 CI 环境文档

使用场景

  • Rust 工作区有多个 crate 改动,需要为各包生成发布 PR 和更新日志
  • 多 crate 项目要按变更自动提升版本号,避免手动核对依赖顺序
  • 在 CI 中使用 release-plz 检查工作区变更,输出发布 PR
  • 需要从终端或 Gitea/GitLab 环境运行 release-plz 准备发布

适合人员

  • 维护 Rust 多 crate 工作区的开发者,希望自动生成发布 PR 和变更日志
  • 负责 CI 发布流程的工程师,需要统一生成版本更新和日志
  • 在 Gitea 或 GitLab 中管理 Rust 项目并准备发布的维护者
  • 需要规范版本号与变更记录的开源项目维护者