AsiaOstrich 發布助手
語言: English | 繁體中文
引導遵循語義化版本和變更日誌最佳實踐的發布流程。
子命令
| 子命令 | 說明 | Description |
|---|---|---|
start |
開始發布流程 | Start a release branch/process |
finish |
完成發布（標籤、合併） | Finalize release (tag, merge) |
changelog |
產生或更新變更日誌 | Generate or update CHANGELOG.md |
check |
執行發布前檢查 | Run pre-release verification |
版本類型
| 類型 | 格式 | npm Tag | 用途 |
|---|---|---|---|
| 正式版 | X.Y.Z |
@latest |
Stable |
| 公開測試 | X.Y.Z-beta.N |
@beta |
Beta |
| 內部測試 | X.Y.Z-alpha.N |
@alpha |
Alpha |
| 候選版本 | X.Y.Z-rc.N |
@rc |
RC |
工作流程
- 決定版本 - 根據變更決定版本類型（MAJOR/MINOR/PATCH）
- 更新版本檔案 - 更新 package.json 和相關版本參考
- 更新 CHANGELOG - 將 [Unreleased] 條目移至新版本區段
- 執行發布前檢查 - 驗證測試、lint 和標準合規
- 建立 git tag - 使用
vX.Y.Z格式標籤 - 提交並推送 - 提交版本更新並推送標籤
版本遞增規則
| 變更類型 | 遞增 | 範例 |
|---|---|---|
| 破壞性變更 | MAJOR | 1.9.5 → 2.0.0 |
| 新功能（向下相容） | MINOR | 2.3.5 → 2.4.0 |
| 錯誤修復（向下相容） | PATCH | 3.1.2 → 3.1.3 |
使用方式
/release start 1.2.0- 開始 v1.2.0 的發布流程/release changelog 1.2.0- 更新 v1.2.0 的 CHANGELOG/release finish 1.2.0- 完成並標籤 v1.2.0/release check- 執行發布前驗證
下一步引導
/release 完成後，AI 助手應建議：
發布流程完成。建議下一步：
- 驗證 npm 發布狀態
npm view <pkg> dist-tags- 建立 GitHub Release 並撰寫發布說明
- 通知利害關係人新版本已發布
參考
- 變更日誌格式指南 — 要撰寫或審查變更日誌時讀它。
- 發布流程指南 — 真的要發一版、需要逐步流程時讀它。
- 語意化版本指南 — 要判斷一個變更算 major、minor 還是 patch 時讀它。
- 詳細指南：guide.md
- 核心規範：versioning.md