322 lines
6.5 KiB
Markdown
322 lines
6.5 KiB
Markdown
|
# 實施檢查清單
|
||
|
|
|
||
|
|
本文件提供 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 | | | [ ] |
|
||
|
|
| 最終審核 | | | [ ] |
|