kenaz 0.3.21 → 0.3.23

package/core/dev/pipeline/README.md

@@ -1,210 +0,0 @@
-# Pipeline System - ⚠️ LEGACY SYSTEM
-# 任務管理與執行系統
-
-> **⚠️ 注意：此系統處於遷移階段，建議新開發使用 [`.collaboration/` 新任務系統](../../.system/collaboration/README.md)**
-
----
-
-## ⚠️ Legacy System 提示
-
-**此系統處於遷移階段**：
-- ✅ **仍可使用**：排程器與 Multi-Agent 並行開發場景
-- ⚠️ **功能凍結**：不再新增特性，僅 Bug 修復
-- 🔄 **推薦遷移**：手動協作、簡單任務請使用 `.collaboration/` 新系統
-
-**查詢任務時必須兩邊都查**：
-```bash
-# 新系統查詢
-node .collaboration/core/task-api.js get TASK_XXX
-
-# 舊系統查詢（此系統）
-cat dev/pipeline/TASK_QUEUE.json
-ls dev/pipeline/completed/TASK_XXX_*.yaml
-```
-
-**詳細對比與遷移指引**：
-- 📖 [新舊系統差異對照](../../.system/collaboration/README.md#詳細差異對照)
-- 📖 [遷移路線圖](../../.system/collaboration/README.md#遷移方向)
-- 📖 [舊系統完整文檔](../../.system/pipeline/README.md)
-
----
-
-## 🚀 快速開始
-
-### 什麼是 Pipeline？
-
-Pipeline 是 KenazAI 的任務管理與執行系統，支援：
-
-- ✅ **任務拆分** - 將大功能拆為 15-20 分鐘的小任務
-- ✅ **依賴管理** - 自動處理任務間依賴關係
-- ✅ **並行執行** - 無衝突任務自動並行，提升效率
-- ✅ **Team 協作** - Leader + Workers 團隊模式
-- ✅ **自動化** - 任務完成後自動更新、啟動下一個
-
-### 目錄結構
-
-```
-dev/pipeline/
-├── README.md               # 📄 本文檔（快速開始）
-├── WORKFLOW_GUIDE.md       # 📘 完整使用指南 ⭐
-├── PROGRESS.md             # 📊 進度追蹤
-├── TASK_QUEUE.json         # 🗂️ 任務佇列
-├── PIPELINE_CONFIG.json    # ⚙️ 配置
-├── tasks/                  # 📋 待處理任務
-├── completed/              # ✅ 已完成任務
-└── logs/                   # 📝 執行日誌
-```
-
----
-
-## 📖 完整文檔
-
-**想了解完整工作流程？請閱讀**：
-
-👉 **[WORKFLOW_GUIDE.md](./WORKFLOW_GUIDE.md)** - 完整使用指南
-
-包含內容：
-- 🎯 核心概念（任務粒度、agent_type、依賴管理）
-- 📋 完整工作流程（Lead Agent 12 步 + Worker Agent 流程）
-- 📝 任務卡 YAML 模板（可直接複製使用）
-- 💡 3 個實際範例（簡單 / 複雜 / 並行任務）
-- ✅ 最佳實踐（任務拆分、agent_type 選擇、依賴管理）
-- ❓ 常見問題 FAQ（5 個常見問題與解答）
-- 📚 參考文檔（規則索引 PPL-101 至 PPL-112）
-
----
-
-## 🎯 核心概念（快速版）
-
-### 1. 任務粒度
-
-**標準**：每個任務 15-20 分鐘可完成。
-
-```yaml
-# ✅ 適當粒度
-estimated_hours: 0.33  # 20 分鐘
-```
-
-### 2. agent_type 選擇
-
-**預設使用 Team 模式**：
-
-```yaml
-agent_type: "developer_team"  # 推薦 ⭐
-```
-
-只在極簡單任務（< 10 分鐘）時使用單一 Agent：
-
-```yaml
-agent_type: "developer"  # 簡單任務
-```
-
-### 3. 依賴管理
-
-```yaml
-# 無依賴 → 立即執行
-dependencies: []
-
-# 有依賴 → 等待完成
-dependencies: ["TASK_147"]
-```
-
-### 4. 並行執行
-
-**條件**：無依賴 + 無路徑衝突
-
-```yaml
-# 可並行
-TASK_A: scope_paths: ["CLAUDE.md"]
-TASK_B: scope_paths: ["docs/workflows/"]
-```
-
----
-
-## 📋 任務卡快速模板
-
-```yaml
-id: "TASK_XXX"
-title: "任務標題"
-description: "詳細描述"
-priority: "P1"  # P0/P1/P2/P3
-status: "pending"
-agent_type: "developer_team"  # 推薦使用 Team 模式
-source: "F-XXX"
-feature_ids: ["F-XXX"]
-dependencies: []
-scope_paths:
-  - "路徑/文件"
-requirements:
-  - "需求 1"
-acceptance_criteria:
-  - "驗收標準 1"
-estimated_hours: 0.33
-complexity: "simple"
-```
-
-完整模板與說明：[WORKFLOW_GUIDE.md - 任務卡模板](./WORKFLOW_GUIDE.md#任務卡模板)
-
----
-
-## 🔧 常用命令
-
-### 查看進度
-
-```bash
-# 查看當前進度
-cat dev/pipeline/PROGRESS.md
-```
-
-### 查看任務佇列
-
-```bash
-# 查看任務佇列
-cat dev/pipeline/TASK_QUEUE.json
-```
-
----
-
-## 📚 相關文檔
-
-| 文檔 | 說明 |
-|------|------|
-| **[WORKFLOW_GUIDE.md](./WORKFLOW_GUIDE.md)** | 完整使用指南（必讀）⭐ |
-| **[PROGRESS.md](./PROGRESS.md)** | 進度追蹤 |
-| **[.rule/pipeline/task-execution.yaml](../../.rule/pipeline/task-execution.yaml)** | Pipeline 執行規則（PPL-101 至 PPL-112） |
-| **[CLAUDE.md](../../CLAUDE.md)** | Lead Agent 12 步開發流程 |
-
----
-
-## ❓ 常見問題（快速版）
-
-### Q: 如何決定任務拆分粒度？
-
-**A**: 使用「15-20 分鐘規則」。每個任務應在 15-20 分鐘內完成。
-
-### Q: 何時使用 Team 模式？
-
-**A**: **預設使用 Team 模式**（`developer_team`），只在極簡單任務（< 10 分鐘）時使用單一 Agent。
-
-### Q: 如何處理任務失敗？
-
-**A**: 立即停止、記錄失敗、更新狀態為 `blocked`、通知 Leader。不可靜默失敗。
-
-**完整 FAQ**：[WORKFLOW_GUIDE.md - 常見問題 FAQ](./WORKFLOW_GUIDE.md#常見問題-faq)
-
----
-
-## 🎓 學習路徑
-
-1. **快速入門** - 閱讀本 README（5 分鐘）
-2. **深入了解** - 閱讀 [WORKFLOW_GUIDE.md](./WORKFLOW_GUIDE.md)（20 分鐘）
-3. **查看範例** - [WORKFLOW_GUIDE.md - 實際範例](./WORKFLOW_GUIDE.md#實際範例)（10 分鐘）
-4. **實際操作** - 建立第一個任務卡（15 分鐘）
-5. **查閱規則** - [.rule/pipeline/task-execution.yaml](../../.rule/pipeline/task-execution.yaml)（按需）
-
----
-
-**版本**: 1.0.0
-**最後更新**: 2026-02-09
-**維護者**: Developer Team
-**相關任務**: TASK_147, TASK_148, TASK_149, TASK_150