Claude Skills & SubAgent 完全指南：从入门到精通，打造你的专属AI开发助手
📑 目录
一、引言
二、自定义 Skill
三、ClawHub Skills
四、Claude Code 模型
五、Claude Code 子 Agent (SubAgent)
🚀 引言：为什么你需要掌握 Claude Skills & SubAgent？
在 AI 辅助开发的浪潮中，Claude Code 的 Skills（技能） 和 SubAgent（子代理） 两大核心功能，正成为开发者提升效率的“双引擎”。如果你经常在开发中面临重复性任务、复杂工作流或需要专业化 AI 助手分工协作，那么掌握这两项功能将彻底改变你的工作方式。
🔥 Skills & SubAgent：双剑合璧，效率倍增
Skills（技能） 是 Claude Code 中用于扩展 AI 能力的可复用指令集，它允许你将复杂的操作流程、检查清单或特定任务指南封装为独立的“技能包”。当你在聊天中反复粘贴相同的指令时，就该考虑创建一个 Skill 了。
SubAgent（子代理） 则是 Claude Code 的高级特性，允许你将特定类型的任务委派给运行在独立上下文中的专用 AI 助手，实现更好的上下文隔离、更精准的行为约束和更高效的任务执行。
两者的协同关系：
- Skills 是“工具包”：封装具体操作步骤和知识
- SubAgent 是“专家助手”：拥有独立上下文和专业化角色
- Skills 可以被 SubAgent 调用：专家助手可以使用专门的技能工具
- SubAgent 可以并行执行多个 Skills：实现复杂工作流的自动化
👥 适用人群
- 个人开发者：希望减少重复劳动，建立个人效率工具箱
- 团队技术负责人：需要统一团队开发规范，确保代码质量一致性
- DevOps 工程师：需要自动化部署、测试、监控等复杂流程
- 技术文档工程师：希望自动化生成和维护项目文档
- AI 工具深度用户：追求极致效率，希望将 Claude 打造成专属“瑞士军刀”
- 项目架构师：需要多个 AI 助手分工协作处理复杂项目
🎯 典型应用场景
| 场景类型 | Skills 应用 | SubAgent 应用 | 效率提升 |
|---|---|---|---|
| 代码质量 | 代码审查、安全检查、代码格式化 | 专用代码审查助手、安全审计专家 | 节省 70% 审查时间 |
| 开发流程 | Commit 消息生成、PR 描述 | 自动化工作流协调员、版本发布经理 | 标准化团队流程 |
| 文档生成 | API 文档模板、README 生成 | 文档专家、技术写作助手 | 自动生成，减少 80% 手动编写 |
| 测试验证 | 单元测试模板、接口测试脚本 | 测试工程师、性能测试专家 | 一键生成测试用例 |
| 部署运维 | 部署脚本、环境检查 | 运维专家、监控告警专员 | 减少人为操作失误 |
| 复杂项目 | 多个技能组合 | 多个子代理并行协作 | 任务分解，并行执行 |
📦 Skills 工作机制：三阶段智能加载
Claude Code 采用智能的“按需加载”机制，确保 Skills 既强大又高效：
- 发现阶段：启动时仅加载技能名称和简要描述，占用极小的上下文空间
- 激活阶段：当任务与技能描述匹配时，自动读取完整的
SKILL.md指令 - 执行阶段：Claude 遵循指令执行，可调用脚本、读取文件或执行复杂操作
这种机制意味着：你可以拥有数十个 Skills，而不会拖慢 Claude 的响应速度。
🤖 SubAgent 核心优势：专业化分工
SubAgent = 独立上下文 + 专家角色 + 权限隔离 + 并行执行 + 可复用模板 + 模型动态路由。
- 独立上下文隔离：每个 SubAgent 拥有完全独立的 context window，不占用主会话 token
- 角色专精：可配置为代码审查、测试生成、文档、安全审计等专家角色
- 权限控制：精细化控制每个子代理的读写权限和工具访问范围
- 并行执行：支持多个子代理同时工作，大幅提升复杂任务处理效率
- 模型优化：为不同任务分配最适合的模型（Opus/复杂推理、Haiku/简单任务）
🛠️ 快速上手：从 0 到 1 构建你的 AI 助手生态
Skills 创建基础：
SKILL.md文件：定义技能功能、使用方法和执行指令- 可选脚本/资源：支持 Python、Shell 等脚本，可集成外部工具
- 参数化设计：支持
$ARGUMENTS、$1、$2等占位符，灵活适配不同场景
SubAgent 进阶能力：
- 项目级代理：
.claude/agents/目录，团队共享、纳入 Git - 用户级代理：
~/.claude/agents/目录，个人全局可用 - 内置代理：General Agent、Plan Agent、Explore Agent 开箱即用
- 自定义代理：code-reviewer、test-writer、docs-writer 等专业化助手
本文你将学到：
- ✅ 个人级 Skills：创建属于你自己的效率工具
- ✅ 项目级 Skills：团队共享，统一开发规范
- ✅ 公共 Skills 库：从 ClawHub 获取现成技能
- ✅ 模型选型指南：为不同任务选择最优 AI 模型
- ✅ SubAgent 高级用法：创建专业化 AI 助手，实现任务委派与并行协作
无论你是 Claude Code 的新手还是资深用户，掌握 Skills 和 SubAgent 的组合使用，将让你的开发效率提升一个数量级，并实现真正的 AI 助手专业化分工。让我们开始吧！我们开始吧！)
自定义 Skill
个人级 Skill 案例
创建 skills 目录
创建审查代码技能SKILL.md 文件：
SKILL 中可以使用 $ARGUMENTS 占位符向命令传递参数，也可以使用位置参数 $1、$2… 来访问各个参数。
在项目中，使用测试 skill
- 输入 SKILL 名称，可关联到对应 SKILL：
此处code-review存在多个，可通过描述选择对应的一个 SKILL。
- 添加参数匹配 SKILL 文档中的占位符：
- 使用 SKILL 完成代码审查的任务处理：
项目级 Skill 案例演示
创建 skills 目录及 skill
在当前项目中创建“<项目根目录>/.claude/skills/”目录，然后在该 skills 目录下创建对应的技能名称目录，该目录中创建 SKILL.md，写入技能内容：
查看 skills
执行 skills 命令可以看到有一个项目的 skill，另外一个用户的 skill 是之前创建的代码审查 SKILL。
测试项目 skill
SKILL 调用后的效果：
ClawHub Skills
Claude Code 中还可以通过 ClawHub 搜索公开、免费的 Skill。ClawHub 是 OpenClaw 的官方公共技能中心，完全免费开放且每个 skill 都有版本历史。如果想为 OpenClaw 助手添加新功能，ClawHub 是最简单的查找和安装技能的方式。
ClawHub 地址：https://clawhub.ai/skills
一个中国 Skills 网站：https://hub.cocoloop.cn/
进入 cocoloop 找到对应技能进行安装：
将下载的 zip 包解压后复制技能到 skills 包下即可使用：
如果需要 API key 的则需要在 skill 代码实现中进行 API key 的配置后再使用。
Claude Code 模型
使用 /model 命令，可查看使用的模型。
Opus 4.8（默认）：具备强大的推理能力，适合复杂架构设计、算法优化、系统设计，支持 100 万 token。
Sonnet 4.6：日常编码任务的最佳平衡点，支持 100 万 token，适合大多数编程任务、代码审查、调试。
Haiku 4.5：轻量高效，响应速度最快，成本最低，适合简单查询、语法检查、代码片段生成。
deepseek-chat（使用中）：国产价格杀手，综合能力接近 GPT-4，价格仅为其 1/10 级别，推理强大，国内个人和非地主企业玩家的最优选择。
一、Claude Opus 4.8（Anthropic 旗舰）
简介 2026-05-28 发布的 Claude 旗舰模型，定位“最强推理 + 最强工程能力”，综合能力接近 GPT-5.5。
核心能力 & 优势
- 最强代码能力：SWE-bench 88.6%，SWE-pro 69.2%，超越 GPT-5.5、Gemini 3.1
- 超大上下文：100 万 token，可整仓分析、超长文档处理
- 复杂推理 & 诚实性：长链式推理、数学/法律/金融专业分析；敢于说不确定，降低误导风险
- 智能体（Agent）：支持 Dynamic Workflows，可并行调度上百个子 Agent，适合复杂长周期任务
适用场景
- 大型项目架构设计、复杂代码重构、遗留系统改造
- 法律/合同/财报深度分析、学术论文研读、科研辅助
- 高风险决策、需要严谨推理与可解释性的场景
- 超长文档（整本书、代码库）深度理解与生成
使用价格（API，2026-05）
- 输入：$5 / 1M token
- 输出：$25 / 1M token
- 上下文：1,000,000 token
二、Claude Sonnet 4.6（平衡旗舰）
简介 Claude 主力平衡型模型，定位“80% Opus 能力，1/5 价格”，企业日常首选。
核心能力 & 优势
- 综合能力强：SWE-bench 79.6%，接近 Opus，显著领先普通模型
- 百万上下文：100 万 token，支持长文档/长对话
- 性价比极高：能力≈GPT-4，价格≈1/3，90% 企业场景最优解
- 响应快、稳定：推理速度优于 Opus，适合高频调用
适用场景
- 企业日常开发、中等复杂度代码生成/审查
- 内容创作、文案、翻译、知识问答
- 长文档摘要、知识库问答、企业内部助手
- 中小规模 Agent、自动化工作流
使用价格（API，2026-05）
- 输入：$3 / 1M token
- 输出：$15 / 1M token
- 上下文：1,000,000 token
三、Claude Haiku 4.5（极速低成本）
简介 Claude 轻量极速模型，定位“毫秒级响应 + 极低成本”，主打高并发、实时场景。
核心能力 & 优势
- 极快响应：毫秒级，适合对话、客服、实时交互
- 超低成本：输入 $1、输出 $5，大规模调用成本极低
- 稳定可靠：长对话不掉线，多轮记忆好
- 20 万上下文：足够日常对话、短文档处理
适用场景
- 在线客服、聊天机器人、实时问答
- 高频文案生成、批量内容处理、数据清洗
- 移动端/小程序 AI 助手、低延迟交互
- 大规模 API 调用、成本敏感业务
使用价格（API，2026-05）
- 输入：$1 / 1M token
- 输出：$5 / 1M token
- 上下文：200,000 token
四、deepseek-chat（深度求索，国产高性价比）
简介 DeepSeek 通用对话模型（V3.2），国产价格杀手，综合能力接近 GPT-4，价格仅为其 1/10 级别。
核心能力 & 优势
- MoE 架构：671B 总参数，37B 激活，推理快、成本低
- 中文极强：中文理解/生成、文化适配优于多数国际模型
- 100 万上下文：支持超长文本、整仓分析
- 全能型：对话、代码、创作、翻译、工具调用均强
- 开源+私有化：可本地部署，数据安全可控
适用场景
- 国内企业日常 AI 服务、中文内容创作/审核
- 代码辅助、脚本生成、数据处理
- 知识库问答、长文档摘要、本地化部署
- 成本敏感、高并发、中文为主场景
使用价格（API，2026-05，人民币）
- 输入：¥0.28 / 1M token（缓存命中 ¥0.02）
- 输出：¥0.42 / 1M token
- 上下文：1,000,000 token
快速选型一句话
- 要最强能力、不差钱 → Opus 4.8
- 企业日常、性价比第一 → Sonnet 4.6
- 高并发、毫秒响应、极致省钱 → Haiku 4.5
- 中文为主、国产、低价、可私有化 → deepseek-chat
Claude Code 子 Agent (SubAgent)
子 Agent (SubAgent) 是 Claude Code 中一项强大的特性，允许你将特定类型的任务委派给运行在独立上下文中的专用 AI 助手，从而实现更好的上下文隔离、更精准的行为约束和更高效的任务执行。
SubAgent = 独立上下文 + 专家角色 + 权限隔离 + 并行执行 + 可复用模板 + 模型动态路由。
子 Agent 特点
子代理具备如下特点：
- 独立上下文隔离（最关键）
每个 SubAgent 拥有完全独立的 context window，不占用主会话 token。主会话始终干净，不会被探索、分析、长文本污染。子 Agent 启动时不带主会话历史，思考更聚焦、更稳定。
一句话：主会话做架构 / 统筹，子 Agent 做脏活累活，互不干扰。
- 角色专精 + 自定义系统提示
每个 SubAgent 是专属专家：代码审查、测试生成、文档、安全审计、架构设计等。可配置定制 system prompt，精确控制行为、输出格式、专业深度。支持技能注入（skills），自动加载指定知识库 / 规范。
- 权限与工具精细化控制（安全强）
每个子 Agent 可单独设置：
- 可用工具（Read / Glob / Grep / Edit / Write 等）
- 权限模式（只读 / 可编辑 / 受限命令）
- 可访问的文件范围、MCP 服务器
例如：代码审查子 Agent 只能读，不能改；实现子 Agent 可写但不能删文件。
- 并行执行 + 后台运行（效率高）
支持多子 Agent 并行跑，同时查代码、写逻辑、跑测试。可前台（阻塞）或后台（异步）执行：
前台：等结果返回再继续
后台：不阻塞主会话，适合长任务（爬虫、大代码分析）
主 Agent 自动拆分复杂任务、分配给子 Agent、最后统一整合。
- 可复用 + 可共享（工程化）
子 Agent 可定义为：
项目级（.claude/agents/）：团队共享、纳入 Git
用户级（~/.claude/agents/）：个人全局可用
一次定义，所有项目自动识别并调用。
支持断点续跑（resumable）：长任务可暂停、继续，保留完整上下文。
- 模型可切换（成本可控）
每个 SubAgent 可指定模型：
Opus：复杂推理、架构、安全
Sonnet：日常开发、审查、文档
Haiku：快速搜索、格式整理、批量处理。把简单任务丢给 Haiku，大幅降低成本、提升速度。
deepseek：使用自定义模型，国内性价比首选。
- 内置 + 自定义双模式
内置 SubAgent（开箱即用）：
General Agent：通用复杂任务
Plan Agent：先调研代码库，再出方案
Explore Agent：只读、高速代码搜索
自定义 SubAgent（常用示例）：
code-reviewer（只读审查）
test-writer（生成单元测试）
docs-writer（注释 / 文档补全）
security-checker（漏洞扫描）
refactor-agent（重构专用）Claude
Claude Code 内置的 SubAgent
手动创建 SubAgent
可以通过手动创建 MD 文件来创建 subagents 的方式，这种方式可以将 subagent 创建在当前项目的“.claude/agents”目录下或者安装 Claude 的“~/.claude/agents”目录下，前者是项目级子 Agent，后者是用户级子 Agents，然后再在对应的 /agents 目录中创建对应的 md 文件即可。
创建 subgent.md 文件
SubAgent 参数说明：
SubAgent 的查看：
SubAgent 使用在该项目中重新启动 Claude，然后输入 /agents 可以看到对应的 Agent：
16
0- 0
已为社区贡献3条内容
所有评论(0)