README

Claude Code 支持多 Agent 协作，通过任务委派和并行执行提升效率。

设计理念

为什么需要多 Agent？

单个 Agent 的局限：

1. 上下文限制 - 200K token 预算

2. 专业化需求 - 不同任务需要不同专长

3. 并行能力 - 某些任务可以同时进行

多 Agent 优势

• 每个 Agent 有独立上下文

• 可以使用专门的 System Prompt

• 支持并行执行

Agent 类型

内置 Agent

const BUILTIN_AGENTS = {
  'context-gatherer': {
    description: '分析代码库，识别相关文件',
    systemPrompt: CONTEXT_GATHERER_PROMPT,
    tools: ['readCode', 'fileSearch', 'grepSearch'],
    mode: 'sync',
  },
  
  'custom-agent-creator': {
    description: '创建自定义 Agent',
    systemPrompt: AGENT_CREATOR_PROMPT,
    tools: ['fsWrite', 'readFile'],
    mode: 'sync',
  },
  
  'general-task-execution': {
    description: '通用任务执行',
    systemPrompt: GENERAL_PROMPT,
    tools: '*',
    mode: 'sync',
  },
};

自定义 Agent

// .kiro/agents/code-reviewer.json
{
  "name": "code-reviewer",
  "description": "Review code for best practices",
  "systemPrompt": "You are an expert code reviewer...",
  "tools": ["readCode", "getDiagnostics", "grepSearch"],
  "mode": "sync"
}

执行模式

同步执行

阻塞等待 Agent 完成：

const result = await invokeSubAgent({
  name: 'context-gatherer',
  prompt: 'Find authentication related files',
});

// result 包含 Agent 的完整输出
console.log(result.output);

异步执行

后台运行，不阻塞主 Agent：

const agentId = await invokeSubAgent({
  name: 'general-task-execution',
  prompt: 'Run all tests',
  mode: 'async',
});

// 继续其他工作
// ...

// 稍后检查结果
const result = await getAgentResult(agentId);

章节内容

• Agent 类型 - 内置和自定义 Agent

• 同步执行 - 阻塞式 Agent 调用

• 异步执行 - 后台 Agent 执行

• Swarm 模式 - 多 Agent 并行协作

• Worktree 隔离 - Git worktree 隔离

使用场景

1. 代码分析

// 主 Agent: 修复 bug
// 子 Agent: 分析相关代码

const files = await invokeSubAgent({
  name: 'context-gatherer',
  prompt: '找出与登录功能相关的所有文件',
});

// 主 Agent 继续处理这些文件
for (const file of files) {
  await analyzeAndFix(file);
}

2. 并行任务

// 同时运行多个 Agent
const [tests, lint, build] = await Promise.all([
  invokeSubAgent({ name: 'test-runner', prompt: 'Run tests' }),
  invokeSubAgent({ name: 'linter', prompt: 'Run linter' }),
  invokeSubAgent({ name: 'builder', prompt: 'Build project' }),
]);

3. 专业化任务

// 使用专门的 Agent
const review = await invokeSubAgent({
  name: 'code-reviewer',
  prompt: 'Review this PR for security issues',
  contextFiles: [{ path: 'src/auth.ts' }],
});

下一步

• 了解 Agent 类型 的详细信息

• 探索 Swarm 模式 的并行协作

• 查看 Coordinator 的任务编排