Workshop 多 Agent 工程团队
Workshop 架构的多 Agent 软件工程团队。Supervisor 启动 Hub → Leader 分解目标 → Worker 垂直执行 → Inspector 质检。圆桌会议室 @mention 通信、共享面板、私有管道三层通信。Git worktree 隔离，持久会话模型。
FEATURES
Supervisor → Hub(HTTP) → Leader + Worker×N + Inspector。三层分离：你监控、Leader 决策、Worker 执行。
全员共享的 meeting.jsonl 讨论空间。@mention 自动唤醒目标 Agent，Hub 被动注入未读消息。
Agent session 跨任务持续（Codex thread resume / Claude v2 session）。角色上下文保留在会话历史中。
每个 Worker 独立 git worktree + 分支 team/{runId}/{role}。.teamwork.py 写入 worktree-local exclude。
signal / board / wake / say / dm / task / merge / done — 单行命令替代 HTTP 调用，节省 Agent 上下文。
层叠玻璃 UI + WCAG 对比度 + SVG 图标。多视图 Tab：面板、活动流、会议室。
REFERENCE
所有操作通过单行命令完成
| 命令 | 说明 | 示例 |
|---|---|---|
signal | 运行状态信号 | $WS signal |
board | 紧凑面板视图 | $WS board |
wake | 唤醒 Agent | $WS wake leader |
say | 发到会议室 | $WS say "message" |
dm | 私信 Agent | $WS dm worker-1 "私信" |
task | 任务管理 | $WS task create "标题" --assign worker-1 |
merge | 合并分支 | $WS merge worker-1 |
done | 结束运行 | $WS done |
Workshop 引擎入口
| 命令 | 说明 | 示例 |
|---|---|---|
serve | 启动 Workshop | node scripts/team.mjs serve --goal "目标" --cwd /project |
status | 查看状态 | node scripts/team.mjs status --cwd /project |
用户 ─── 给出目标 ─── 可随时介入
│
▼
Supervisor (你) ── 启动 Workshop → 监控 → 转发 → 收尾
│
▼
Hub (HTTP Server) ── 纯管道 + @mention 自动唤醒
│
├── Leader ── 内部协调者：分解目标、分配任务、质检、收工
├── Worker×N ── 全栈工匠：各自独立 worktree，垂直切片
└── Inspector ── 质检官：基于原始目标整体评估# 1. 确保依赖（只需首次）
cd <skill-dir>/agent-swe-team && npm install
# 2. 后台启动
node <skill-dir>/agent-swe-team/scripts/team.mjs serve \
--cwd <项目目录> --goal "你的目标" &
# 3. 等待就绪
sleep 3 && PORT=$(cat <项目目录>/.workshop/port)Phase 间隔 命令
启动确认 60s $WS signal
运行中 120s $WS signal → RUNNING → $WS board
尾声 300s $WS signal → 等 COMPLETED$WS signal # → "COMPLETED"
git diff main..integration/$RUN_ID --stat
git checkout main && git merge integration/$RUN_ID --no-ff| 选项 | 默认值 | 说明 |
|---|---|---|
--goal | 必需 | 目标描述 |
--cwd | cwd | 项目目录 |
--roles | leader,worker:2,inspector | 团队组成 |
--engine | codex | codex / claude |
--base | HEAD | 基准 commit |
--dry-run | false | 模拟模式 |
cd agent-swe-team && npm install需要 Codex SDK 或 Claude Agent SDK（按使用的引擎安装）。
INSTALL