Claude Code 中 **Subagent** 与 **Skill** 的核心区别及各自的简单教程

以下是 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 Formatter
description: 自动格式化 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 Reviewer
description: 专注于 Python 代码的规范、安全性和性能检查
allowed-tools: Read, Grep, Bash
color: 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 的自动化与专业水平。