# 實施檢查清單

本文件提供 Vibe-Kanban 工作流程的實施檢查清單，確保所有組件都已正確實作。

---

## 檢查清單總覽

- [ ] Phase 1: 核心框架
- [ ] Phase 2: 設計階段技能
- [ ] Phase 3: 整合測試
- [ ] Phase 4: 優化

---

## Phase 1: 核心框架

### 1.1 主控技能 - vibe-kanban

```
skills/vibe-kanban/
├── SKILL.md                # 主技能定義
├── references/
│   └── workflow-diagram.md # 工作流程圖
└── templates/
    └── state-template.yaml # 狀態模板
```

#### SKILL.md 必須包含

- [ ] 階段定義
- [ ] 狀態機邏輯
- [ ] 階段轉換條件
- [ ] 退回機制
- [ ] 狀態持久化邏輯
- [ ] 進度報告格式
- [ ] 命令列表
  - [ ] `/vibe-kanban start`
  - [ ] `/vibe-kanban status`
  - [ ] `/vibe-kanban next`
  - [ ] `/vibe-kanban back`
  - [ ] `/vibe-kanban skip`

#### 狀態模板 state-template.yaml

- [ ] 專案名稱欄位
- [ ] 當前階段欄位
- [ ] 歷史記錄欄位
- [ ] 產出文件欄位
- [ ] 阻塞原因欄位
- [ ] 下一步動作欄位

### 1.2 PRD 技能 - pm-prd

```
skills/pm-prd/
├── SKILL.md
└── templates/
    └── prd-template.md
```

#### SKILL.md 必須包含

- [ ] 輸入格式定義
- [ ] 輸出格式定義
- [ ] 功能性需求模板
- [ ] 非功能性需求模板
- [ ] 驗收標準模板
- [ ] 優先級排序邏輯
- [ ] 人類審核流程

#### PRD 模板 prd-template.md

- [ ] Metadata 區塊
- [ ] 背景區塊
- [ ] 功能性需求區塊 (FR-001, FR-002, ...)
- [ ] 非功能性需求區塊 (NFR-001, NFR-002, ...)
- [ ] 驗收標準區塊 (AC-001, AC-002, ...)
- [ ] 排期建議區塊
- [ ] 依賴區塊
- [ ] 風險評估區塊

---

## Phase 2: 設計階段技能

### 2.1 API 設計技能 - be-api-design

```
skills/be-api-design/
├── SKILL.md
└── templates/
    └── openapi-template.yaml
```

#### SKILL.md 必須包含

- [ ] RESTful API 設計原則
- [ ] OpenAPI 3.0 規格產出
- [ ] 請求/回應 Schema 定義
- [ ] 錯誤處理設計
- [ ] 安全性考量清單
- [ ] 效能考量清單
- [ ] 人類審核流程

#### OpenAPI 模板 openapi-template.yaml

- [ ] info 區塊 (標題、版本、描述)
- [ ] paths 區塊 (端點定義)
- [ ] components/schemas 區塊 (資料模型)
- [ ] responses 區塊 (回應格式)
- [ ] securitySchemes 區塊 (安全機制)

### 2.2 資料庫設計技能- dba-schema

```
skills/dba-schema/
├── SKILL.md
└── templates/
    └── schema-template.sql
```

#### SKILL.md 必須包含

- [ ] 資料正規化原則
- [ ] 索引策略
- [ ] 外鍵關聯設計
- [ ] 遷移計畫格式
- [ ] 效能優化建議
- [ ] 人類審核流程

#### Schema 模板 schema-template.sql

- [ ] Migration 標頭
- [ ] Table 定義
- [ ] Index 定義
- [ ] Constraint 定義
- [ ] Trigger 定義
- [ ] Comment 定義

### 2.3 UX 原型技能 - ux-prototype

```
skills/ux-prototype/
├── SKILL.md
└── templates/
    ├── user-flow-template.md
    └── component-mapping-template.md
```

#### SKILL.md 必須包含

- [ ] 使用者流程圖產出
- [ ] 線框圖描述格式
- [ ] 元件與 API 對應邏輯
- [ ] 原型工具建議
- [ ] 人類審核流程

#### 使用者流程模板 user-flow-template.md

- [ ] Mermaid 流程圖
- [ ] 頁面清單表格
- [ ] 頁面 URL 對應

#### 元件對應模板 component-mapping-template.md

