7d1c85eb86
Some checks failed
CD Pipeline / build-and-deploy (push) Has been cancelled
- nl_gateway.py: ClaudeAgentOptions 透過 env= 注入 ANTHROPIC_API_KEY（CLAUDE_API_KEY alias）， 修復 SDK 找不到 API key 的問題（SDK 讀 ANTHROPIC_API_KEY，K8s secret 名稱是 CLAUDE_API_KEY） - solver_agent.py: 修法 A — kubectl_command 欄位優先路徑，OpenClaw Nemo 回傳完整指令時 不再被語意合成壓縮 confidence（0.9 → min(0.5) 的 bug），9 tests pass - AGENTS.md: Codex CLI 對應版 CLAUDE.md（Codex Session 啟動用） - docs/12-agent-game-rules.md: 12-Agent 任務判型 + 主責/協作派工 + 9 skills 對照（v1.0） - .agents/skills/06-awoooi-monorepo-master.md: v1.6，新增 12-agent 協作治理章節 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
137 lines
6.2 KiB
Markdown
137 lines
6.2 KiB
Markdown
---
|
||
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)
|