# Implement

> 多 Agent 監督式實作框架 - TDD 驅動、即時審查、品質守護

- Skill: `miles990/implement` (Agent Skill, multi-file: 205 files)
- Install (CLI): `npx skillmds@latest add miles990/implement`
- Raw SKILL.md: https://api.skillmd.com/api/skills/miles990/implement/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: miles990 (https://skillmd.com/u/miles990)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/miles990/implement

---


# Multi-Agent Implement v3.0.0

> TDD 閘門 → 並行實作 → 即時審查 → 品質守護

## 使用方式

```bash
/multi-implement [任務路徑]
/multi-implement .claude/memory/tasks/user-auth/tasks.yaml
```

**Flags**: `--from-tasks ID` | `--skip-tdd-check` | `--parallel N`

## 角色配置

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

→ 模型路由配置：[shared/config/model-routing.yaml](_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](_shared/quality/tdd-enforcement.yaml)

## 安全審計

使用 OWASP Top 10 和 CWE Top 25 框架：
- SQL Injection
- XSS
- 認證/授權問題
- 敏感資料處理

→ 框架：[shared/perspectives/expertise-frameworks/security.yaml](_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](_shared/git/commit-protocol.md)

## 品質閘門

通過條件（IMPLEMENT 階段）：
- ✅ 所有任務完成
- ✅ 測試通過
- ✅ 無 BLOCKER 問題
- ✅ 品質分數 ≥ 80

→ 閘門配置：[shared/quality/gates.yaml](_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` |

**排查問題**：
```bash
# 查看 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](_shared/communication/execution-logs.md)

## 共用模組

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

## 工作流位置

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

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