speccrew 0.5.19 → 0.6.1

package/docs/GETTING-STARTED.zh-TW.md

@@ -146,13 +146,15 @@ flowchart LR
     PRD[階段一<br/>需求分析<br/>Product Manager] --> FD[階段二<br/>功能設計<br/>Feature Designer]
     FD --> SD[階段三<br/>系統設計<br/>System Designer]
     SD --> DEV[階段四<br/>開發實現<br/>System Developer]
-    DEV --> TEST[階段五<br/>系統測試<br/>Test Manager]
-    TEST --> ARCHIVE[階段六<br/>歸檔]
+    DEV --> DEPLOY[階段五<br/>部署實施<br/>System Deployer]
+    DEPLOY --> TEST[階段六<br/>系統測試<br/>Test Manager]
+    TEST --> ARCHIVE[階段七<br/>歸檔]
     
     KB[(知識庫<br/>貫穿始終)] -.-> PRD
     KB -.-> FD
     KB -.-> SD
     KB -.-> DEV
+    KB -.-> DEPLOY
     KB -.-> TEST
 ```
 
@@ -332,14 +334,49 @@ iterations/{iter}/04.development/
 
 ---
 
-### 7.5 階段五:系統測試(Test Manager)
+### 7.5 階段五：部署實施（System Deployer）
 
-**如何啟動**:
+**如何啟動**：
+
+```
+@speccrew-system-deployer 開始部署
+```
+
+**Agent 工作流程**：
+1. 驗證開發階段已完成（Stage Gate）
+2. 加載技術知識庫（構建配置、資料庫遷移配置、服務啟動命令）
+3. **Checkpoint**：環境預檢 — 驗證構建工具、運行時版本、依賴可用性
+4. 按順序執行部署技能：構建（Build）→ 資料庫遷移（Migrate）→ 服務啟動（Startup）→ 煙霧測試（Smoke Test）
+5. 輸出部署報告
+
+> 💡 **提示**：對於無資料庫的專案，遷移步驟會自動跳過；對於客戶端應用（桌面/行動端），會使用程序驗證模式替代 HTTP 健康檢查。
+
+**產出物**：
+
+```
+iterations/{iter}/05.deployment/
+├── {platform-id}/
+│   ├── deployment-plan.md          # 部署計劃
+│   └── deployment-log.md           # 部署執行日誌
+└── deployment-report.md            # 部署完成報告
+```
+
+**確認要點**：
+- [ ] 構建是否成功完成
+- [ ] 資料庫遷移腳本是否全部執行成功（如適用）
+- [ ] 應用是否正常啟動並通過健康檢查
+- [ ] 煙霧測試是否全部通過
+
+---
+
+### 7.6 階段六：系統測試（Test Manager）
+
+**如何啟動**：
 ```
 @speccrew-test-manager 開始測試
 ```
 
-**三階段測試流程**:
+**三階段測試流程**：
 
 | 階段 | 說明 | Checkpoint |
 |------|------|------------|
@@ -347,9 +384,9 @@ iterations/{iter}/04.development/
 | 測試程式碼生成 | 生成可執行的測試程式碼 | B:展示生成的測試檔案和用例映射,等待使用者確認 |
 | 測試執行與 Bug 報告 | 自動執行測試,生成報告 | 無(自動執行) |
 
-**產出物**:
+**產出物**：
 ```
-iterations/{iter}/05.system-test/
+iterations/{iter}/06.system-test/
 ├── cases/
 │   └── {platform-id}/              # 測試用例文檔
 ├── code/
@@ -360,14 +397,14 @@ iterations/{iter}/05.system-test/
     └── BUG-{id}-{title}.md         # Bug 報告(每個 Bug 一個檔案)
 ```
 
-**確認要點**:
+**確認要點**：
 - [ ] 用例覆蓋是否完整
 - [ ] 測試程式碼是否可運行
 - [ ] Bug 嚴重程度判定是否準確
 
 ---
 
-### 7.6 階段六:歸檔
+### 7.7 階段七：歸檔
 
 迭代完成後自動歸檔:
 
@@ -378,7 +415,8 @@ speccrew-workspace/iteration-archives/
     ├── 02.feature-design/
     ├── 03.system-design/
     ├── 04.development/
-    └── 05.system-test/
+    ├── 05.deployment/
+    └── 06.system-test/
 ```
 
 ---
@@ -469,7 +507,8 @@ Pipeline Status: i001-user-management
   02 Feature Design: 🔄 In Progress (Checkpoint A passed)
   03 System Design:  ⏳ Pending
   04 Development:    ⏳ Pending
