Agent Skills
返回列表
💻

Changesets 版本与更新日志管理器

开发编程 更新于 2026.08.29

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

请根据 https://skillhub.cn/install/skillhub.md,把 @user_3c6cb52e/changesets-version-changelog-manager 安装到 AI 助手。

技能介绍

它解决什么问题

在 monorepo 或单包仓库中手工维护版本号,通常意味着到处翻 package.json、手动改写 CHANGELOG.md、回忆某次发布到底改了什么。结果是版本号语义混乱、更新日志缺失,或者误把未合并的改动打进正式包。这个技能把版本管理收敛到基于 PR 的变更记录上:每次改动先写一份变更说明,由工具链据此判断 semver 级别、生成日志并驱动 npm 发布。

核心能力与工作方式

  • 变更先记录:贡献者在 PR 中附带 changeset,描述这次改动是 patch、minor 还是 major,而不是事后凭记忆补版本号。
  • PR 即判定入口:检查 PR 是否包含 changeset 是流程的关键卡点,推荐使用 changeset bot,也可以在 CI 中运行 yarn changeset status,让 changesets 失败时直接让构建失败。
  • 自动化版本提升与日志生成:根据 changeset 自动提升 semver 版本号,并把对应条目合并进包的更新日志,减少手工编辑出错。
  • 衔接 npm 发布:在 monorepo 与单包仓库两种形态下,把版本提升、日志生成和发布串成一条由 PR 驱动的流水线。

适用边界与注意点

这套流程的收益依赖团队纪律:如果提交直接落到主干而绕开 PR,changeset 的判定环节就会失效。此外,yarn changeset status 属于 CI 中的可选策略,只有你希望 changesets 失败就让构建失败时才启用。仓库形态不同,发布路径也需要相应配置;把已有仓库接进来之前,先确认版本号与日志的既有约定能被这套机制兼容。

使用场景

  • 在 monorepo 中合并功能 PR 前,需要确认本次改动是否附带 changeset,并判定 patch、minor 或 major 升级级别。
  • 单包仓库发布前,需要把已合并的多个 changeset 汇总,自动提升版本号并生成 CHANGELOG.md 条目。
  • CI 中需要用 yarn changeset status 检查 changesets 是否通过,并在失败时阻断构建。
  • npm 包即将发布时,需要依据 PR 变更记录完成 semver 提升、日志生成和发布衔接。

适合人员

  • monorepo 维护者,需要在多个包之间统一版本提升与更新日志,避免手工改 package.json。
  • npm 包发布负责人,需要在发布前汇总变更并确认 semver 级别与 CHANGELOG 内容。
  • CI 平台工程师,需要配置 PR 卡点,在 changeset 缺失或 changesets 失败时阻断合并。
  • 包贡献者,需要在提交 PR 时按流程补写 changeset,说明改动的影响范围与版本影响。