Subagents 子代理

---
name: code-reviewer
description: >-
  Use this agent to review code for quality, security, and best
  practices. Returns structured feedback with actionable suggestions.
tools: Read, Grep, Glob
model: sonnet
---

You are a senior code reviewer. Focus on:

1. Security vulnerabilities
2. Performance issues
3. Code smells
4. Missing tests

Return your review as a bullet list, grouped by severity.

import { query } from "@anthropic-ai/claude-agent-sdk"

async function codeReviewSubagent(file: string) {
  const result = query({
    prompt: `Review the file at ${file}`,
    options: {
      systemPrompt: "You are a senior code reviewer...",
      allowedTools: ["Read", "Grep"],
      model: "claude-sonnet-4-5",
      maxTurns: 5,
    },
  })

  let review = ""
  for await (const msg of result) {
    if (msg.type === "assistant") review += msg.text
  }
  return review
}

{
  "tool": "Agent",
  "input": {
    "subagent_type": "code-reviewer",
    "description": "Review auth module",
    "prompt": "Review src/auth/*.ts for security issues"
  }
}

const a = await subagent("task-a")
const b = await subagent("task-b")  // 等 a 完成才开始

const [a, b, c] = await Promise.all([
  subagent("task-a"),
  subagent("task-b"),
  subagent("task-c"),
])

const prompt = `
上下文：用户正在开发一个 React 项目，使用 TypeScript + Vite。
当前目录：${cwd}
相关文件：${files.join(', ')}

任务：${actualTask}
`

await writeFile(".claude/ctx/current.json", JSON.stringify(context))
// 子代理 prompt："首先读取 .claude/ctx/current.json 了解上下文"

// ❌ 把主代理半个对话历史塞进 prompt
const prompt = `上下文：${JSON.stringify(allHistory)}...`

// ✅ 只传必要信息
const prompt = `任务：${task}\n已知关键信息：${summary}`

const traceId = crypto.randomUUID()
console.log(`[${traceId}] subagent start: ${name}`)
const result = await runSubagent(name, prompt)
console.log(`[${traceId}] subagent done: ${result.length} chars`)

{
  "hooks": {
    "SubagentStop": [{
      "hooks": [{ "type": "command", "command": "bash .claude/hooks/log-sub.sh" }]
    }]
  }
}

// 1. 主 Agent 分析仓库结构
const files = await query({
  prompt: "列出仓库中所有关键源码目录",
  options: { allowedTools: ["Glob", "Read"] },
})

// 2. 对每个模块并行启动子代理
const analyses = await Promise.all(
  modules.map(m =>
    runSubagent("module-analyzer", `分析模块 ${m}：职责、依赖、风险`)
  )
)

// 3. 安全审计子代理（独立上下文）
const security = await runSubagent(
  "security-auditor",
  "扫描整个仓库的安全问题"
)

// 4. 依赖图子代理
const depGraph = await runSubagent(
  "dep-graph-builder",
  "产出模块依赖 mermaid 图"
)

// 5. 主 Agent 汇总
const finalReport = await query({
  prompt: `基于以下材料产出架构报告：
  模块分析：${analyses.join("\n")}
  安全审计：${security}
  依赖图：${depGraph}`,
})