Prepare and publish DeepChat releases in this repository. Use when Codex needs to bump the app version, update CHANGELOG.md, keep release notes bilingual from v1.0.1 onward with English bullets first and Chinese bullets second, run release checks, create or update versioned release branches such as release/v1.0.1, continue a half-finished release, fast-forward main with the documented release flow, create or push version tags, or clean up release branches after publishing.
Follow the repository-specific DeepChat release process. Prepare release metadata on dev, keep CHANGELOG.md concise, and publish through the documented fast-forward flow instead of merge commits on main.
Inspect git state before changing anything:
release/<version> exists locally or on origin.v<version> exists locally or on origin.If a local or remote tag already exists on the wrong commit, stop and ask before replacing it.
Pick the mode that matches the user's request and current git state:
prepare metadata
Update package.json, CHANGELOG.md, and the release notes commit on dev.cut release branch
Create release/<version> from the release-ready commit on dev and push it.update existing release branch
Use this when the release branch already exists but metadata changed afterward. Commit on dev, move release/<version> to the new dev commit, and force-push only the disposable release branch.publish
Use this only after the release PR is approved. Fast-forward main, create the version tag on the same commit, push the tag, and then delete the temporary release branch.Use references/release-checklist.md for exact commands.
When preparing a release on dev:
package.json to the target version.CHANGELOG.md section at the top.For v1.0.1 and later, format changelog entries in this order:
## vX.Y.Z (YYYY-MM-DD)
- English bullet
- English bullet
- 中文条目
- 中文条目
Use the current local date in YYYY-MM-DD form. Preserve older changelog sections unless the user explicitly asks to rewrite them.
After editing release metadata, run these repo-required commands:
pnpm run formatpnpm run i18npnpm run lintPrefer running pnpm run typecheck before cutting the release branch. Run tests when the user asks, when the release touches behavior beyond metadata, or when risk is unclear. Report pre-existing failures separately from the release metadata work.
dev as the integration branch.release/<version> as disposable and identical to a commit already on dev.main.pnpm run release:ff -- release/<version> --tag v<version> to publish after approval.Read ../../../docs/release-flow.md when you need the full repository policy or if the checklist and repo docs ever diverge.
When the user says something like "the release branch already exists but the tag is not created yet" or "I fixed the changelog after cutting the release branch":
dev.dev.release/<version> to HEAD.release/<version> with --force-with-lease.main.v1.0.1 and 2026-04-02.Activate this skill for requests like: