Release

版本發布工作流

描述

完整的版本發布準備流程，包含版本號更新、CHANGELOG 生成、文檔同步和部署檢查。

觸發條件

• 「準備發布」「release」「發布版本」
• 「REL: v1.2.0」

📦 發布流程

┌─────────────────────────────────────────────────────────────┐
│                   Release Workflow                           │
├─────────────────────────────────────────────────────────────┤
│  Phase 1: 🔍 發布檢查 (Pre-release Check)                    │
│  ├─ 確認所有測試通過                                         │
│  ├─ 執行安全掃描                                             │
│  ├─ 檢查待處理問題                                           │
│  └─ 確認 main/master 分支狀態                               │
├─────────────────────────────────────────────────────────────┤
│  Phase 2: 🔢 版本決定 (Version Decision)                     │
│  ├─ 分析變更類型 (MAJOR/MINOR/PATCH)                        │
│  ├─ 確認版本號                                               │
│  └─ 更新版本檔案                                             │
├─────────────────────────────────────────────────────────────┤
│  Phase 3: 📝 文檔更新 (Documentation)                        │
│  ├─ [changelog-updater] 更新 CHANGELOG                      │
│  ├─ [readme-updater] 更新 README                            │
│  ├─ [roadmap-updater] 標記完成項目                          │
│  └─ 更新 API 文檔（如有）                                    │
├─────────────────────────────────────────────────────────────┤
│  Phase 4: 🏷️ 標籤準備 (Tagging)                             │
│  ├─ 建立 Git tag                                            │
│  ├─ 準備 release notes                                      │
│  └─ 確認變更摘要                                             │
├─────────────────────────────────────────────────────────────┤
│  Phase 5: 🚀 發布 (Publish)                                  │
│  ├─ 推送 tag                                                │
│  ├─ 建立 GitHub Release                                     │
│  └─ 觸發 CI/CD pipeline                                     │
├─────────────────────────────────────────────────────────────┤
│  Phase 6: 📢 發布後 (Post-release)                           │
│  ├─ 更新 Memory Bank                                        │
│  ├─ 通知相關人員                                             │
│  └─ 準備下一版本                                             │
└─────────────────────────────────────────────────────────────┘

🔢 版本號規則 (SemVer)

MAJOR.MINOR.PATCH

MAJOR: 不相容的 API 變更 (Breaking Changes)
MINOR: 向下相容的新功能 (New Features)
PATCH: 向下相容的 Bug 修復 (Bug Fixes)

版本號決定指南

🚀 使用範例

基本用法

「準備發布」

AI 執行：
1. 🔍 執行發布前檢查
2. 🔢 分析變更，建議版本號
3. 📝 更新 CHANGELOG、README、ROADMAP
4. 🏷️ 準備 Git tag
5. 📊 生成發布清單

指定版本

「REL: v2.0.0」

AI 執行：
1. 確認這是 MAJOR 版本（Breaking Changes）
2. 要求確認 breaking changes 清單
3. 執行完整發布流程

📊 輸出格式

## 📦 發布準備報告

### 版本資訊

- **當前版本**: 1.1.0
- **建議版本**: 1.2.0 (MINOR)
- **原因**: 新增 3 個功能，無 breaking changes

### 🔍 發布檢查

| 檢查項目 | 狀態 |
|----------|------|
| 測試通過 | ✅ 42/42 |
| 安全掃描 | ✅ 無風險 |
| Lint | ✅ 0 errors |
| 文檔同步 | ✅ 已更新 |

### 📝 變更摘要

#### Added
- 用戶認證模組
- API 限流功能
- 匯出功能

#### Fixed
- 登入超時問題
- 資料同步錯誤

#### Changed
- 改進錯誤訊息

### 📁 更新的文件

- ✅ CHANGELOG.md - 新增 v1.2.0 區塊
- ✅ README.md - 更新功能列表
- ✅ ROADMAP.md - 標記 3 個完成項目
- ✅ pyproject.toml - 版本號更新

### 🏷️ Git 指令

```bash
git add -A
git commit -m "chore: release v1.2.0"
git tag -a v1.2.0 -m "Release v1.2.0"
git push origin main --tags

📋 Release Notes

## v1.2.0 (2026-01-15)

### ✨ New Features
- 用戶認證模組
- API 限流功能
- 匯出功能

### 🐛 Bug Fixes
- 修復登入超時問題
- 修復資料同步錯誤

### 📖 Documentation
- 更新 API 文檔
- 新增使用範例

下一步

1. 確認變更摘要無誤
2. 執行上述 Git 指令
3. 在 GitHub 建立 Release

---

## ⚙️ 配置選項

| 參數 | 說明 | 預設值 |
|------|------|--------|
| `--dry-run` | 只預覽不執行 | false |
| `--skip-tests` | 跳過測試 | false |
| `--prerelease` | 預發布 (alpha/beta/rc) | false |
| `--force` | 強制指定版本 | false |