-  05 System Test:    ⏳ Pending
+  05 Deployment:     ⏳ Pending
+  06 System Test:    ⏳ Pending
 ```
 
 ### 9.5 向下相容
@@ -565,6 +604,7 @@ npm install -g speccrew@0.5.6
 | 功能設計 | Feature Designer | `@speccrew-feature-designer 開始功能設計` |
 | 系統設計 | System Designer | `@speccrew-system-designer 開始系統設計` |
 | 開發實現 | System Developer | `@speccrew-system-developer 開始開發` |
+| 部署實施 | System Deployer | `@speccrew-system-deployer 開始部署` |
 | 系統測試 | Test Manager | `@speccrew-test-manager 開始測試` |
 
 ### Checkpoint 檢查清單
@@ -575,6 +615,7 @@ npm install -g speccrew@0.5.6
 | 功能設計 | 1 | 場景覆蓋、交互清晰度、資料完整性、異常處理 |
 | 系統設計 | 2 | A: 框架評估;B: 偽程式碼語法、跨端一致性、錯誤處理 |
 | 開發實現 | 1 | A: 環境就緒、集成問題、程式碼規約 |
+| 部署實施 | 1 | 構建成功、遷移完成、服務啟動、煙霧測試通過 |
 | 系統測試 | 2 | A: 用例覆蓋;B: 測試程式碼可運行性 |
 
 ### 產出物路徑速查
@@ -585,7 +626,8 @@ npm install -g speccrew@0.5.6
 | 功能設計 | `iterations/{iter}/02.feature-design/` | `[name]-feature-spec.md` |
 | 系統設計 | `iterations/{iter}/03.system-design/` | `DESIGN-OVERVIEW.md`, `{platform}/INDEX.md`, `{platform}/{module}-design.md` |
 | 開發實現 | `iterations/{iter}/04.development/` | 源程式碼 + `delivery-report.md` |
-| 系統測試 | `iterations/{iter}/05.system-test/` | `cases/`, `code/`, `reports/`, `bugs/` |
+| 部署實施 | `iterations/{iter}/05.deployment/` | `deployment-plan.md`, `deployment-log.md`, `deployment-report.md` |
+| 系統測試 | `iterations/{iter}/06.system-test/` | `cases/`, `code/`, `reports/`, `bugs/` |
 | 歸檔 | `iteration-archives/{iter}-{date}/` | 完整迭代副本 |
 
 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "speccrew",
-  "version": "0.5.19",
+  "version": "0.6.1",
   "description": "Spec-Driven Development toolkit for AI-powered IDEs",
   "author": "charlesmu99",
   "repository": {

package/workspace-template/docs/solutions/agent-knowledge-map.md

@@ -180,8 +180,8 @@ Backend Designer Agent:
 
 | Deliverable | Path | Format | Description |
 |-------------|------|--------|-------------|
-| Test Case Document | `iterations/iXXX/05.tests/cases/[feature-name]-test-cases.md` | Per template | Includes acceptance and unit tests |
-| Test Report | `iterations/iXXX/05.tests/reports/[feature-name]-test-report.md` | Structured report | Includes pass rate, failure details |
+| Test Case Document | `iterations/iXXX/06.system-test/cases/[feature-name]-test-cases.md` | Per template | Includes acceptance and unit tests |
+| Test Report | `iterations/iXXX/06.system-test/reports/[feature-name]-test-report.md` | Structured report | Includes pass rate, failure details |
 
 ---
 
@@ -204,7 +204,8 @@ knowledge/                          iterations/iXXX/
 │                                         ├── 04.development/
 │                                         │ ├── {platform_id}/ ←── Dev Agent output (frontend/backend/mobile/desktop)
 │                Dev Agent                              │
-│                                         └── 05.tests/
+│                                         ├── 05.deployment/
+│                                         └── 06.system-test/
 └── techs/conventions/testing.md        ├── cases/    ←── Test Agent output
                    Test Agent ────────────────── └── reports/
 ```

package/workspace-template/docs/solutions/workspace-structure.md

@@ -20,8 +20,9 @@ SpecCrew-workspace/
 │       ├── 03.system-design/      # 系统设计
 │       ├── 04.development/        # 开发阶段
 │       │   └── tech-debt/         # 技术债记录（统一目录）
-│       ├── 05.test/               # 测试阶段
-│       └── 06.delivery/           # 交付阶段
+│       ├── 05.deployment/         # 部署阶段
+│       ├── 06.system-test/        # 系统测试阶段
+│       └── 07.delivery/           # 交付阶段
 │
 ├── iteration-archives/            # 迭代归档
 │   └── {序号}-{类型}-{名称}-{日期}/  # 如 001-feature-order-20260322
