Release Branch Management
Manages the bundle release workflow: developers branch from release/*, PRs target release/* directly, and after publishing, changes sync back to x via rebase.
Context
OneKey ships periodic App Shell releases (tagged v{X.Y.Z} on the x branch). After each App Shell release, a release branch (release/v{X.Y.Z}) is created from the tag. Bundle release features are developed directly on this branch — PRs target release/*, not x. After bundle publishing, changes are synced back to x via rebase.
Release branch auto-detection: All subcommands read VERSION from .env.version and construct release/v${VERSION} automatically.
Quick Reference
| Subcommand | When to use | Guide |
|---|---|---|
checkout |
Start working on a bundle release feature | checkout.md |
prepare |
Set BUILD_NUMBER before triggering CI | prepare.md |
diff-check |
Before publishing — review changeset | diff-check.md |
publish |
Diff check passed — record release | publish.md |
sync |
After publishing — rebase to x | sync.md |
Subcommand Routing
Parse the argument passed to this skill:
checkout [branch-name]→ Read and follow checkout.mdprepare→ Read and follow prepare.mddiff-check→ Read and follow diff-check.mdpublish→ Read and follow publish.mdsync→ Read and follow sync.md- No argument → Show this quick reference and ask which subcommand to run
Typical Release Flow
/1k-bundle-release checkout feat/my-fix ← Branch from release/* to start work
... develop, create PR targeting release/*, QA verifies, merge ...
/1k-bundle-release prepare ← Set BUILD_NUMBER
/1k-bundle-release diff-check ← Review changeset before publishing
/1k-bundle-release publish ← Record release in RELEASES.json
/1k-bundle-release sync ← Rebase changes to x
These steps are designed to run in sequence, but each can also run independently.
Key Files
| File | Location | Purpose |
|---|---|---|
| Version source | .env.version (VERSION field) |
Determines release branch name |
| Release tracking | RELEASES.json (release branch root) |
Each entry: seq, commit SHA, date, PR list, notes |
Related Skills
/1k-git-workflow— Branch naming, commit conventions/commit— Create commits