Agent Skills
返回列表
🤖

Claude Team 多会话编排

AI Agent 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/sundial-org-awesome-openclaw-skills-claude-team。

技能介绍

要解决什么问题

当你用 Claude Code 做较大改动时,单会话既要规划又要写代码,上下文很快被 diff、日志和试错占满;同时你想让多个子任务并行推进,却又不想在同一个终端里互相干扰。Claude Team 是一个 MCP 服务,通过 iTerm2 的 Python API 拉起多个独立的 Claude Code 工作会话,由协调者通过 mcporter call claude-team 统一编排,而不是在协调会话里直接改仓库。

技能如何工作

核心思路是 worker 会话 + 可选 git worktree + 可选 beads 工单。spawn_workers 可为每个 worker 指定 project_path、annotation、prompt,并默认创建隔离的 worktree 分支;若传入 bead,worker 会按 beads 工作流处理对应 issue。协调者用 list_workers、message_workers 下发指令,read_worker_logs / examine_worker 观察进度,必要时 close_workers 收尾。文档强调一条硬规则:协调者不要直接改代码,代码变更应交给 worker,以保持协调上下文干净并符合 worktree 下的并行提交习惯。

除标准 MCP 外,还支持以 HTTP 模式常驻运行(持久 worker 注册表),以及通过 launchd 登录自启、cron 读取 worker-tracking.json 做完成监控与通知。

适用边界与注意点

环境限定在 macOS + iTerm2(启用 Python API),且需在 ~/.claude.json 中配置 claude-team。worker 需要写文件时通常要设 skip_permissions: true。关闭带 worktree 的 worker 后,需人工审阅 ephemeral 分支上的提交,再 merge/cherry-pick 到长期分支并删除分支,避免遗留孤立 worktree。

使用场景

  • 在 macOS 上需要同时让多个 Claude Code 会话分头改同一仓库的不同模块
  • 协调者只负责拆任务与评审,希望 worker 各自在 worktree 分支上提交后再合并
  • 已用 beads 管理 issue,想让指定 worker 绑定 bead ID 按工单流程改代码
  • 长时间批处理 worker,想用 HTTP 常驻服务或 cron 监控 `worker-tracking.json` 里的完成状态

适合人员

  • 维护大型单体仓库、习惯用 Claude Code 但单次会话上下文容易爆掉的后端工程师
  • 在团队里用 beads 跟踪缺陷与需求,希望 Claude 侧执行与工单 ID 对齐的技术负责人
  • 重度 iTerm2 用户,需要看得见、可中断的真实终端会话而不是黑盒后台 agent
  • 编排多 worker 并行开发后,负责审阅 ephemeral 分支并 merge 到主线的维护者