agent types

Claude Code 支持多种类型的 Agent，每种都有特定的用途和能力。

内置 Agent

context-gatherer

用途: 分析代码库，识别相关文件

System Prompt:

You are a specialized agent for analyzing codebases.

Your goal is to identify relevant files and code sections for a given issue.

Process:
1. Understand the issue
2. Search for relevant files
3. Read code structure
4. Identify key files and sections
5. Return a focused list

可用工具:

• readCode

• fileSearch

• grepSearch

• listDirectory

使用示例:

const result = await invokeSubAgent({
  name: 'context-gatherer',
  prompt: '找出所有与用户认证相关的文件',
  explanation: '需要修复登录 bug',
});

// 返回:
// - src/auth/login.ts
// - src/auth/session.ts
// - src/components/LoginForm.tsx

custom-agent-creator

用途: 创建新的自定义 Agent

System Prompt:

You are an agent creator.

Your goal is to help users define new specialized agents.

Process:
1. Understand the agent's purpose
2. Define required tools
3. Write system prompt
4. Create agent configuration file

可用工具:

• fsWrite

• readFile

• listDirectory

使用示例:

await invokeSubAgent({
  name: 'custom-agent-creator',
  prompt: '创建一个代码审查 Agent',
});

// 生成: .kiro/agents/code-reviewer.json

general-task-execution

用途: 通用任务执行

System Prompt: 标准的 Claude Code prompt

可用工具: 所有工具

使用示例:

await invokeSubAgent({
  name: 'general-task-execution',
  prompt: '运行所有测试并生成报告',
});

自定义 Agent

配置格式

// .kiro/agents/my-agent.json
{
  "name": "my-agent",
  "description": "Agent description",
  "systemPrompt": "You are...",
  "tools": ["tool1", "tool2"],
  "mode": "sync",
  "config": {
    "temperature": 0.7,
    "maxTokens": 4096
  }
}

创建自定义 Agent

// 1. 定义 Agent
const agentConfig = {
  name: 'test-runner',
  description: 'Run tests and analyze results',
  systemPrompt: `
You are a test runner agent.

Your goal is to:
1. Find all test files
2. Run tests
3. Analyze failures
4. Suggest fixes
  `,
  tools: ['fileSearch', 'executePwsh', 'readFile'],
  mode: 'sync',
};

// 2. 保存配置
await fs.writeFile(
  '.kiro/agents/test-runner.json',
  JSON.stringify(agentConfig, null, 2)
);

// 3. 使用 Agent
const result = await invokeSubAgent({
  name: 'test-runner',
  prompt: 'Run all unit tests',
});

Agent 能力

工具访问

Agent 可以访问指定的工具：

// 限制工具访问
{
  "tools": ["readFile", "grepSearch"]
}

// 允许所有工具
{
  "tools": "*"
}

// 排除特定工具
{
  "tools": "*",
  "excludeTools": ["deleteFile", "executePwsh"]
}

上下文传递

主 Agent 可以传递上下文给子 Agent：

await invokeSubAgent({
  name: 'code-reviewer',
  prompt: 'Review this file',
  contextFiles: [
    { path: 'src/auth.ts', startLine: 10, endLine: 50 },
  ],
});

配置覆盖

await invokeSubAgent({
  name: 'general-task-execution',
  prompt: 'Analyze code',
  config: {
    temperature: 0.3,  // 更确定性的输出
    maxTokens: 2048,
  },
});

Agent 通信

消息传递

// Agent 之间可以通信
interface AgentMessage {
  from: string;
  to: string;
  type: 'request' | 'response';
  payload: any;
}

async function sendToAgent(
  targetAgent: string,
  message: AgentMessage
): Promise<void> {
  const agent = getAgent(targetAgent);
  await agent.receiveMessage(message);
}

结果聚合

// 收集多个 Agent 的结果
const results = await Promise.all([
  invokeSubAgent({ name: 'agent1', prompt: 'task1' }),
  invokeSubAgent({ name: 'agent2', prompt: 'task2' }),
]);

const aggregated = aggregateResults(results);

下一步

• 了解 同步执行 的实现

• 探索 异步执行 的机制

• 查看 Swarm 模式 的并行协作