- [ ] 頁面元件列表
- [ ] 元件資料來源
- [ ] API 端點對應
- [ ] 快取策略建議

---

## Phase 3: 整合測試

### 3.1 端到端流程測試

- [ ] 測試案例 1: 完整流程從頭到尾
  - [Brainstorming → CEO Review → PRD → ... → Deploy]
- [ ] 測試案例 2: CEO 審核退回
  - [Brainstorming → CEO Review (失敗) → Brainstorming]
- [ ] 測試案例 3: QA 失敗退回
  - [所有階段 → QA (失敗) → Task Breakdown]
- [ ] 測試案例 4: PR 審核失敗退回
  - [所有階段 → PR Review (失敗) → Task Breakdown]

### 3.2 狀態持久化測試

- [ ] 測試狀態檔案建立
- [ ] 測試狀態檔案更新
- [ ] 測試狀態檔案恢復
- [ ] 測試狀態檔案損壞處理

### 3.3 退回機制測試

- [ ] 測試退回到上一階段
- [ ] 測試退回到特定階段
- [ ] 測試退回後的產出清理
- [ ] 測試退回後重新執行

### 3.4 併發測試

- [ ] 測試多專案併發執行
- [ ] 測試鎖機制
- [ ] 測試資源競爭

---

## Phase 4: 優化

### 4.1 效能優化

- [ ] 階段轉換時間優化
- [ ] 檔案讀寫優化
- [ ] 快取機制實作

### 4.2 錯誤處理優化

- [ ] 友善錯誤訊息
- [ ] 錯誤恢復機制
- [ ] 錯誤日誌記錄

### 4.3 使用者體驗優化

- [ ] 進度視覺化
- [ ] 預估時間顯示
- [ ] 歷史記錄瀏覽

### 4.4 文件完善

- [ ] 使用者指南
- [ ] 開發者文件
- [ ] API 文件
- [ ] 最佳實踐指南

---

## 測試矩陣

### 功能測試

| 功能 | 測試案例 | 預期結果 | 實際結果 | 狀態 |
|------|---------|---------|---------|------|
| 開始新專案 | 輸入專案名稱 | 建立狀態檔案 | | [ ] |
| 查看狀態 | 執行status | 顯示當前階段 | | [ ] |
| 前往下一階段 | 執行 next | 狀態更新 | | [ ] |
| 退回上一階段 | 執行 back | 狀態回滾 | | [ ] |
| 跳過階段 | 執行 skip | 狀態跳過 | | [ ] |

### 整合測試

| 整合點 | 測試案例 | 預期結果 | 實際結果 | 狀態 |
|--------|---------|---------|---------|------|
| PM → CEO | PRD 審核通過 | 進入 API 設計 | | [ ] |
| CEO 失敗 | PRD 審核失敗 | 退回Brainstorming | | [ ] |
| QA 失敗 | 測試不通過 | 退回 Task Breakdown | | [ ] |
| Deploy | 部署成功 | 專案完成 | | [ ] |

### 效能測試

| 指標 | 目標 | 實際 | 狀態 |
|------|------|------|------|
| 階段轉換時間 | < 5 秒 | | [ ] |
| 狀態載入時間 | < 1 秒 | | [ ] |
|檔案寫入時間 | < 2 秒 | | [ ] |

---

## 部署檢查清單

### 部署前

- [ ] 所有測試通過
- [ ] 文件完整
- [ ] 版本號更新
- [ ] CHANGELOG 更新

### 部署中

- [ ] 備份現有版本
- [ ] 部署新版本
- [ ] 驗證部署成功

### 部署後

- [ ] 監控錯誤日誌
- [ ] 驗證功能正常
- [ ] 更新使用文件

---

## 維護檢查清單

### 每週

- [ ] 檢查錯誤日誌
- [ ] 檢查效能指標
- [ ] 檢查使用者反饋

### 每月

- [ ] 更新技能版本
- [ ] 審核技術債
- [ ] 優化流程

### 每季

- [ ] 全面測試回歸
- [ ] 安全性審核
- [ ] 架構審核

---

## 簽核記錄

| 階段 | 審核人 | 日期 | 簽核 |
|------|-------|------|------|
| Phase 1 | | | [ ] |
| Phase 2 | | | [ ] |
| Phase 3 | | | [ ] |
| Phase 4 | | | [ ] |
| 最終審核 | | | [ ] |