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>
6.2 KiB
6.2 KiB
title, description, version, created, created_by, last_modified, last_modified_by
| title | description | version | created | created_by | last_modified | last_modified_by |
|---|---|---|---|---|---|---|
| 12-Agent Game Rules | AWOOOI 12-agent 新遊戲規則 v1，定義任務自動判型、主責/協作派工與 9 skills 對照 | v1.0 | 2026-04-24 (台北) | Codex | 2026-04-24 (台北) | Codex |
12-Agent 新遊戲規則 v1
目的：把 12 個分工 agent 從「審計與設計概念」落成「日常任務派工規則」。
定位
12 agents是任務分工角色.agents/skills/*.md9 份是工程守則與實作規範- 實際工作模式：先用 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
執行原則
- 不為了形式把 12 個 agent 全部攤開，永遠採「最小必要組隊」
- 先定主責，再補 1-3 位必要協作
- 所有 agent 的實作仍必須遵守對應 skills、HARD_RULES、MASTER 與 memory
- 若任務涉及 AI 自主化、告警、修復、規則、分類、通知，先回到 MASTER §0 / §8 校準