跳到主要内容

Agent 编排工具

Agent 编排工具是 Claude Code 实现复杂任务分解和并行处理的关键。通过这些工具，Claude 可以启动子 Agent、协调团队、管理工作流。

AgentTool​

启动子 Agent，是多 Agent 协作的核心。

{
  prompt: string;           // 任务描述
  description: string;      // 3-5 词的任务概要
  subagent_type?: string;   // Agent 类型
  name?: string;            // Agent 名称（用于消息寻址）
  mode?: string;            // 权限模式
  model?: string;           // 模型覆盖
  isolation?: "worktree";   // 隔离模式
  run_in_background?: boolean; // 后台运行
}

Agent 类型​

类型描述工具范围
general-purpose通用 Agent所有工具
Explore快速代码探索只读工具
Plan架构设计规划只读工具
claude-code-guideClaude Code 使用指南搜索+阅读
code-reviewer代码审查所有工具

并行执行​

可以在一条消息中启动多个 Agent 并行工作：

// 同时启动 3 个 Agent
Agent({ prompt: "搜索所有 API 端点", subagent_type: "Explore" })
Agent({ prompt: "分析数据库 Schema", subagent_type: "Explore" })
Agent({ prompt: "检查测试覆盖率", subagent_type: "general-purpose" })

Worktree 隔离​

设置 isolation: "worktree" 可以在独立的 git worktree 中运行 Agent：

  • Agent 获得仓库的独立副本
  • 不会影响主分支的工作状态
  • 完成后自动清理（无变更时）
  • 有变更时返回 worktree 路径和分支名

SendMessageTool​

向正在运行的 Agent 发送消息，实现 Agent 间通信。

{
  to: string;               // 目标 Agent 名称或 ID
  message: string;          // 消息内容
}

使用场景​

  • 向后台 Agent 发送追加指令
  • 传递中间结果给协作 Agent
  • 恢复暂停的 Agent 继续工作

TeamCreateTool​

创建 Agent 团队，用于复杂项目的多 Agent 协作。

{
  team_name: string;        // 团队名称
  description: string;      // 团队描述
  agents: AgentConfig[];    // Agent 配置列表
}

EnterPlanModeTool​

切换到计划模式，只允许只读操作，专注于设计和规划。

{
  plan_description?: string; // 计划描述
}

在计划模式下：

  • 禁止文件写入和编辑
  • 禁止执行 Shell 命令
  • 允许搜索和阅读
  • 可以创建结构化的实施计划

ExitPlanModeTool​

退出计划模式，恢复完整工具访问。

EnterWorktreeTool / ExitWorktreeTool​

管理 Git Worktree，在隔离的工作树中进行开发。

// 进入 Worktree
{
  branch_name?: string;     // 分支名
  base_branch?: string;     // 基准分支
}

// 退出 Worktree
{
  cleanup?: boolean;        // 是否清理
}

多 Agent 协作模式​

模式一：并行探索​

主 Agent
├── Explore Agent 1 → 搜索前端代码
├── Explore Agent 2 → 搜索后端代码
└── Explore Agent 3 → 搜索测试代码
        ↓
    汇总结果，统一实施

模式二：流水线​

Plan Agent → 制定计划
    ↓
主 Agent → 分配任务
    ↓
Worker Agent 1 → 实现功能 A
Worker Agent 2 → 实现功能 B
    ↓
Code Review Agent → 代码审查

模式三：Worktree 隔离开发​

主 Agent (main 分支)
├── Worktree Agent 1 (feature-a 分支)
└── Worktree Agent 2 (feature-b 分支)
        ↓
    各自独立开发，互不干扰