Multi-Agent Tasks v3.2.0

計劃分解 → DAG 驗證 → TDD 對應 → 可執行任務清單

Claude Code Tasks 整合

v3.2.0 支援原生 Tasks API，實現跨 session 任務協作

本 Skill 可使用 Claude Code 原生 Tasks 系統：

# 建立任務（自動生成 taskId）
TaskCreate({ subject: "實作登入功能", description: "..." })

# 設定依賴關係
TaskUpdate({ taskId: "2", addBlockedBy: ["1"] })

# 跨 session 共享
export CLAUDE_CODE_TASK_LIST_ID=my-workflow

優勢：

• 跨 session 持久化
• 多 Agent 協作同一任務清單
• 自動依賴解除（完成時自動 unblock 下游任務）

使用方式

/multi-tasks [計劃路徑]
/multi-tasks .claude/memory/plans/user-auth/implementation-plan.md

Flags: --from-plan ID | --validate-only | --no-tdd-check

預設 4 視角

→ 模型路由配置：[shared/config/model-routing.yaml](_shared/config/model-routing.yaml)

執行流程

Phase 0: 載入計劃 → 解析 implementation-plan.md
    ↓
Phase 1: MAP（並行分解）
    ┌──────────┬──────────┬──────────┬──────────┐
    │依賴分析師│任務分解師│測試規劃師│風險預防師│
    └──────────┴──────────┴──────────┴──────────┘

    ⚠️ **並行執行關鍵**：
       在單一訊息中發送 4 個 Task 工具呼叫：
       - Task({description: "依賴分析", ...})
       - Task({description: "任務分解", ...})
       - Task({description: "測試規劃", ...})
       - Task({description: "風險預防", ...})
       這樣才能真正並行執行！
    ↓
Phase 2: REDUCE（合併 + 排序）
    ↓
Phase 3: TDD 驗證 → 確保每個 T-F-* 有對應 TEST-*
    ↓
Phase 4: DAG 驗證 → 無循環、無孤立任務
    ↓
Phase 5: 依賴偵測 → 隱含依賴分析
    ↓
Phase 6: 品質閘門 → 輸出 tasks.yaml

TDD 強制執行

必要條件（BLOCKER）：

• 所有 T-F- 任務必須有對應的 TEST- 任務
• TEST- 任務必須 block 對應的 T-F- 任務

驗證腳本：shared/tools/tdd-validator.sh

→ 配置：[shared/quality/tdd-enforcement.yaml](_shared/quality/tdd-enforcement.yaml)

依賴偵測

四層依賴分析：

1. L1_explicit: 顯式聲明的依賴
2. L2fileoverlap: 修改相同檔案的任務
3. L3_semantic: 語意資料流依賴
4. L4_environment: 運行時環境依賴

驗證腳本：shared/tools/dag-validator.py

→ 配置：[shared/tasks/dependency-detection.yaml](_shared/tasks/dependency-detection.yaml)

CP4: Task Commit

品質閘門通過後，必須執行 CP4 Task Commit。

Phase 6: 品質閘門 → 輸出 tasks.yaml
    ↓
CP4: Task Commit
    ├── git add .claude/memory/tasks/{plan-id}/
    └── git commit -m "feat(tasks): decompose {plan} into executable tasks"

→ 協議：[shared/git/commit-protocol.md](_shared/git/commit-protocol.md)

品質閘門

通過條件（TASKS 階段）：

• ✅ DAG 驗證通過（無循環）
• ✅ TDD 對應完整
• ✅ 所有任務有估算
• ✅ 品質分數 ≥ 80

→ 閘門配置：[shared/quality/gates.yaml](_shared/quality/gates.yaml)

輸出結構

.claude/memory/tasks/[plan-id]/
├── meta.yaml               # 元數據
├── perspectives/           # 完整視角分析（MAP 產出，保留）
│   ├── dependency-analyst.md
│   ├── task-decomposer.md
│   ├── test-planner.md
│   └── risk-preventor.md
├── summaries/              # 結構化摘要（REDUCE 產出，供快速查閱）
│   ├── dependency-analyst.yaml
│   ├── task-decomposer.yaml
│   ├── test-planner.yaml
│   └── risk-preventor.yaml
└── tasks.yaml              # 任務清單（主輸出）

⚠️ perspectives/ 保存完整分析，summaries/ 保存結構化摘要，tasks.yaml 是最終可執行任務清單。

Agent 能力限制

視角 Agent 不應該開啟 Task：

tasks.yaml 格式

version: "1.0"
plan_ref: "plans/user-auth"
waves:
  - id: wave-1
    tasks:
      - id: TEST-001
        type: test
        description: "登入功能測試"
        estimate: 15
      - id: T-F-001
        type: feature
        description: "實作登入功能"
        depends_on: [TEST-001]
        estimate: 30
        files: [src/auth/login.ts]

行動日誌

每個工具調用完成後，記錄到 .claude/workflow/{workflow-id}/logs/actions.jsonl。

記錄時機：

• 成功：記錄 tool、input、outputpreview、durationms、status: success
• 失敗：記錄 tool、input、error、stderr（如有）、status: failed

關鍵行動（TASKS 階段）：

排查問題：

# 查看 TASKS 階段所有失敗行動
jq 'select(.stage == "TASKS" and .status == "failed")' actions.jsonl

# 查看 DAG 驗證失敗的詳情
jq 'select(.tool == "Bash" and .status == "failed")' actions.jsonl | jq '{command: .input.command, error: .error, stderr: .stderr}'

→ 日誌規範：[shared/communication/execution-logs.md](_shared/communication/execution-logs.md)

共用模組

工作流位置

RESEARCH → PLAN → TASKS → IMPLEMENT → REVIEW → VERIFY
                    ↑
                 你在這裡

• 輸入：implementation-plan.md 來自 plan skill
• 輸出：tasks.yaml 供 implement skill 使用