AgentSkillsCN

bumpup-versions

通过 pnpm 在单体仓库的所有软件包中，持续提升并同步版本号。使用此方法，可确保根目录与所有工作区软件包共享相同的版本号。

SKILL.md
--- frontmatter
name: bumpup-versions
description: Consistently bump and synchronize versions across all packages in the monorepo using pnpm. Use this to ensure the root and all workspace packages share the same version number.

Bumpup Versions Skill

This skill provides a standardized workflow to synchronize and increment version numbers across the entire monorepo (root and all packages) using native pnpm commands.

When to Use

  • •When preparing for a release that requires a unified version bump across all packages.
  • •When you notice version drift between the root package.json and workspace packages.
  • •When requested to "bump versions", "release a new version", or "sync package versions".

Instructions

1. Determine Target Version

Identify if you are performing a semantic bump (patch, minor, major) or setting an explicit version (e.g., 1.0.0).

2. Synchronize Workspace Packages

Run the version command recursively across all packages in the workspace using pnpm -r exec. The --no-git-tag-version flag prevents automatic git tagging and commits, and --allow-same-version ensures it doesn't fail if a package is already at the target version.

bash
pnpm -r exec pnpm version <version_or_bump_type> --no-git-tag-version --allow-same-version

3. Update Root Version

Update the root package.json to match the workspace versions.

bash
pnpm version <version_or_bump_type> --no-git-tag-version --allow-same-version

4. Update Lockfile and Internal References

Run pnpm install to ensure pnpm-lock.yaml is updated with the new versions and any internal workspace dependencies (using workspace:*) are correctly resolved.

bash
pnpm install

5. Verify Changes

Check a sample of package.json files to ensure they all reflect the new version.

bash
grep '"version":' package.json packages/*/package.json packages/plugins/*/package.json

Termination Criteria

  • •The version field in the root package.json matches the target version.
  • •The version field in all packages/**/package.json files matches the target version.
  • •pnpm-lock.yaml has been updated and there are no linting/test regressions related to the version change.

Examples

Scenario: Performing a patch bump across the monorepo

  1. •Agent: "I will bump the version to the next patch."
  2. •Command: pnpm -r exec pnpm version patch --no-git-tag-version --allow-same-version
  3. •Command: pnpm version patch --no-git-tag-version --allow-same-version
  4. •Command: pnpm install
  5. •Verification: grep '"version":' package.json packages/*/package.json

Scenario: Setting an explicit version (e.g., 0.2.0)

  1. •Agent: "Synchronizing all packages to version 0.2.0."
  2. •Command: pnpm -r exec pnpm version 0.2.0 --no-git-tag-version --allow-same-version
  3. •Command: pnpm version 0.2.0 --no-git-tag-version --allow-same-version
  4. •Command: pnpm install