---
title: 12-Agent Game Rules
description: AWOOOI 12-agent 新遊戲規則 v1，定義任務自動判型、主責/協作派工與 9 skills 對照
version: v1.0
created: 2026-04-24 (台北)
created_by: Codex
last_modified: 2026-04-24 (台北)
last_modified_by: Codex
---

# 12-Agent 新遊戲規則 v1

> 目的：把 12 個分工 agent 從「審計與設計概念」落成「日常任務派工規則」。

## 定位

- `12 agents` 是任務分工角色
- `.agents/skills/*.md` 9 份是工程守則與實作規範
- 實際工作模式：先用 12-agent 判型與分工，再落到對應 skill 規範執行

## 12 Agents 名單

| Agent | 核心職責 |
|------|----------|
| `critic` | 架構審查、回歸風險、規範稽核 |
| `vuln-verifier` | 安全驗證、漏洞風險、權限與 secrets 邊界 |
| `debugger` | 查斷點、還原 execution path、找根因 |
| `db-expert` | schema / migration / learning loop / SQL 正確性 |
| `planner` | 任務拆解、Phase 排程、驗收清單 |
| `fullstack-engineer` | 前後端串接與功能完整落地 |
| `frontend-designer` | UI/UX、版面、設計一致性、i18n 呈現 |
| `refactor-specialist` | God class 拆分、抽層、技術債清理 |
| `migration-engineer` | 新舊路徑切換、Gitea/CI/CD/GitOps 遷移與回滾 |
| `onboarder` | 新 session 導覽、脈絡建立、文件地圖 |
| `tool-expert` | MCP / provider / Prometheus / K8s / SSH 工具整合 |
| `web-researcher` | 官方規格、外部 API / SDK / 文件事實查核 |

## 9 Skills vs 12 Agents

| 12-agent | 最接近的 skills |
|----------|------------------|
| `frontend-designer` | `01-awoooi-frontend-aesthetics` |
| `fullstack-engineer` | `01 + 02 + 06` |
| `debugger` | `02 + 05` |
| `db-expert` | `02` |
| `planner` | `06` |
| `refactor-specialist` | `09 + 02` |
| `migration-engineer` | `09 + 06 + 04` |
| `tool-expert` | `07` |
| `web-researcher` | `07`（外部整合與規格查核側） |
| `critic` | `05`（加上 ADR / HARD_RULES 審查） |
| `vuln-verifier` | `04 + 05 + 03` |
| `onboarder` | `06` |

## 模組責任區

| Agent | 主要責任區 |
|------|------------|
| `critic` | `docs/adr/`, `docs/HARD_RULES.md`, `docs/RED_ZONES.md`, `docs/LOGBOOK.md` |
| `vuln-verifier` | `apps/api/src/services/telegram_gateway.py`, `auto_approve.py`, `apps/api/src/core/config.py`, `k8s/awoooi-prod/` |
| `debugger` | `decision_manager.py`, `apps/api/src/api/v1/webhooks.py`, `apps/api/src/jobs/`, `apps/api/src/services/` |
| `db-expert` | `apps/api/migrations/`, `learning_service.py`, `playbook_service.py`, `repositories/` |
| `planner` | `docs/superpowers/specs/`, `docs/superpowers/plans/`, `project_current_status.md`, `project_master_workplan.md` |
| `fullstack-engineer` | `apps/web/`, `apps/api/src/api/v1/`, `docs/api/openapi.yaml` |
| `frontend-designer` | `apps/web/src/`, `docs/design/`, `docs/guidelines/FRONTEND.md`, `docs/screenshots/` |
| `refactor-specialist` | `openclaw.py`, `decision_manager.py`, `apps/api/src/api/v1/`, `packages/` |
| `migration-engineer` | `.gitea/workflows/`, `ADR-039`, `ADR-059`, `gitea_webhook.py` |
| `onboarder` | `AGENTS.md`, MASTER 藍圖, `docs/LOGBOOK.md`, Memory 索引 |
| `tool-expert` | `apps/api/src/providers/`, `services/*provider*`, `ADR-001`, `ADR-015` |
| `web-researcher` | `ADR-093`, `ADR-094`, `ADR-095` 等需要官方規格驗證的設計文檔 |

