基于最新资料整理的Claude Code 中 Subagent 与 Skill 的核心区别及各自的简单教程，适合初学者快速上手。
一、Subagent 与 Skill 的核心区别
| 特性 | Skill | Subagent |
|---|---|---|
| 定义 | 自动触发的“能力插件”，用于完成特定小任务 | 专业子代理，像一个小型 AI 专家，处理复杂任务 |
| 触发方式 | 自动识别（Claude 根据上下文判断是否调用） | 可自动委派，也可手动指定（如 /use code-reviewer） |
| 上下文 | 与主会话共享上下文 | 拥有独立的上下文窗口，不干扰主会话 |
| 适用场景 | 简单、重复性任务，如格式化、命名规范检查 | 复杂、多步骤任务，如代码审查、重构、性能分析 |
| 配置方式 | 创建一个文件夹，包含 SKILL.md 和可选脚本 | 创建一个 .md 文件，定义角色、任务、工具权限等 |
| 并发能力 | 不支持并发 | 支持并发，最多可并行运行 49 个子代理 |
二、Skill 简单教程（自动能力插件）
📁 1. 创建 Skill 文件夹结构
my-skill/├── SKILL.md # 必填：技能说明├── FORMS.md # 可选：表单填写指南├── REFERENCE.md # 可选：API 文档└── scripts/ └── example.py # 可选：辅助脚本
📝 2. 编写 SKILL.md
—name: JSON Formatterdescription: 自动格式化 JSON 文件allowed-tools: Read, Edit, Bash—# JSON Formatter## 说明当用户提到“格式化 JSON”时，使用此技能。## 示例- 用户说“帮我格式化这个文件”，你读取文件 → 使用 `jq` 格式化 → 保存。
📍 3. 放置位置
- 个人使用：~/.claude/skills/json-formatter/
- 项目使用：.claude/skills/json-formatter/
启动 Claude Code 后，它会自动加载这些技能，并在合适时调用。
三、Subagent 简单教程（专业子代理）
📄 1. 创建 Subagent 文件
路径：.claude/agents/code-reviewer.md（项目级）或 ~/.claude/agents/（用户级）
—name: Code Reviewerdescription: 专注于 Python 代码的规范、安全性和性能检查allowed-tools: Read, Grep, Bashcolor: red—# Code Reviewer## 职责- 检查代码是否符合 PEP8- 查找潜在 bug 和安全漏洞- 提供优化建议## 工作方式1. 读取目标文件2. 使用工具分析代码结构3. 输出审查报告
▶ 2. 使用方式
- 自动委派：Claude 判断任务适合时自动调用
- 手动调用：在对话中输入： > 用 code-reviewer 检查这个文件：main.py
⚙️ 3. 并发使用（高级）
你可以同时启动多个子代理处理不同模块，例如：
> 启动前端审查代理检查 src/components/> 启动后端审查代理检查 api/
总结：什么时候用哪个？
| 场景 | 推荐 |
|---|---|
| 自动格式化、命名检查、轻量脚本 | ✅ 使用 Skill |
| 多步骤任务、代码审查、重构、性能分析 | ✅ 使用 Subagent |
| 想快速共享能力给团队 | ✅ 用 Skill 打包成 Plugin |
| 想并行处理多个复杂任务 | ✅ 用多个 Subagent |
如需进一步学习，推荐从 Skill 开始练手，再逐步尝试 Subagent 的并发与分工能力。两者结合使用，能极大提升 Claude Code 的自动化与专业水平。
评论(0)