@@ -85,8 +86,9 @@ iterations/
 │   ├── 03.system-design/          # 系统设计
 │   ├── 04.development/            # 开发阶段
 │   │   └── tech-debt/             # 技术债记录（统一目录）
-│   ├── 05.test/                   # 测试阶段
-│   └── 06.delivery/               # 交付阶段
+│   ├── 05.deployment/             # 部署阶段
+│   ├── 06.system-test/            # 系统测试阶段
+│   └── 07.delivery/               # 交付阶段
 │
 └── 002-bugfix-payment/            # 支付修复迭代（后启动）
     └── ...
@@ -101,7 +103,8 @@ iterations/
 | 特性设计 | `02.feature-design/` | 特性规格、API 契约、交互设计 |
 | 系统设计 | `03.system-design/` | 详细设计、数据库设计、接口设计 |
 | 开发 | `04.development/` | 代码实现、开发日志、技术债记录 |
-| 测试 | `05.test/` | 测试用例、测试报告 |
+| 部署 | `05.deployment/` | 部署配置、部署日志 |
+| 系统测试 | `06.system-test/` | 测试用例、测试报告 |
 
 #### Stage 4 详细目录结构 (`04.development/`)
 
@@ -117,7 +120,62 @@ iterations/
 
 > ⚠️ **MANDATORY**: All Stage 4 outputs MUST use `04.development/` as the top-level directory.
 > The following variants are **FORBIDDEN**: `04.dev-report/`, `04.dev-reports/`, `04.implementation/`, or any other `04.*` name.
-| 交付 | `06.delivery/` | 部署文档、验收报告、交付清单 |
+
+#### Stage 5 详细目录结构 (`05.deployment/`)
+
+```
+05.deployment/
+├── .checkpoints.json                  # Stage progress checkpoints
+├── DISPATCH-PROGRESS.json             # Task dispatch and execution tracking
+├── {platform_id}/                     # Grouped by platform
+│   ├── deployment-plan.md             # Deployment plan for platform
+│   └── deployment-log.md              # Deployment execution log
+└── delivery-report.md                 # Deployment completion report
+```
+
+#### Stage 6 详细目录结构 (`06.system-test/`)
+
+```
+06.system-test/
+├── .checkpoints.json                  # Stage progress checkpoints
+├── DISPATCH-PROGRESS.json             # Task dispatch and execution tracking
+├── cases/                             # Test case documents
+│   └── {platform_id}/
+│       └── [feature]-test-cases.md
+├── code/                              # Test code plans
+│   └── {platform_id}/
+│       └── [feature]-test-code-plan.md
+├── results/                           # Test execution results
+│   └── {platform_id}/
+│       └── [feature]-test-execution-results.md
+├── reports/                           # Test reports
+│   └── [feature]-test-report.md
+└── bugs/                              # Bug reports
+    └── [feature]-bug-{序号}.md
+```
+
+#### Stage 7 详细目录结构 (`07.delivery/`)
+
+```
+07.delivery/
+├── .checkpoints.json                  # Stage progress checkpoints
+├── deployment-guide.md                # Deployment guide
+├── acceptance-report.md               # Acceptance report
+└── delivery-checklist.md              # Delivery checklist
+```
+
+**迭代阶段说明**：
+
+| 阶段 | 目录 | 说明 |
+|------|------|------|
+| 原始需求 | `00.docs/` | 用户需求的原始文档，保持原样 |
+| 产品需求 | `01.product-requirement/` | 产品需求文档，需求分析和规格说明 |
+| 特性设计 | `02.feature-design/` | 特性规格、API 契约、交互设计 |
+| 系统设计 | `03.system-design/` | 详细设计、数据库设计、接口设计 |
+| 开发 | `04.development/` | 代码实现、开发日志、技术债记录 |
+| 部署 | `05.deployment/` | 部署配置、部署日志 |
+| 系统测试 | `06.system-test/` | 测试用例、测试报告 |
+| 交付 | `07.delivery/` | 部署文档、验收报告、交付清单 |
 ```
 
 **迭代命名规范**：
@@ -330,4 +388,4 @@ techs/
 1. **迭代与知识分离**：`iterations/` 存放单次迭代产出，`knowledges/` 存放跨迭代共享知识
 2. **元数据集中管理**：诊断报告、同步状态统一放在 `knowledges/base/`
 3. **架构知识合并**：架构约定合并到 `techs/{platform}/architecture.md`，减少目录层级
-4. **阶段目录有序**：迭代阶段使用数字前缀（00.docs ~ 06.delivery），便于排序和理解
+4. **阶段目录有序**：迭代阶段使用数字前缀（00.docs ~ 07.delivery），便于排序和理解