release
[UDS] 引導發布流程——語意化版本、發布模式，以及 start/finish/promote/deploy 的順序。 Use when: 切一個發布版本、決定語意化版本要升哪一位、把 release candidate 晉級為穩定版、記錄一次部署。 Not for: 撰寫變更日誌條目本身——請用 /changelog；部署的實作機制——請用 /deploy。 Keywords: release, semantic versioning, version bump, release candidate, promote, 發布, 語意化版本, 發版流程, 版本晉級.
Source facts
- Repository
- AsiaOstrich/universal-dev-standards
- Last source activity
- September 8, 2026 at 05:07
- Detected SKILL.md language
- Chinese
- Stars
- 75
- Forks
- 13
Install options
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Review the source files
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
File Explorer
5 filesShowing SKILL.md
SKILL.md
Source instructions · Read-only preview- name
- release
- source
- ../../../../skills/release-standards/SKILL.md
- source_version
- 1.1.0
- translation_version
- 1.2.0
- last_synced
- 2026-08-17T00:00:00.000Z
- status
- current
- description
- [UDS] 引導發布流程——語意化版本、發布模式，以及 start/finish/promote/deploy 的順序。 Use when: 切一個發布版本、決定語意化版本要升哪一位、把 release candidate 晉級為穩定版、記錄一次部署。 Not for: 撰寫變更日誌條目本身——請用 /changelog；部署的實作機制——請用 /deploy。 Keywords: release, semantic versioning, version bump, release candidate, promote, 發布, 語意化版本, 發版流程, 版本晉級.
- allowed-tools
- Read, Write, Grep, Bash(git:*), Bash(npm version:*)
- scope
- universal
- argument-hint
- [version]
# 發布助手
> **語言**: [English](../../../../skills/release-standards/SKILL.md) | 繁體中文
引導遵循語義化版本和變更日誌最佳實踐的發布流程。
## 子命令
| 子命令 | 說明 | 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 |
## 工作流程
1. **決定版本** - 根據變更決定版本類型（MAJOR/MINOR/PATCH）
2. **更新版本檔案** - 更新 package.json 和相關版本參考
3. **更新 CHANGELOG** - 將 [Unreleased] 條目移至新版本區段
4. **執行發布前檢查** - 驗證測試、lint 和標準合規
5. **建立 git tag** - 使用 `vX.Y.Z` 格式標籤
6. **提交並推送** - 提交版本更新並推送標籤
### 版本遞增規則
| 變更類型 | 遞增 | 範例 |
|---------|------|------|
| 破壞性變更 | 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 並撰寫發布說明
> - 通知利害關係人新版本已發布
## 參考
- [變更日誌格式指南](./changelog-format.md) — 要撰寫或審查變更日誌時讀它。
- [發布流程指南](./release-workflow.md) — 真的要發一版、需要逐步流程時讀它。
- [語意化版本指南](./semantic-versioning.md) — 要判斷一個變更算 major、minor 還是 patch 時讀它。
- 詳細指南：[guide.md](./guide.md)
- 核心規範：[versioning.md](../../../../core/versioning.md)
View on GitHub