ID	名稱	模型	聚焦
`main_agent`	主實作者	sonnet	功能實作
`tdd-enforcer`	TDD 守護者	haiku	測試先行檢查
`security-auditor`	安全審計員	sonnet	安全漏洞檢測
`maintainer`	可維護性審查	haiku	程式碼品質

→ 模型路由配置：shared/config/model-routing.yaml

執行流程

Phase 0: 載入任務 → 解析 tasks.yaml、排序 waves
    ↓
For each task in waves:
    ↓
    Phase 1: TDD 閘門（PRE-TASK）
    ├── 測試檔案存在？
    ├── 測試可執行？
    └── ❌ 失敗 → BLOCKER，無法繼續
    ↓
    Phase 2: 並行實作 + 審查
    ┌──────────┬──────────┬──────────┐
    │ 主實作者 │安全審計員│可維護性  │
    └──────────┴──────────┴──────────┘
    ↓
    Phase 3: TDD 閘門（POST-TASK）
    ├── 測試通過？
    └── 覆蓋率達標？
    ↓
    Phase 4: 自我審查 + 提交
    ↓
End for
    ↓
Phase 5: 品質閘門 → 整體驗證

TDD 強制閘門

Pre-Task Gate（BLOCKER）：

測試檔案必須存在
測試必須可執行（即使失敗）

Post-Task Gate（BLOCKER）：

測試必須通過
覆蓋率 ≥ 80%

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

→ 配置：shared/quality/tdd-enforcement.yaml

安全審計

使用 OWASP Top 10 和 CWE Top 25 框架：

SQL Injection
XSS
認證/授權問題
敏感資料處理

→ 框架：shared/perspectives/expertise-frameworks/security.yaml

CP4: Task Commit

每個 task 完成後必須執行 CP4 Task Commit（增量 commit）。

Phase 4: 自我審查 + 提交
    ↓
CP4: Task Commit（每個 task）
    ├── git add {changed_files}
    ├── git add .claude/memory/implement/{id}/task-results/{task-id}.yaml
    └── git commit -m "feat(implement): complete {task-id} - {description}"

注意：implement skill 的 CP4 是增量觸發，每個 task 完成後都會 commit，確保進度不會丟失。

→ 協議：shared/git/commit-protocol.md

品質閘門

通過條件（IMPLEMENT 階段）：

✅ 所有任務完成
✅ 測試通過
✅ 無 BLOCKER 問題
✅ 品質分數 ≥ 80

→ 閘門配置：shared/quality/gates.yaml

輸出結構

.claude/memory/implement/[tasks-id]/
├── meta.yaml               # 元數據
├── perspectives/           # 角色分析報告（並行審查產出，保留）
│   ├── security-auditor.md     # 安全審計完整報告
│   └── maintainer.md           # 可維護性完整報告
├── summaries/              # 結構化摘要（供快速查閱）
│   ├── security-auditor.yaml
│   └── maintainer.yaml
├── task-results/           # 每個任務的結果
│   ├── T-F-001.yaml
│   └── T-F-002.yaml
├── security-report.md      # 安全審計報告（匯總）
├── coverage-report.md      # 覆蓋率報告
└── summary.md              # 實作摘要（主輸出）

⚠️ perspectives/ 保存完整角色分析，summaries/ 保存結構化摘要。

Agent 能力限制

審查 Agent 不應該開啟 Task：

允許的操作	說明
✅ Read	讀取程式碼
✅ Glob/Grep	搜尋檔案和內容
✅ Bash	執行測試
✅ Write	寫入報告
❌ Task	開子 Agent

行動日誌

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

記錄時機：

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

關鍵行動（IMPLEMENT 階段）：

行動	記錄重點
Read（讀取現有程式碼）	`file_path`、`output_size`
Edit（修改程式碼）	`file_path`、`old_string` (truncated)、`new_string` (truncated)
Write（建立新檔案）	`file_path`、`content_size`
Bash（執行測試）	`command`、`exit_code`、`stdout`、`stderr`
Task（啟動審查 Agent）	`subagent_type`、`prompt` (truncated)、`agent_id`

排查問題：

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

# 查看測試失敗的詳情
jq 'select(.tool == "Bash" and .input.command | contains("test"))' actions.jsonl | jq '{command: .input.command, exit_code: .exit_code, stderr: .stderr}'

# 查看 Edit 操作失敗（找不到 old_string）
jq 'select(.tool == "Edit" and .status == "failed")' actions.jsonl

→ 日誌規範：shared/communication/execution-logs.md

共用模組

模組	用途
coordination/map-phase.md	並行協調
quality/tdd-enforcement.yaml	TDD 強制
quality/gates.yaml	品質閘門
perspectives/expertise-frameworks/security.yaml	安全框架
tools/tdd-validator.sh	TDD 驗證器

工作流位置

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

輸入：tasks.yaml 來自 tasks skill
輸出：已實作的程式碼，供 review skill 審查

implement

Multi-Agent Implement v3.0.0

使用方式

角色配置

More from miles990/multi-agent-workflow

review

verify

research

status

tasks

plan