Skip to content
IN DEVELOPMENT编排5 RolesHubgit worktreev0.1.2

Agent SWE Team

角色化多 Agent 软件工程团队

模拟人类软件团队的协作模式。Leader Agent 通过 Hub 分发工单给 Architect/Backend/Frontend/QA/Reviewer,每个角色在独立 git worktree 中工作。支持 BLOCKED→Reply 决策循环和混合引擎调度。

Agent SWE Team
启动团队 Hub
$node scripts/team.mjs hub start --port 3847
OK Hub listening on http://localhost:3847
派发工单
$node scripts/team.mjs dispatch --role backend --ticket T001.md --engine codex
OK Dispatched T001 → backend (Codex SDK)
Worktree: /tmp/.team/worktrees/backend-T001
$node scripts/team.mjs status
backend T001 RUNNING [████░] 60%
frontend T002 BLOCKED awaiting API contract

核心能力

角色化 Agent

5 个专业角色:Architect / Backend / Frontend / QA / Reviewer。每个角色有独立的 System Prompt 和专业知识。

Hub 智能调度

本地 Hub 服务提取结构化产出(API 合同、决策、Review 意见),填充 Team Blackboard 实现跨角色感知。

git worktree 隔离

每个角色在独立 worktree 中工作,互不干扰。完成后合并回主分支。

BLOCKED→Reply 循环

角色遇到阻塞时发出 TEAM_STATUS=BLOCKED,Leader 决定 Reply 回灌或人工介入。

混合引擎

同一团队中不同角色可使用不同引擎(Codex SDK / Claude Agent SDK),按需选择。

Dashboard

本地 Web Dashboard 实时展示各角色状态、工单进度、Blackboard 内容。

命令参考

Hub 管理

本地协作中枢

命令说明示例
hub start启动 Hub 服务node scripts/team.mjs hub start --port 3847
hub stop停止 Hubnode 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回复 BLOCKEDnode scripts/team.mjs reply --role backend --message "使用 REST API"

角色矩阵

角色职责典型产出
Architect系统设计、API 合同、技术决策架构图、接口定义
Backend后端实现、数据库、API代码、测试、迁移
FrontendUI 实现、组件、交互页面、组件、样式
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 审查 → 通过/驳回

依赖安装

bash
cd agent-swe-team && npm install

需要 Codex SDK 或 Claude Agent SDK(按使用的引擎安装)。

快速开始

Install
via skills.sh (推荐)
$npx skills add northseadl/norix-skills/agent-swe-team
或手动安装
$git clone https://github.com/northseadl/norix-skills.git
$ln -s norix-skills/agent-swe-team <SKILLS_DIR>/agent-swe-team
验证
$npm install
OK Skill ready.

Built for AI Agents, by Norix