角色化多 Agent 软件工程团队
模拟人类软件团队的协作模式。Leader Agent 通过 Hub 分发工单给 Architect/Backend/Frontend/QA/Reviewer,每个角色在独立 git worktree 中工作。支持 BLOCKED→Reply 决策循环和混合引擎调度。
FEATURES
5 个专业角色:Architect / Backend / Frontend / QA / Reviewer。每个角色有独立的 System Prompt 和专业知识。
本地 Hub 服务提取结构化产出(API 合同、决策、Review 意见),填充 Team Blackboard 实现跨角色感知。
每个角色在独立 worktree 中工作,互不干扰。完成后合并回主分支。
角色遇到阻塞时发出 TEAM_STATUS=BLOCKED,Leader 决定 Reply 回灌或人工介入。
同一团队中不同角色可使用不同引擎(Codex SDK / Claude Agent SDK),按需选择。
本地 Web Dashboard 实时展示各角色状态、工单进度、Blackboard 内容。
REFERENCE
本地协作中枢
| 命令 | 说明 | 示例 |
|---|---|---|
hub start | 启动 Hub 服务 | node scripts/team.mjs hub start --port 3847 |
hub stop | 停止 Hub | node scripts/team.mjs hub stop |
派发与监控
| 命令 | 说明 | 示例 |
|---|---|---|
dispatch | 派发工单 | node scripts/team.mjs dispatch --role backend --ticket T001.md --engine codex |
status | 查看状态 | node scripts/team.mjs status |
reply | 回复 BLOCKED | node scripts/team.mjs reply --role backend --message "使用 REST API" |
| 角色 | 职责 | 典型产出 |
|---|---|---|
| Architect | 系统设计、API 合同、技术决策 | 架构图、接口定义 |
| Backend | 后端实现、数据库、API | 代码、测试、迁移 |
| Frontend | UI 实现、组件、交互 | 页面、组件、样式 |
| QA | 测试策略、自动化测试 | 测试代码、报告 |
| Reviewer | 代码审查、质量门禁 | Review 意见、通过/驳回 |
Leader (你)
│
├── 编写工单 (T001.md, T002.md, ...)
│
▼
Hub (localhost:3847)
│
├── dispatch → backend (git worktree)
├── dispatch → frontend (git worktree)
│
├── TEAM_STATUS=DONE → 提取产出 → Blackboard
├── TEAM_STATUS=BLOCKED → 通知 Leader → Reply
│
└── Review Loop → reviewer 审查 → 通过/驳回cd agent-swe-team && npm install需要 Codex SDK 或 Claude Agent SDK(按使用的引擎安装)。
INSTALL