## 自動派工規則

### 主責判型

| 任務描述關鍵字 | 主責 agent | 預設協作 |
|---------------|-----------|---------|
| 壞了、沒反應、查一下、找根因 | `debugger` | `db-expert`, `tool-expert`, `critic` |
| migration、SQL、playbook、KM、learning | `db-expert` | `debugger`, `refactor-specialist` |
| 前端、頁面、UI、戰情中心、i18n | `frontend-designer` | `fullstack-engineer`, `critic` |
| 前後端一起改、API 串 UI、完整落地 | `fullstack-engineer` | `frontend-designer`, `debugger`, `db-expert` |
| 重構、拆模組、抽層、技術債 | `refactor-specialist` | `migration-engineer`, `critic`, `db-expert` |
| Gitea、Webhook、CI/CD、部署、GitOps | `migration-engineer` | `tool-expert`, `vuln-verifier`, `critic` |
| Prometheus、MCP、SSH、K8s 工具、provider | `tool-expert` | `debugger`, `migration-engineer` |
| Telegram、approval、callback、群組、權限、安全 | `vuln-verifier` | `debugger`, `db-expert`, `critic` |
| 規劃、拆階段、排優先級、列清單 | `planner` | `critic`, `onboarder` |
| 盤點專案、看懂脈絡、建立上下文 | `onboarder` | `planner`, `critic` |
| review、找風險、驗證規範 | `critic` | 依主題加其他 agent |
| 官方文件、外部規格、SDK/API 事實 | `web-researcher` | `planner`, `critic` |

### 強制加簽規則

- 碰 `decision_manager.py`、`config.py`、learning loop、Telegram approval 鏈：必加 `critic`
- 碰 migration、schema、playbook trust、KM 寫入：必加 `db-expert`
- 碰 CI/CD、secrets、webhook、deployment：必加 `vuln-verifier`
- 碰大型重構：必加 `migration-engineer`

## 常用組隊模板

### 1. 告警沒送到 Telegram

- 主責：`debugger`
- 協作：`vuln-verifier`, `db-expert`, `critic`

### 2. AI 飛輪沒學到

- 主責：`db-expert`
- 協作：`debugger`, `refactor-specialist`, `critic`

### 3. 前端首頁或戰情中心重做

- 主責：`frontend-designer`
- 協作：`fullstack-engineer`, `critic`

### 4. Gitea / webhook / deploy 壞掉

- 主責：`migration-engineer`
- 協作：`tool-expert`, `vuln-verifier`, `critic`

### 5. 大型重構但怕炸

- 主責：`refactor-specialist`
- 協作：`migration-engineer`, `db-expert`, `critic`

## 執行原則

1. 不為了形式把 12 個 agent 全部攤開，永遠採「最小必要組隊」
2. 先定主責，再補 1-3 位必要協作
3. 所有 agent 的實作仍必須遵守對應 skills、HARD_RULES、MASTER 與 memory
4. 若任務涉及 AI 自主化、告警、修復、規則、分類、通知，先回到 MASTER §0 / §8 校準

## 關聯文件

- [ADR-095: 12-Agent Claude SDK 整合 × Telegram 視覺分派](/Users/ogt/awoooi/docs/adr/ADR-095-12agent-sdk-integration.md)
- [Skill 06: AWOOOI Monorepo Master](/Users/ogt/awoooi/.agents/skills/06-awoooi-monorepo-master.md)
- [MASTER 藍圖](/Users/ogt/awoooi/docs/superpowers/specs/2026-04-15-MASTER-ai-autonomous-flywheel-v2.md)