pdca/.claude/commands/pdca.md

🎯 AI 驅動的 PDCA 多代理開發系統 - 智能循環控制 + 成本管理 + Token 優化 + 多 AI 引擎支援

---
allowed-tools: Read, Grep, Glob, LS, Bash(echo:*), Bash(cat:*), Bash(tmux:*)
description: PDCA 多代理系統 - 主入口
---

# 🎯 PDCA 多代理協作系統

## 📋 系統介紹

**PDCA** 是一個創新的多代理協作系統，透過並行運行 5 個獨立的 Claude CLI 實例來實現高效的軟體開發工作流程。

### 核心特性
- 🚀 **真正的多代理並行** - 5 個獨立的 Claude CLI 實例
- 🔄 **非同步協作** - 透過檔案系統進行智能通訊
- 📊 **即時監控** - TUI 介面追蹤所有代理狀態
- 🎨 **多風格支援** - 職人、敏捷、企業等多種工作模式

## 🎮 可用指令

### 核心指令
- `/pdca:start` - 🚀 啟動多代理系統
- `/pdca:status` - 📊 查看系統狀態
- `/pdca:monitor` - 🖥️ 開啟監控介面
- `/pdca:stop` - 🛑 停止所有代理

### 安全模式（舊版，保留相容性）
- `/pdca:safe` - 🟢 安全模式（只讀）
- `/pdca:standard` - 🟡 標準模式（開發）
- `/pdca:expert` - 🔴 專家模式（完整權限）
- `/pdca:custom` - 🔧 自定義模式

## 🚀 快速開始

### 1. 首次使用
如果尚未安裝 PDCA，請先在專案中安裝：
```bash
npm install pdca
```

### 2. 啟動系統
使用以下指令啟動多代理系統：
```
/pdca:start
```

### 3. 分配任務
系統啟動後，直接告訴我您的需求，例如：
- "幫我分析這個專案的架構"
- "實作使用者認證功能"
- "優化資料庫查詢效能"

### 4. 監控進度
隨時使用以下方式查看進度：
- `/pdca:monitor` - 查看 TUI 監控介面
- 直接切換到各代理視窗互動

## 🏗️ 系統架構

### 五大代理角色
1. **🎯 Plan** - 需求分析與策略規劃
2. **🎨 Do** - 程式碼實作與開發
3. **🔍 Check** - 品質檢查與測試
4. **🚀 Act** - 優化改進與部署
5. **📝 Knowledge** - 知識管理與文檔

### 協作模式
- **主代理（我）** - 任務協調與分配
- **子代理** - 專門領域的獨立執行
- **通訊機制** - 檔案系統 IPC
- **監控系統** - 即時狀態追蹤

## 💡 使用提示

### 最佳實踐
- 清晰描述您的任務需求
- 使用 `/pdca:monitor` 追蹤進度
- 必要時直接與特定代理互動
- 善用 Knowledge 代理累積專案知識

### 常見場景
- **新功能開發** - Plan 分析 → Do 實作 → Check 測試
- **程式碼重構** - Check 分析 → Act 優化 → Do 實施
- **問題除錯** - Check 診斷 → Plan 策略 → Do 修復
- **文檔更新** - Knowledge 整理 → Do 撰寫

## ❓ 需要幫助？

- 查看狀態：`/pdca:status`
- 停止系統：`/pdca:stop`
- 重新啟動：`/pdca:start`

---

**準備好了嗎？** 使用 `/pdca:start` 啟動您的智能開發團隊！