daniel.w
/
opencode-workflow
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
opencode-workflow/design-idea/VIBE_KANBAN_PLAN.md

1231 lines
37 KiB
Markdown
Raw Normal View History

add AGENTS
2026-04-08 23:53:15 +00:00
# Vibe-Kanban 工作流程規劃文件
**版本:** 1.0
**日期:** 2025-01-15
**狀態:** 規劃階段
---
## 概述
本文件定義一個完整的軟體開發工作流程，透過多個 AI 代理協作完成從需求探索到部署的完整生命週期。
---
## 目錄
1. [工作流程總覽](#1-工作流程總覽)
2. [現有技能映射](#2-現有技能映射)
3. [新建技能定義](#3-新建技能定義)
4. [主控技能設計](#4-主控技能設計)
5. [狀態機設計](#5-狀態機設計)
6. [文件結構規劃](#6-文件結構規劃)
7. [實施優先順序](#7-實施優先順序)
8. [退回機制設計](#8-退回機制設計)
9. [驗收標準模板](#9-驗收標準模板)
---
## 1. 工作流程總覽
```
┌─────────────────────────────────────────────────────────────────────────────┐
│ VIBE-KANBAN 工作流程 │
├─────────────────────────────────────────────────────────────────────────────┤
│ │
│ 階段1: 需求探索 │
│ ┌────────────┐ ┌────────────┐ │
│ │Brainstorm │ ──▶ │ CEO Review │ │
│ │ (PM) │ │ (商業價值) │ │
│ └────────────┘ └────────────┘ │
│ │ │ │
│ │ ┌────────────┘ │
│ ▼ ▼ │
│ 階段2: 規格設計 │
│ ┌────────────┐ ┌────────────┐ ┌────────────┐ ┌────────────┐ │
│ │ PRD │ ──▶ │ API Design │ ──▶ │ DB Schema │ ──▶ │ UX/原型 │ │
│ │ (PM) │ │ (後端) │ │ (DBA) │ │ (UX) │ │
│ └────────────┘ └────────────┘ └────────────┘ └────────────┘ │
│ │ │ │ │ │
│ └───────────────────┴───────────────────┴───────────────────┘ │
│ │ │
│ ▼ │
│ 階段3: 審核 ┌────────────┐ │
│ ┌────────────┐ │ Design │ │
│ │Design Review│ ◀────────────────────│ Review │ │
│ │ (通盤審核) │ │ (退回修改) │ │
│ └────────────┘ └────────────┘ │
│ │ │
│ │ 通過 │
│ ▼ │
│ 階段4: 任務拆分 │
│ ┌────────────────────────────────────────────────────────────────────┐ │
│ │ Task Breakdown │ │
│ │ (平行拆分前後端任務) │ │
│ └────────────────────────────────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ 階段5: 實作 │
│ ┌────────────┐ ┌────────────┐ │
│ │ Frontend │ │ Backend │ │
│ │implementation│ │implementation│ │
│ └────────────┘ └────────────┘ │
│ │ │ │
│ └─────────────────┬───────────────────┘ │
│ ▼ │
│ 階段6: 驗收 │
│ ┌────────────────────────────────────────────────────────────────────┐ │
│ │ QA Testing │ │
│ │ (依照驗收標準測試) │ │
│ │ (不通過 → 退回步驟4) │ │
│ └────────────────────────────────────────────────────────────────────┘ │
│ │ │
│ │ 通過 │
│ ▼ │
│ 階段7: 合併審核 │
│ ┌────────────────────────────────────────────────────────────────────┐ │
│ │ PR Review │ │
│ │ (人類驗證) │ │
│ │ (不通過 → 退回步驟4) │ │
│ └────────────────────────────────────────────────────────────────────┘ │
│ │ │
│ │ 通過 │
│ ▼ │
│ 階段8: 部署 │
│ ┌────────────────────────────────────────────────────────────────────┐ │
│ │ Deploy │ │
│ │ (OPS) │ │
│ └────────────────────────────────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌────────────┐ │
│ │ 完成 │ │
│ └────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────────────┘
```
---
## 2. 現有技能映射
### 2.1 可直接複用的技能
| 階段 | 技能名稱 | 檔案位置 | 用途 |
|------|---------|---------|------|
| 1. Brainstorming | `brainstorming` | `skills/brainstorming/` | PM 需求探索 |
| 1. CEO Review | `plan-ceo-review` | `gstack/plan-ceo-review/` | 商業價值審核 |
| 3. Design Review | `design-review` | `gstack/design-review/` | 視覺/架構審核 |
| 3. Design Review | `plan-design-review` | `gstack/plan-design-review/` | 設計計畫審核 |
| 4. Task Breakdown | `dispatching-parallel-agents` | `skills/dispatching-parallel-agents/` | 平行任務分配 |
| 4. Task Breakdown | `subagent-driven-development` | `skills/subagent-driven-development/` | 子代理驅動開發 |
| 5. Implementation | `writing-plans` | `skills/writing-plans/` | 撰寫實作計畫 |
| 6. QA | `qa` | `gstack/qa/` | QA 測試驗收 |
| 7. PR Review | `review` | `gstack/review/` | PR 代碼審核 |
| 7. PR Review | `requesting-code-review` | `skills/requesting-code-review/` | 請求代碼審核 |
| 8. Deploy | `land-and-deploy` | `gstack/land-and-deploy/` | 合併與部署 |
| 8. Deploy | `setup-deploy` | `gstack/setup-deploy/` | 部署配置 |
### 2.2 現有技能功能摘要
#### `brainstorming`
- 輸入: 使用者的初步想法
- 輸出: 設計文件
- 流程: 探索專案 → 提問澄清 → 提案 → 設計文件
#### `plan-ceo-review`
- 輸入: 設計文件或計畫
- 輸出: 審核報告 + 擴展建議
- 模式: SCOPE_EXPANSION, SELECTIVE_EXPANSION, HOLD_SCOPE, SCOPE_REDUCTION
- 檢查: 架構、錯誤處理、安全性、效能、測試、部署
#### `qa`
- 輸入: 驗收標準 + 測試 URL
- 輸出: QA 報告 + Bug 修复
- 流程: 探索 → 測試 → 文件化 → 修复 → 驗證
#### `land-and-deploy`
- 輸入: PR 編號
- 輸出: 部署報告
- 流程: 預檢查 → 合併 → 部署 → Canary 驗證
---
## 3. 新建技能定義
### 3.1 `pm-prd` - 產品需求文件技能
```yaml
---
name: pm-prd
description: "產品經理撰寫 PRD 和驗收標準。根據 brainstorming 輸出產出結構化的產品需求文件，包含功能性需求、非功能性需求、驗收標準。觸發時機：CEO 審核通過後。"
---
## 職責
PM 角色的AI 代理，負責：
1. 將 brainstorming 的想法轉化為結構化 PRD
2. 定義功能性需求
3. 定義非功能性需求- 效能、安全性、可用性等
4. 設定驗收標準
5. 優先順序排序
## 輸入
- Brainstorming 輸出文件
- CEO 審核結果
- 專案上下文 (CLAUDE.md, ARCHITECTURE.md 等現有文件)
## 輸出
- PRD 文件: `docs/prd/{YYYY-MM-DD}-{feature-slug}.md`
## PRD 模板結構
```markdown
# PRD: {功能名稱}
## Metadata
- 撰寫日期: {date}
- 狀態: Draft | Review | Approved
- 作者: PM Agent
- 關聯 Brainstorm: {link}
## 背景
### 問題陳述
### 目標使用者
### 商業價值
## 功能性需求
### FR-001: {需求標題}
- 描述:
- 優先級: P0 | P1 | P2
- 使用者故事: 作為{role}，我想要{action}，以便{benefit}
### FR-002: ...
## 非功能性需求
###NFR-001: 效能
- 描述: 頁面載入時間< 2秒
- 量測方式: ...
### NFR-002: 安全性
- 描述: 所有 API 需驗證
- 量測方式: ...
##驗收標準
### AC-001: {驗收項目}
- Given: 前置條件
- When: 觸發動作
- Then: 預期結果
- 自動化: 是/否
- 測試腳本: (連結到測試案例)
### AC-002: ...
## 排期建議
- Phase 1: ...
- Phase 2: ...
## 依賴
- 外部依賴: ...
- 內部依賴: ...
## 風險評估
- 風險: ...
- 緩解措施: ...
```
## 流程
```mermaid
graph TD
A[讀取 Brainstorming 文件] --> B[分析需求結構]
B --> C[產出功能性需求]
B --> D[產出非功能性需求]
C --> E[定義驗收標準]
D --> E
E --> F[優先級排序]
F --> G[風險評估]
G --> H[撰寫 PRD 文件]
H --> I[人類審核]
I -->|通過| J[進入下一階段]
I -->|修改| C
```
## 相依技能
- 前置: `brainstorming`, `plan-ceo-review`
- 後續: `be-api-design`, `dba-schema`, `ux-prototype`
```
---
### 3.2 `be-api-design` - API 設計技能
```yaml
---
name: be-api-design
description: "後端工程師設計 API 規格。根據 PRD 產出 OpenAPI 3.0 規格文件，包含端點、請求/回應結構、錯誤處理。觸發時機：PRD 審核通過後。"
---
## 職責
後端工程師角色的 AI 代理，負責：
1. 分析 PRD 中的功能性需求
2. 設計 RESTful API 端點
3. 定義請求/回應 schema
4. 設計錯誤處理機制
5. 考量 API 版本控制
6. 產出 OpenAPI 3.0 規格
## 輸入
- PRD 文件
- 現有 API 風格 (專案中現有的 API 規格)
- 資料模型上下文
## 輸出
- API 規格文件: `docs/api/{YYYY-MM-DD}-{feature-slug}.yaml`
## API 設計模板
```yaml
openapi: 3.0.3
info:
title: {API名稱}
version: 1.0.0
description: |
{API 描述}
相關 PRD: {PRD 連結}
paths:
/api/v1/{resource}:
get:
summary: {操作描述}
tags:
- {標籤}
parameters:
- name: {參數名}
in: query | path | header
required: true | false
schema:
type: string
responses:
'200':
description: 成功回應
content:
application/json:
schema:
$ref: '#/components/schemas/{Schema}'
'400':
description: 請求錯誤
'401':
description: 未授權
'500':
description: 伺服器錯誤
components:
schemas:
{SchemaName}:
type: object
properties:
{property}:
type: {type}
description: {描述}
required:
- {required_fields}
```
## 設計考量清單
### 安全性
- [ ] 所有端點都有適當的認證機制
- [ ] 輸入驗證
- [ ] 速率限制
- [ ] CORS 配置
### 效能
- [ ] 分頁支援
- [ ] 快取策略
- [ ] 批次操作支援
### 可靠性
- [ ] 錯誤回應格式統一
- [ ] 重試機制建議
- [ ] 冪等性設計
## 流程
```mermaid
graph TD
A[讀取 PRD] --> B[識別資源與操作]
B --> C[設計端點結構]
C --> D[定義 Schema]
D --> E[設計錯誤處理]
E --> F[安全性審查]
F --> G[效能考量]
G --> H[產出 OpenAPI 文件]
H --> I[人類審核]
I -->|通過| J[進入 DB 規劃]
I -->|修改| C
```
## 相依技能
- 前置: `pm-prd`
- 後續: `dba-schema`
```
---
### 3.3 `dba-schema` - 資料庫綱要技能
```yaml
---
name: dba-schema
description: "DBA 規劃資料庫綱要。根據 API 規格設計資料庫 schema，包含索引策略、遷移計畫、效能考量。觸發時機：API 設計完成後。"
---
## 職責
DBA 角色的 AI 代理，負責：
1. 分析 API 規格中的資料結構
2. 設計正規化的資料庫 schema
3. 規劃索引策略
4. 設計遷移計畫
5. 效能優化建議
## 輸入
- API 規格文件
- PRD 文件 (了解業務需求)
- 現有資料庫 schema (如有)
## 輸出
- Schema 文件: `docs/db/{YYYY-MM-DD}-{feature-slug}.sql`
- 遷移計畫: `docs/db/migrations/{version}-{description}.sql`
## Schema 設計模板
```sql
-- Migration: {feature_name}
-- Version: {version}
-- Date: {date}
-- Author: DBA Agent
-- Related API: {API規格連結}
-- ====== Tables ======
CREATE TABLE {table_name} (
idBIGSERIAL PRIMARY KEY,-- 效能考量
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
-- 業務欄位
{column_name} {type} {constraints},
-- ...
);
-- ====== Indexes ======
-- 主要查詢索引
CREATE INDEX idx_{table}_{column} ON {table_name} ({column});
-- 複合索引 (考量查詢模式)
CREATE INDEX idx_{table}_{columns} ON {table_name} ({column1}, {column2});
-- ======Constraints ======
-- 外鍵關聯
ALTER TABLE {table_name}
ADD CONSTRAINT fk_{relation}
FOREIGN KEY ({column})
REFERENCES {related_table}({related_column})
ON DELETE CASCADE;
-- ====== Triggers ======
-- 自動更新 updated_at
CREATE TRIGGER update_{table}_updated_at
BEFORE UPDATE ON {table_name}
FOR EACH ROW
EXECUTE FUNCTION update_updated_at_column();
-- ====== Comments ======
COMMENT ON TABLE {table_name} IS '{描述}';
COMMENT ON COLUMN {table_name}.{column} IS '{描述}';
```
## 設計原則
### 正規化
- 達到第三正規化 (3NF)
- 視查詢模式進行反正規化優化
### 索引策略
- 主鍵: 自動建立
- 外鍵: 視查詢頻率決定
- 常用篩選條件: 建立索引
- 複合索引: 依查詢模式設計
### 效能考量
- 大表分區策略
- 讀寫分離建議
- 連線池配置
## 流程
```mermaid
graph TD
A[讀取 API 規格] --> B[識別資料實體]
B --> C[設計資料表]
C --> D[定義關聯]
D --> E[規劃索引]
E --> F[遷移計畫]
F --> G[效能審查]
G --> H[產出 Schema 文件]
H --> I[人類審核]
I -->|通過| J[進入 UX 原型]
I -->|修改| C
```
## 相依技能
- 前置: `be-api-design`
- 後續: `ux-prototype`
```
---
### 3.4 `ux-prototype` - UX 原型技能
```yaml
---
name: ux-prototype
description: "UX 設計師產出原型設計。根據 PRD 和 API 規格設計使用者介面原型，整合 pancel.dev 或其他工具。觸發時機：API 和 DB 設計完成後。"
---
## 職責
UX 設計師角色的 AI 代理，負責：
1. 分析 PRD 中的使用者故事
2. 設計使用者流程
3. 產出線框圖
4. 設計互動原型
5. 確保設計與 API 規格對應
## 輸入
- PRD 文件
- API 規格文件
- DB Schema (了解資料結構)
## 輸出
- 設計文件: `docs/design/{YYYY-MM-DD}-{feature-slug}/`
- `user-flow.md` - 使用者流程
- `wireframes/` - 線框圖
- `prototype-link.md` - 原型連結
## 設計流程
### 1. 使用者流程圖
```markdown
# User Flow: {功能名稱}
## 流程圖
```mermaid
graph TD
A[登入頁面] --> B{已登入?}
B -->|是| C[首頁]
B -->|否| D[註冊/登入]
D --> E[填寫表單]
E --> F[提交]
F --> G{驗證成功?}
G -->|是| C
G -->|否| H[錯誤提示]
H --> D
```
## 頁面清單
| 頁面 | URL | 描述 | API 端點 |
|------|-----|------|----------|
| 登入 | /login | 使用者登入 | POST /api/v1/auth/login |
| 首頁 | / | 產品首頁 | GET /api/v1/dashboard |
```
### 2. 元件對應表
```markdown
# 元件與 API 對應
## 頁面: {page_name}
| 元件 | 資料來源 | API 端點 | 快取策略 |
|------|---------|---------|---------|
| 使用者列表 |Users API | GET /api/v1/users | SWR|
| 搜尋框 | Search API | GET /api/v1/search | Debounce |
```
### 3. 線框圖描述
使用文字描述關鍵頁面的線框圖：
```markdown
# Wireframe: {page_name}
## 佈局
```
┌─────────────────────────────────────────┐
│Header│
│ Logo Nav │ User │
├─────────────────────────────────────────┤
│ │
│ Main Content │
│ ┌─────────────────────────────────┐│
│ │ ││
│ │Content Area ││
│ │ ││
│ └─────────────────────────────────┘│
│ │
├─────────────────────────────────────────┤
│ Footer │
└─────────────────────────────────────────┘
```
## 元件清單
- Header: 導航列
- ContentArea: 主要內容區
- Footer: 頁尾
```
##原型工具建議
### 選項 1: pancel.dev
- 優點: 快速產出、AI 協助
- 適用: 快速原型、內部工具
### 選項 2: Figma
- 優點: 專業設計、協作
- 適用: 產品設計、客戶展示
### 選項 3: 文字描述 + HTML
- 優點: 版本控制、直接實作
- 適用: 技術團隊
## 流程
```mermaid
graph TD
A[讀取 PRD 和 API 規格] --> B[識別使用者故事]
B --> C[設計使用者流程]
C --> D[繪製線框圖]
D --> E[元件與 API 對應]
E --> F[產出原型]
F --> G[人類審核]
G -->|通過| H[進入 Design Review]
G -->|修改| D
```
## 相依技能
- 前置: `pm-prd`, `be-api-design`, `dba-schema`
- 後續: `design-review`
```
---
## 4. 主控技能設計
### 4.1 `vibe-kanban` 技能
```yaml
---
name: vibe-kanban
description: "完整的軟體開發工作流程協調器。管理從需求探索到部署的完整生命週期，支援階段間轉換、退回機制、狀態持久化。觸發方式：/vibe-kanban"
---
## 職責
工作流程的主控協調器，負責：
1. 狀態機管理 - 追蹤當前階段
2. 階段間轉換 - 自動觸發對應技能
3. 退回機制 - 處理審核不通過
4. 狀態持久化 - 儲存工作流進度
5. 進度報告 - 提供視覺化狀態
## 命令
- `/vibe-kanban start` - 開始新工作流
- `/vibe-kanban status` - 查看當前狀態
- `/vibe-kanban next` - 前往下一階段
- `/vibe-kanban back [reason]` - 退回上一階段
- `/vibe-kanban skip` - 跳過當前階段 (需確認)
## 狀態機
見 [第5節](#5-狀態機設計)
## 狀態持久化
```yaml
# .gstack/kanban/{project-slug}/state.yaml
version: 1.0
project: {project-name}
created_at: {ISO timestamp}
updated_at: {ISO timestamp}
current_phase: PRD
phase_status: IN_PROGRESS # PENDING | IN_PROGRESS | COMPLETED | BLOCKED
history:
- phase: BRAINSTORM
status: COMPLETED
started_at: 2025-01-15T10:00:00Z
completed_at: 2025-01-15T11:30:00Z
duration_minutes: 90
output: docs/brainstorm/2025-01-15-feature-x.md
triggered_skill: brainstorming
- phase: CEO_REVIEW
status: COMPLETED
started_at: 2025-01-15T11:30:00Z
completed_at: 2025-01-15T14:00:00Z
duration_minutes: 150
output: docs/ceo-review/2025-01-15-feature-x.md
triggered_skill: plan-ceo-review
notes: "通過，建議擴展範圍"
artifacts:
brainstorm: docs/brainstorm/2025-01-15-feature-x.md
prd: null # 待產出
api_spec: null
db_schema: null
ux_prototype: null
blockers: []
next_actions:
- "執行 /pm-prd 產出PRD"
```
## 階段轉換邏輯
```python
# 階段轉換條件
TRANSITIONS = {
"BRAINSTORM": {
"next": "CEO_REVIEW",
"skill": "brainstorming",
"required_artifacts": ["brainstorm.md"],
"auto_trigger": True
},
"CEO_REVIEW": {
"next": "PRD",
"skill": "plan-ceo-review",
"required_artifacts": ["ceo-review.md"],
"approval_required": True
},
"PRD": {
"next": "API_DESIGN",
"skill": "pm-prd",
"required_artifacts": ["prd.md"],
"approval_required": True
},
"API_DESIGN": {
"next": "DB_SCHEMA",
"skill": "be-api-design",
"required_artifacts": ["api-spec.yaml"],
"approval_required": True
},
"DB_SCHEMA": {
"next": "UX_PROTOTYPE",
"skill": "dba-schema",
"required_artifacts": ["schema.sql"],
"approval_required": True
},
"UX_PROTOTYPE": {
"next": "DESIGN_REVIEW",
"skill": "ux-prototype",
"required_artifacts": ["prototype/"],
"approval_required": True
},
"DESIGN_REVIEW": {
"next": "TASK_BREAKDOWN",
"skill": "design-review",
"required_artifacts": ["review-report.md"],
"approval_required": True,
"can_fail_back_to": "PRD"# 可退回到PRD 階段
},
"TASK_BREAKDOWN": {
"next": "IMPLEMENTATION",
"skill": "dispatching-parallel-agents",
"required_artifacts": ["tasks.md"],
"approval_required": False
},
"IMPLEMENTATION": {
"next": "QA",
"skill": None,# 手動實作
"required_artifacts": ["code/"],
"approval_required": False
},
"QA": {
"next": "PR_REVIEW",
"skill": "qa",
"required_artifacts": ["qa-report.md"],
"approval_required": False,
"can_fail_back_to": "TASK_BREAKDOWN" # QA不通過退回步驟四
},
"PR_REVIEW": {
"next": "DEPLOY",
"skill": "review",
"required_artifacts": ["pr-review.md"],
"approval_required": True,
"can_fail_back_to": "TASK_BREAKDOWN" # PR審核不通過退回步驟四
},
"DEPLOY": {
"next": "COMPLETED",
"skill": "land-and-deploy",
"required_artifacts": ["deploy-report.md"],
"approval_required": False
}
}
```
## 流程圖
```mermaid
stateDiagram-v2
[*] --> BRAINSTORM: /vibe-kanban start
BRAINSTORM --> CEO_REVIEW: 通過
CEO_REVIEW --> PRD: 通過
CEO_REVIEW --> BRAINSTORM: 退回修改
PRD --> API_DESIGN: 通過
PRD --> CEO_REVIEW: major changes
API_DESIGN --> DB_SCHEMA: 通過
API_DESIGN --> PRD: 需求不符
DB_SCHEMA --> UX_PROTOTYPE: 通過
DB_SCHEMA --> API_DESIGN: schema衝突
UX_PROTOTYPE --> DESIGN_REVIEW: 完成
UX_PROTOTYPE --> DB_SCHEMA: 資料結構不符
DESIGN_REVIEW --> TASK_BREAKDOWN: 通過
DESIGN_REVIEW --> PRD: 設計不符需求
TASK_BREAKDOWN --> IMPLEMENTATION: 任務拆分完成
IMPLEMENTATION --> QA: 實作完成
QA --> TASK_BREAKDOWN: 測試不通過
QA --> PR_REVIEW: 測試通過
PR_REVIEW --> DEPLOY: 審核通過
PR_REVIEW --> TASK_BREAKDOWN: 審核不通過
DEPLOY --> COMPLETED: 部署成功
DEPLOY --> IMPLEMENTATION: 部署失敗
COMPLETED --> [*]
```
## 進度報告
執行 `/vibe-kanban status` 時顯示：
```
╔══════════════════════════════════════════════════════════════╗
║ VIBE-KANBAN 狀態 ║
╠══════════════════════════════════════════════════════════════╣
║專案: feature-user-auth ║
║ 當前階段: PRD (撰寫產品需求文件) ║
║ 狀態: IN_PROGRESS ║
║ ║
║已完成階段: ║
║ ✅ BRAINSTORM (90 分鐘) ║
║ ✅ CEO_REVIEW (150 分鐘) ║
║ ║
║ 待完成階段: ║
║ ⏳ PRD ← 你在這裡 ║
║ ⬜ API_DESIGN ║
║ ⬜ DB_SCHEMA ║
║ ⬜ UX_PROTOTYPE ║
║ ⬜ DESIGN_REVIEW ║
║ ⬜ TASK_BREAKDOWN ║
║ ⬜ IMPLEMENTATION ║
║ ⬜ QA ║
║ ⬜ PR_REVIEW ║
║ ⬜ DEPLOY ║
║ ║
║產出文件: ║
║ docs/brainstorm/2025-01-15-feature-x.md✅ ║
║ docs/ceo-review/2025-01-15-feature-x.md ║
║ docs/prd/ (待產出) ║
║ ║
║ 下一步: 執行 /pm-prd 產出PRD ║
╚══════════════════════════════════════════════════════════════╝
```
```
---
## 5. 狀態機設計
### 5.1 階段定義
| 階段 | 名稱 | 觸發技能 | 輸入 | 輸出 | 失敗退回 |
|------|------|---------|------|------|---------|
| 1 | BRAINSTORM | brainstorming | 使用者想法 | brainstorm.md | - |
| 2 | CEO_REVIEW | plan-ceo-review | brainstorm.md | review-report.md |階段1 |
| 3 | PRD | pm-prd | review-report.md | prd.md | 階段2 |
| 4 | API_DESIGN | be-api-design | prd.md | api-spec.yaml | 階段3 |
| 5 | DB_SCHEMA | dba-schema | api-spec.yaml | schema.sql | 階段4 |
| 6 | UX_PROTOTYPE | ux-prototype | prd.md + api-spec.yaml + schema.sql | prototype/ | 階段5 |
| 7 | DESIGN_REVIEW | design-review | prototype/ | review-report.md | 階段3 |
| 8 | TASK_BREAKDOWN | dispatching-parallel-agents | tasks.md | task-assignments | 階段7 |
| 9 | IMPLEMENTATION | 手動 | task-assignments | code/ | 階段8 |
| 10 | QA | qa | code/ + acceptance-criteria | qa-report.md | 階段8 (步驟四) |
| 11 | PR_REVIEW | review | code/ | pr-review.md | 階段8 (步驟四) |
| 12 | DEPLOY | land-and-deploy | pr-approved | deploy-report.md | 階段9 |
### 5.2 退回邏輯
```python
#退回規則
ROLLBACK_RULES = {
"QA_FAILED": {
"from_phase": "QA",
"to_phase": "TASK_BREAKDOWN",
"reason": "測試不通過，需要重新實作"
},
"PR_REVIEW_FAILED": {
"from_phase": "PR_REVIEW",
"to_phase": "TASK_BREAKDOWN",
"reason": "代碼審核不通過，需要修改"
},
"DESIGN_REVIEW_FAILED": {
"from_phase": "DESIGN_REVIEW",
"to_phase": "PRD",
"reason": "設計審核不通過，需求需要調整"
},
"DEPLOY_FAILED": {
"from_phase": "DEPLOY",
"to_phase": "IMPLEMENTATION",
"reason": "部署失敗，需要修復"
}
}
```
---
## 6. 文件結構規劃
```
.gstack/
└── kanban/
└── {project-slug}/
├── state.yaml# 工作流狀態
├── history/
│ ├── brainstorm-{date}.md│ ├── ceo-review-{date}.md
│ ├── prd-{date}.md
│ └── ...
└── artifacts/
├── prd/
├── api/
├── db/
└── design/
docs/
├── brainstorm/
│ └── {date}-{feature}.md
├── prd/
│ └── {date}-{feature}.md
├── api/
│ └── {date}-{feature}.yaml
├── db/
│ ├── {date}-{feature}.sql│ └── migrations/
│ └── {version}-{description}.sql
├── design/
│ └── {date}-{feature}/
│ ├── user-flow.md
│ ├── wireframes/
│ └── prototype-link.md
├── qa/
│ └── qa-report-{date}.md
└── deploy/
└── deploy-report-{date}.md
skills/
├── vibe-kanban/
│ ├── SKILL.md
│ ├── references/
│ │ └── workflow-diagram.md
│ └── templates/
│ └── state-template.yaml
├── pm-prd/
│ ├── SKILL.md
│ └── templates/
│ └── prd-template.md
├── be-api-design/
│ ├── SKILL.md
│ └── templates/
│ └── openapi-template.yaml
├── dba-schema/
│ ├── SKILL.md
│ └── templates/
│ └── schema-template.sql
└── ux-prototype/
├── SKILL.md
└── templates/
├── user-flow-template.md
└── component-mapping-template.md
```
---
## 7. 實施優先順序
### Phase 1: 核心框架 (Week 1)
1. **vibe-kanban 主控技能** - 最高優先級
- 狀態機核心邏輯
- 狀態持久化
- 階段轉換
2. **pm-prd 技能** - 高優先級
- PRD 模板
- 驗收標準定義
### Phase 2: 設計階段 (Week 2)
3. **be-api-design 技能** - 中優先級
- API 規格產出
- OpenAPI 模板
4. **dba-schema 技能** - 中優先級
- Schema 設計
- 遷移計畫
5. **ux-prototype 技能** - 中優先級
- 使用者流程
- 元件對應
### Phase 3: 整合測試 (Week 3)
6. **整合測試**
- 完整流程演練
- 邊界條件測試
- 退回機制測試
### Phase 4: 優化 (Week 4)
7. **性能優化**
- 並行執行優化
- 快取策略
8. **文件完善**
- 使用指南
- 最佳實踐
---
## 8. 退回機制設計
### 8.1 退回觸發條件
```yaml
# 退回觸發條件定義
ROLLBACK_TRIGGERS:
QA:
conditions:
- 測試覆蓋率< 80%
-關鍵功能測試失敗
- 效能未達標
target_phase: TASK_BREAKDOWN
message: "QA 測試未通過，需要返回任務拆分階段重新實作"
PR_REVIEW:
conditions:
- 代碼審核拒絕
- 安全漏洞發現
- 架構問題
target_phase: TASK_BREAKDOWN
message: "PR 審核未通過，需要返回任務拆分階段修改"
DESIGN_REVIEW:
conditions:
- 設計與需求不符
- UX 問題嚴重
- 技術不可行
target_phase: PRD
message: "設計審核未通過，需要返回 PRD 階段重新定義需求"
```
### 8.2 退回後處理
```yaml
# 退回後的處理流程
ROLLBACK_PROCESS:
steps:
- name: "記錄退回原因"action: "write_to_history"
data:
phase: "{from_phase}"
reason: "{reason}"
timestamp: "{ISO timestamp}"
- name: "通知相關代理"
action: "notify_agents"
agents:
- "PM (if phase <= PRD)"
- "Backend (if phase > PRD)"
- "UX (if phase >= UX_PROTOTYPE)"
- name: "清理階段產出"
action: "archive_artifacts"
target: "{current_phase}"
- name: "恢復到目標階段"
action: "restore_state"
target_phase: "{target_phase}"
- name: "重新開始"
action: "trigger_skill"
skill: "{target_skill}"
```
---
## 9. 驗收標準模板
### 9.1 通用驗收標準
```markdown
#驗收標準模板
## AC-001: {驗收項目名稱}
### Given (前置條件)
- 條件 1
- 條件 2
### When (觸發動作)
- 動作描述
### Then (預期結果)
- 結果 1
- 結果 2
### 測試資訊
- **優先級**: P0 | P1 | P2
- **類型**: 功能性 | 非功能性
- **自動化**: 是 | 否
- **測試腳本**: `tests/{test-file}`
---
## 驗收標準範例
### AC-001: 使用者登入功能
#### Given
- 使用者已註冊帳號
- 登入頁面已載入
#### When
- 使用者輸入正確的 email 和密碼
- 使用者點擊「登入」按鈕
#### Then
- 系統驗證帳號密碼
- 使用者被導向首頁
- Session 被建立
#### 測試資訊
- **優先級**: P0
- **類型**: 功能性
- **自動化**: 是
- **測試腳本**: `tests/auth/login.test.ts`
```
### 9.2 非功能性驗收標準
```markdown
# 非功能性驗收標準
##NFR-001: 效能
### 頁面載入時間
-首頁載入 < 2 秒 (P95)
- API 回應 < 500ms (P95)
### 測試方法
- 使用 Lighthouse 測量
- 使用 k6 進行負載測試
---
##NFR-002: 安全性
### 認證與授權
- 所有 API 端點需驗證
- 實作 RBAC (Role-Based Access Control)
### 測試方法
- OWASP ZAP 掃描
- 滲透測試
---
##NFR-003: 可用性
### 正常運行時間
- 99.9% SLA
- 計畫性維護除外
### 測試方法
- 監控系統日誌
- Uptime 監控
```
---
## 附錄
### A. 相關文件連結
- Brainstorming 技能: `/skills/brainstorming/SKILL.md`
- CEO Review 技能: `/gstack/plan-ceo-review/SKILL.md`
- QA 技能: `/gstack/qa/SKILL.md`
- Land and Deploy 技能: `/gstack/land-and-deploy/SKILL.md`
### B. 參考資料
- OpenAPI 規格: https://spec.openapis.org/oas/v3.1.0
- Gherkin 語法: https://cucumber.io/docs/gherkin/
- 12-Factor App: https://12factor.net/
### C. 版本歷史
| 版本 | 日期 | 變更 |
|------|------|------|
| 1.0 | 2025-01-15 | 初版規劃文件 |