官方文档：code.claude.com/docs/en/cli…
提示词最佳实践：platform.claude.com/docs/zh-CN/…
1. 核心概念
1.1 子代理（Subagents）
-
定义：专门处理特定任务的 AI 模块，Claude Code 可以自动调用它们完成任务。
-
作用：
- 自动处理任务
- 提高效率和准确性
- 分工明确，避免主 Claude 被杂务影响
-
特点：
- 每个子代理有独立上下文（Context）
- 可配置可访问工具
- 可定义系统提示（system prompt）指导行为
1.2 Agents vs Skills
| 项目 | Agent（代理） | Skill（技能） |
|---|---|---|
| 定义 | 独立 AI 助理实例，有完整配置 | 可被 Agent 自动调用的“能力包” |
| 生命周期 | 启动一个 Agent = 开启会话 | 在对话中动态启用/停用 |
| 触发方式 | 用户手动选择 | Claude 自动判断何时启用 |
| 配置文件 | agent.json | SKILL.md |
| 独立运行 | 可以 | 不可以，必须由 Agent 调用 |
| 目标 | 定义“谁来工作” | 定义“Agent 会哪些技能” |
-
*插件（Plugin）**通常包含多个 Skill：
Plugin (扩展包/插件) └── 包含 Skills（能力模块） -
安装插件后会自动获得相关 Skills，无需手动编写。
2. 子代理操作指南
2.1 查看可用子代理
> /agents
- 列出系统自带或已创建的所有子代理
- 显示类型、用途等信息
2.2 使用子代理
自动使用
Claude Code 根据任务类型自动选择子代理：
> review my recent code changes for security issues
> run all tests and fix any failures
手动指定
> use the code-reviewer subagent to check the auth module
> have the debugger subagent investigate why users can't log in
-
示例子代理：
code-reviewer：代码审查debugger：错误调试
2.3 创建自定义子代理
- 进入命令：
> /agents
选择 “Create New subagent” 。
- 配置内容：
- Subagent type：类型（如性能优化、API 设计）
- When to use it：触发条件
- Tools it can access：可访问工具
- Specialized system prompt：专用系统提示
- 存放位置：
.claude/agents/
- 团队成员可共享使用
2.4 使用建议
- 子代理描述清晰，便于自动委派
- 限制访问权限，保证安全
- 支持项目级共享，提高团队协作效率
3. 推荐资源（按热度）
| 序号 | 仓库 | Stars | 特点 | 适合 |
|---|---|---|---|---|
| 1 | anthropics/claude-code | 43.2k+ | 官方仓库，核心功能示例 | 所有人，必装基础 |
| 2 | wshobson/agents | 21.2k+ | 63插件，85 agents，47技能 | 全面工具集开发者 |
| 3 | VoltAgent/awesome-claude-code-subagents | 5k+ | 100+生产就绪 agents | 企业级开发 |
| 4 | dl-ezo/claude-code-sub-agents | 活跃维护 | 35子agents，6类开发流程覆盖 | 完整软件开发流程 |
| 5 | lst97/claude-code-sub-agents | 1.2k+ | 个人优化，轻量全栈 | 个人项目、初创公司 |
4. 核心总结
-
子代理是 Claude Code 的专业助手，只处理特定任务。
-
支持 自动委派 和 手动调用。
-
可创建 自定义子代理，支持团队共享。
-
配置包括：
- 类型
- 触发条件
- 可访问工具
- 系统提示
-
Agents定义“谁来工作”，Skills定义“Agent 能做什么”，通过插件自动扩展。
5. 自动化示例
生成日报示例：
claude -p "根据 logs/今日.txt 生成日报" --output-format text
- Claude 会自动选择合适子代理处理任务。
- 输出格式可自定义。
