---
name: ufomiao-zcf-release
description: "Prepare a ZCF release with changesets, a bilingual changelog, a release branch and a pull request"
license: "MIT"
disable-model-invocation: true
metadata:
  decimalai-skill-id: "31ef879a-a46d-4420-a5c4-221ec91b9b45"
  decimalai-version-id: "7f8567e6-32a9-4ac9-bed4-5f977aa6395a"
  decimalai-version: "2"
  decimalai-body-sha256: "d27924726ec148a8ac5dd399ad1f093ac695794119231a68b02665164287098b"
  decimalai-name: "ufomiao/zcf-release"
  decimalai-format: "1"
  decimalai-invocation: "user"
  decimalai-category: "devops"
  decimalai-source: "https://app.decimal.ai/s/ufomiao-zcf-release@2/SKILL.md"
---
# ZCF Release

Prepare a release PR. Merging it to `main` makes `.github/workflows/release.yml` run the tests, publish to npm and create the tag and GitHub Release.

Usage: `/zcf-release [-p|-mi|-ma|<version>]`: `-p`/`--patch` (default), `-mi`/`--minor`, `-ma`/`--major`, or an exact semver such as `3.8.0` or `4.0.0-beta.1`. Arguments: $ARGUMENTS

Never create or push git tags yourself; the release workflow does it after merge.

## Steps

1. **Start clean.** Fetch and work from an up-to-date `main`. If there are uncommitted changes, show them and ask whether they belong in this release. Commit them separately with a proper Conventional Commits message, staging files by name.
2. **Collect changes.** Last tag: `git describe --tags --abbrev=0`. Read `git log <tag>..HEAD` and the diff, and group user-visible changes into New Features / Optimization / Fixes / Documentation. Skip internal-only commits (CI, tests, chores) unless they matter to users.
3. **Write the changeset.** Create `.changeset/release-<timestamp>.md`:

   ```markdown
   ---
   "zcf": patch
   ---

   ## New Features

   - English entry

   ## 新功能

   - 中文条目
   ```

   Each section is in English first, then the same section in Chinese; never mix languages on one line. Changesets only accept `patch`, `minor` or `major` here. For an exact version, pick the bump type that reaches it. If none does (for example a pre-release), run step 4 with `patch`, then set `version` in `package.json` and the new top heading in `CHANGELOG.md` to the exact version.
4. **Apply.** Run `pnpm changeset version`, which bumps `package.json`, updates `CHANGELOG.md` and deletes the changeset file. Read the new version from `package.json` and show the user the CHANGELOG diff.
5. **Verify.** Run `pnpm typecheck`, `pnpm test:run` and `pnpm build`. Stop and report if any of them fail.
6. **Branch, commit, PR.**
   - `git checkout -b release/v<version>`
   - `git add package.json CHANGELOG.md`, then `git commit -m "chore: release v<version>"`
   - `git push -u origin release/v<version>`
   - `gh pr create --title "chore: release v<version>"` with a body based on `.github/PULL_REQUEST_TEMPLATE` that contains the changelog section. Tick only the checks that you ran in step 5.
7. **Report** the PR URL and remind the user that merging it publishes to npm.