🎮 Codex 8-Agent 协同工作流系统 - 棋牌游戏平台开发

仓库地址

GitHub: https://github.com/perwqaq/Codex-agent

---

📦 Windows 安装方法

1. 克隆仓库

git clone https://github.com/perwqaq/Codex-agent.git

2. 复制到 IDE Skills 目录

Trae IDE

xcopy /E /I Codex-agent\skills .trae\skills

Codex CLI

xcopy /E /I Codex-agent\skills %USERPROFILE%\.codex\skills\codex-agent-workflow

Cursor IDE

xcopy /E /I Codex-agent\skills %USERPROFILE%\.cursor\skills

---

📦 macOS/Linux 安装方法

1. 克隆仓库

git clone https://github.com/perwqaq/Codex-agent.git

2. 复制到 IDE Skills 目录

Trae IDE

cp -r Codex-agent/skills/* .trae/skills/

Codex CLI

cp -r Codex-agent/skills/* ~/.codex/skills/codex-agent-workflow/

Cursor IDE

cp -r Codex-agent/skills/* ~/.cursor/skills/

---

🚀 使用方法

启动工作流

在IDE中输入：

开始项目

或

@commander 开始棋牌游戏平台开发

各Agent触发指令

Agent	触发指令
@commander	开始项目、审查代码、质量验收
@product-manager	写PRD、分析需求、产品规划
@ui-ux-designer	设计界面、出设计规范、找素材
@frontend-engineer	写前端、React组件、WebSocket
@backend-engineer	写后端、API开发、数据库设计
@game-logic	写游戏逻辑、游戏规则、房间管理
@qa-engineer	写测试、测试用例、自动化测试
@devops-security	写Dockerfile、CI/CD、部署

---

🏢 系统架构

                            ┌─────────────────────┐
                            │   COMMANDER (大脑)   │
                            └──────────┬──────────┘
                                       │
     ┌─────────────┬───────────┬───────┴───────┬──────────┬────────────┐
     ▼             ▼           ▼               ▼          ▼            ▼
┌─────────┐  ┌─────────┐  ┌──────────┐  ┌─────────┐  ┌────────┐  ┌─────────┐
│Product  │  │  UI/UX  │  │ Frontend │  │Backend  │  │  Game  │  │   QA    │
│ Manager │  │Designer│  │ Engineer │  │ Engineer│  │ Logic  │  │ Engineer│
└─────────┘  └─────────┘  └──────────┘  └─────────┘  └────────┘  └─────────┘
                                       │
                            ┌──────────▼──────────┐
                            │   DevOps + Security │
                            └─────────────────────┘

---

📁 目录结构

Codex-agent/
├── skills/                    # 8个Agent技能包 (IDE可识别)
│   ├── commander/
│   │   └── SKILL.md          # 总指挥
│   ├── product-manager/
│   │   └── SKILL.md          # 产品经理
│   ├── ui-ux-designer/
│   │   └── SKILL.md          # 设计师
│   ├── frontend-engineer/
│   │   └── SKILL.md          # 前端工程师
│   ├── backend-engineer/
│   │   └── SKILL.md          # 后端工程师
│   ├── game-logic/
│   │   └── SKILL.md          # 游戏逻辑工程师
│   ├── qa-engineer/
│   │   └── SKILL.md          # 测试工程师
│   └── devops-security/
│       └── SKILL.md          # 运维安全工程师
├── agents/                    # 原始角色定义
├── config/                    # 全局配置
├── workflow/                  # 工作流定义
├── validation/               # 验收标准
├── mcp/                      # MCP服务器配置
├── package.json              # NPM包配置
└── README.md                 # 本文件

---

🎯 工作流程示例

1. 用户: "开始棋牌游戏平台开发"
   ↓
2. Commander 启动工作流
   ↓
3. Product Manager 写PRD
   ↓
4. UI/UX Designer 出设计规范
   ↓
5. Frontend/Backend/Game Logic 并行开发
   ↓
6. QA Engineer 测试
   ↓
7. Commander 质量验收 (连续3次≥9.5分)
   ↓
8. DevOps 部署上线

---

✅ 验收标准

检查项	标准
代码审查	SonarQube + OWASP 通过
功能测试	单元测试 > 80%
性能测试	P95 < 200ms
体验评分	连续3次 ≥ 9.5分

---

🛠️ 技术栈

• 前端: React + TypeScript + Vite
• 后端: Node.js + FastAPI + PostgreSQL + Redis
• 部署: Docker + Kubernetes