logo
35

Claude Code 子代理配置

⏱️ 15分钟

Claude Code 子代理配置指南

Claude Code 支持创建专业化的子代理 (Sub-agents)，每个代理专注于特定领域的任务。本章介绍如何配置和使用子代理。

什么是子代理

子代理是具有特定专业知识的 AI 助手，可以被 Claude Code 调用来处理特定类型的任务。它们存放在 .claude/agents/ 目录下。

与命令的区别

特性命令 (Commands)子代理 (Agents)
触发方式手动 /<command>自动或手动
专业程度通用任务专业领域
持续性单次执行可持续对话
存放位置.claude/commands/.claude/agents/

代理文件结构

---
name: agent-name
description: 代理描述，Claude 根据此判断何时调用
tools: Read, Write, Edit, Bash
color: blue
---

# 代理标题

你是一个专业的 [角色]...

## 你的专业领域

...

## 工作流程

...

7 个实用子代理

1. pr-reviewer - PR 代码审查专家

专业的代码审查代理，专注于代码质量、安全性和最佳实践。

触发场景： 审查 PR、代码质量检查

配置示例：

---
name: pr-reviewer
description: Expert code reviewer for GitHub pull requests. Provides thorough code analysis with focus on quality, security, and best practices.
tools: Write, Read, Glob, Grep, Bash(gh:*), Bash(git:*)
color: blue
---

审查焦点：

  • 代码正确性 - 逻辑错误、边缘情况、错误处理
  • 项目规范 - 代码风格、命名规范、文件组织
  • 性能影响 - 算法复杂度、查询效率、资源使用
  • 测试覆盖 - 测试用例、边缘测试、测试质量
  • 安全考虑 - 输入验证、认证授权、数据暴露风险

输出格式：

  1. Critical Issues (必须修复) - 安全漏洞、功能性 Bug
  2. Important Suggestions (应该修复) - 性能问题、可维护性
  3. Minor Improvements (可以考虑) - 风格不一致、优化机会

2. github-issue-fixer - Issue 修复专家

专门解决 GitHub Issue 的代理。

触发场景： 修复 Bug、处理 Issue

配置示例：

---
name: github-issue-fixer
description: GitHub issue resolution specialist. Analyzes issues, identifies root causes, and implements fixes.
tools: Read, Write, Edit, Glob, Grep, Bash(gh:*), Bash(git:*)
color: green
---

工作流程：

  1. 获取并分析 Issue 详情
  2. 复现问题
  3. 定位根因
  4. 实施修复
  5. 验证修复
  6. 创建 PR

3. ui-engineer - UI/UX 开发专家

专业的前端开发代理，专注于 UI 组件和用户界面。

触发场景： 前端开发、UI 组件、响应式设计

配置示例：

---
name: ui-engineer
description: Expert UI/frontend developer for creating, modifying, or reviewing frontend code, UI components, and user interfaces. PROACTIVELY use for UI/UX implementation.
tools: Read, Write, Edit, Glob, Grep, Bash, WebFetch
color: purple
---

专业领域：

  • Modern JavaScript/TypeScript
  • React, Vue, Angular 等框架
  • CSS-in-JS, Tailwind CSS
  • 响应式设计和移动优先
  • 组件驱动架构和设计系统
  • 状态管理 (Redux, Zustand)
  • 性能优化和包分析
  • 无障碍 (WCAG) 合规

代码质量标准：

  • 自文档化代码，清晰命名
  • TypeScript 类型安全
  • SOLID 原则
  • 可复用、可组合组件
  • 性能优化但不牺牲可读性

4. instruction-reflector - 指令反思分析

分析和改进 Claude Code 指令的代理。

触发场景： 优化 CLAUDE.md、改进指令

配置示例：

---
name: instruction-reflector
description: Analyzes and improves Claude Code instructions based on session patterns.
tools: Read, Edit, TodoWrite, Bash(git:*)
color: yellow
---

工作流程：

  1. 审查对话历史
  2. 检查当前 CLAUDE.md
  3. 识别改进机会
  4. 提出具体建议
  5. 实施批准的修改

5. deep-reflector - 深度会话分析

综合分析会话的代理，捕获学习和模式。

触发场景： 会话回顾、知识提取

配置示例：

---
name: deep-reflector
description: Comprehensive session analysis and learning capture. Identifies patterns, insights, and improvement opportunities.
tools: Read, Write, TodoWrite
color: orange
---

6. insight-documenter - 洞察文档记录

记录技术突破和重要洞察的代理。

触发场景： 记录技术发现、知识沉淀

配置示例：

---
name: insight-documenter
description: Technical breakthrough documentation specialist. Captures and organizes insights for future reference.
tools: Read, Write, Edit
color: cyan
---

7. command-creator - 命令创建专家

帮助创建新的 Claude Code 命令的代理。

触发场景： 创建自定义命令

配置示例：

---
name: command-creator
description: Expert at creating new Claude Code custom commands. Helps design and implement slash commands.
tools: Read, Write, Edit, Glob
color: pink
---

创建自己的代理

步骤 1：创建代理文件

mkdir -p .claude/agents
touch .claude/agents/my-agent.md

步骤 2：编写代理配置

---
name: my-agent
description: 代理描述 - Claude 根据此判断何时调用
tools: Read, Write, Edit, Bash
color: blue
---

# 我的专业代理

你是一个专业的 [角色]，专注于 [领域]。

## 你的专业领域

-   专业领域 1
-   专业领域 2
-   专业领域 3

## 工作流程

1. 分析需求
2. 制定方案
3. 执行任务
4. 验证结果

## 输出规范

-   使用清晰的结构
-   提供可执行的建议
-   包含代码示例（如适用）

## 注意事项

-   注意点 1
-   注意点 2

代理配置参数

参数说明示例
name代理名称（唯一标识）"pr-reviewer"
description描述（决定何时被调用）"Expert code reviewer..."
tools可用工具列表"Read, Write, Bash"
color显示颜色"blue", "green", "purple"

可用颜色

  • blue - 蓝色
  • green - 绿色
  • purple - 紫色
  • yellow - 黄色
  • orange - 橙色
  • cyan - 青色
  • pink - 粉色
  • red - 红色

代理 vs 命令 vs Skills

特性命令代理Skills
触发手动 /cmd自动/手动自动
专业度中高高
复杂度低中高
文件数1 个1 个多个
最佳用途快速操作专业任务完整工作流

最佳实践

1. 描述要精准

# 好的描述

description: Expert code reviewer for GitHub pull requests. Use when reviewing PRs for code quality and security.

# 不好的描述

description: Reviews code

2. 工具权限最小化

# 好 - 只给需要的权限

tools: Read, Glob, Grep, Bash(gh:\*)

# 不好 - 权限过大

tools: Read, Write, Edit, Bash, WebFetch, TodoWrite

3. 定义清晰的工作流程

## 工作流程

### 1. 信息收集

-   获取必要的上下文
-   理解任务范围

### 2. 分析阶段

-   深入分析问题
-   识别关键点

### 3. 执行阶段

-   实施解决方案
-   验证结果

### 4. 输出阶段

-   整理结果
-   提供建议

4. 设置合适的专业领域

代理应该专注于一个领域，而不是万金油。

推荐代理组合

场景推荐代理
代码审查pr-reviewer
Bug 修复github-issue-fixer
前端开发ui-engineer
指令优化instruction-reflector
知识沉淀insight-documenter

参考资源：feiskyer/claude-code-settings

📚 相关资源