Agent 协作工具

tools/AgentTool/
├── AgentTool.ts           # 工具主类
├── loadAgentsDir.ts       # Agent 定义加载
└── test/                  # 测试

const inputSchema = z.object({
  prompt: z.string().describe('给子 Agent 的任务描述'),
  subagent_type: z.string().optional()
    .describe('子 Agent 类型'),
  name: z.string().optional()
    .describe('子 Agent 名称'),
})

主 Agent 决定需要子任务
    │
    ▼
调用 AgentTool
    │
    ├── 1. 选择 Agent 定义
    │   ├── 从 .claude/agents/ 加载自定义 Agent
    │   └── 使用默认 Agent 配置
    │
    ├── 2. 创建子对话上下文
    │   ├── 新的消息历史
    │   ├── 继承部分工具集
    │   └── 独立的 System Prompt
    │
    ├── 3. 执行独立对话循环
    │   ├── 子 Agent 独立推理
    │   ├── 子 Agent 独立调用工具
    │   └── 结果自动汇总
    │
    └── 4. 返回结果摘要
        ├── 子 Agent 的关键发现
        ├── 执行的工具列表
        └── 最终结论

<!-- .claude/agents/code-reviewer.md -->
---
name: code-reviewer
description: Review code for quality, security, and maintainability
tools:
  - FileReadTool
  - GrepTool
  - GlobTool
  - BashTool
model: claude-sonnet-4-6
---
 
You are a code reviewer. Analyze the provided code for:
1. Security vulnerabilities
2. Performance issues
3. Code style violations
4. Missing error handling
 
Provide actionable feedback with specific line references.

// 工具过滤逻辑
function getSubAgentTools(
  agentDef: AgentDefinition,
  parentTools: Tool[]
): Tool[] {
  if (!agentDef.tools) return parentTools  // 继承全部
  
  return parentTools.filter(tool => 
    agentDef.tools!.includes(tool.name)
  )
}

tools/SendMessageTool/
├── SendMessageTool.ts     # 工具主类
└── test/                  # 测试

const inputSchema = z.object({
  to: z.string().describe('接收方: 队友名称或 "*" 广播'),
  message: z.string().describe('消息内容'),
  summary: z.string().optional()
    .describe('消息摘要（5-10个字）'),
})

点对点通信:
  Agent A → SendMessage → Agent B

广播通信:
  Team Lead → SendMessage("*") → 所有队友

// 消息投递机制
async function deliverMessage(msg: Message) {
  if (msg.to === '*') {
    // 广播：投递给所有队友
    for (const teammate of team.members) {
      await teammate.inbox.push(msg)
    }
  } else {
    // 点对点：投递给指定队友
    const teammate = findTeammate(msg.to)
    await teammate.inbox.push(msg)
  }
}

const inputSchema = z.object({
  team_name: z.string().describe('团队名称'),
  description: z.string().optional().describe('团队描述'),
})

const inputSchema = z.object({})
// 自动从当前会话上下文获取团队名称

const inputSchema = z.object({
  name: z.string().optional().describe('Worktree 名称'),
  path: z.string().optional().describe('已有 Worktree 路径'),
})

1. 创建 Git Worktree
   ├── 在 .claude/worktrees/ 下创建新目录
   ├── 基于当前 HEAD 创建新分支
   └── 切换工作目录

2. 在 Worktree 中工作
   ├── 独立的文件系统视图
   ├── 独立的 Git 状态
   └── 不影响主工作区

3. 退出 Worktree
   ├── 选择保留或删除
   └── 切换回原始目录

主 Agent (parent)
  └── 子 Agent (child)
      ├── 共享文件系统
      ├── 独立对话上下文
      └── 返回结果摘要

Team Lead
  ├── Agent A (researcher)
  ├── Agent B (coder)
  └── Agent C (tester)
      ├── 共享任务列表
      ├── 消息通信
      └── 独立工作目录

主 Agent
  └── Worktree Agent
      ├── 独立 Git Worktree
      ├── 不影响主分支
      └── 完成后合并或删除