Release Assistant | 發布助手

Guide the release process following Semantic Versioning and changelog best practices.

引導遵循語義化版本和變更日誌最佳實踐的發布流程。

Subcommands | 子命令

Subcommand Description 說明

start

Start a release branch/process 開始發布流程

finish

Finalize release (tag, merge) 完成發布（標籤、合併）

changelog

Generate or update CHANGELOG.md 產生或更新變更日誌

check

Run pre-release verification 執行發布前檢查

Version Types | 版本類型

Type Pattern npm Tag 用途

Stable X.Y.Z

@latest

Production release

Beta X.Y.Z-beta.N

@beta

Public testing

Alpha X.Y.Z-alpha.N

@alpha

Internal testing

RC X.Y.Z-rc.N

@rc

Release candidate

Workflow | 工作流程

• Determine version - Decide version type based on changes (MAJOR/MINOR/PATCH)

• Update version files - Update package.json and related version references

• Update CHANGELOG - Move [Unreleased] entries to new version section

• Run pre-release checks - Verify tests, lint, and standards compliance

• Create git tag - Tag with vX.Y.Z format

• Commit and push - Commit version bump and push tags

Version Increment Rules | 版本遞增規則

Change Type Increment Example

Breaking changes MAJOR 1.9.5 → 2.0.0

New features (backward-compatible) MINOR 2.3.5 → 2.4.0

Bug fixes (backward-compatible) PATCH 3.1.2 → 3.1.3

Usage | 使用方式

• /release start 1.2.0

• Start release process for v1.2.0

• /release changelog 1.2.0

• Update CHANGELOG for v1.2.0

• /release finish 1.2.0

• Finalize and tag v1.2.0

• /release check

• Run pre-release verification

Next Steps Guidance | 下一步引導

After /release completes, the AI assistant should suggest:

發布流程完成。建議下一步 / Release process complete. Suggested next steps:

• 驗證 npm 發布狀態 npm view <pkg> dist-tags — Verify npm publication status

• 建立 GitHub Release 並撰寫發布說明 — Create GitHub Release with notes

• 通知利害關係人新版本已發布 — Notify stakeholders of new release

Reference | 參考

• Detailed guide: guide.md

• Core standard: versioning.md