技能简介
Claude团队(claude-team)是一个 MCP 服务器,用于通过 iTerm2 生成和管理 Claude Code 工作团队。每个 worker 获得独立的终端面板、可选的 git 工作树,可分配 beads issue,实现并行开发。
能做什么
- 生成多个 Claude Code worker 会话
- 并行处理多个任务
- 每个 worker 有独立上下文,保持协调器上下文干净
- 实时监控 worker 会话
- 使用 git 工作树隔离分支
- 分配 beads issue 给 worker
- 向 worker 发送消息
- 检查或等待 worker 空闲
使用说明
安装 Skill:
通过 ClawHub 安装:
clawhub install claude-team
前置要求:macOS + iTerm2(启用 Python API:Preferences → General → Magic → Enable Python API)、claude-team MCP 服务器配置在 ~/.claude.json。
黄金法则:绝不要直接修改代码,总是生成 worker 进行代码更改。这保持上下文干净并提供正确的 git 工作流。
通过 mcporter 使用:所有工具通过 mcporter call claude-team. 调用。
生成 worker:
mcporter call claude-team.spawn_workers workers='[{"project_path":"/path/to/repo","bead":"cp-123","annotation":"Fix auth bug","use_worktree":true}]' layout="auto"
配置字段:project_path(项目路径)、bead(beads issue ID)、annotation(任务描述)、prompt(额外指令)、use_worktree(创建git工作树)、skip_permissions(跳过权限确认)、name(worker名称)。
布局选项:auto(重用现有窗口)、new(创建新窗口)。
列出 worker:mcporter call claude-team.list_workers
状态值:spawning、ready、busy、closed。
发送消息:mcporter call claude-team.message_workers session_ids='["Groucho"]' message="Please add unit tests" wait_mode="none"
等待模式:none(即发即忘)、any(任一空闲返回)、all(全部空闲返回)。
检查/等待空闲:mcporter call claude-team.check_idle_workers session_ids='["Groucho","Harpo"]'
读取日志:mcporter call claude-team.read_worker_logs session_id="Groucho" pages=2
关闭 worker:mcporter call claude-team.close_workers session_ids='["Groucho","Harpo"]'
⚠️ 关闭后需审查worker分支的提交,合并或cherry-pick到持久分支,然后删除分支。
输入与输出
| 项目 | 内容 |
|---|---|
| 输入 | 项目路径、beads issue ID、任务描述、worker配置 |
| 输出 | worker会话、终端面板、git工作树、进度、日志 |
| 适用人群 | 需要并行处理的开发者、大型项目团队 |
| 不包含 | Windows/Linux支持、非iTerm2终端、自动合并 |
见下方输入与输出表格。
风险提示
- 仅支持 macOS + iTerm2
- 必须启用 iTerm2 Python API
- 代码更改必须通过 worker,不要直接修改
- worker分支需手动合并和清理
- 需要 mcporter 工具
来源信息
原始链接:https://github.com/openclaw/skills/tree/main/skills/jalehman/claude-team/SKILL.md
来源类型:GitHub
