Claude Skills 40分钟构建企业级智能客服系统的完整流程
Anthropic在几天前发布了Claude Skills(智能体技能)功能,这项新特性在某种程度上比Model Context Protocol(MCP)更具实用价值。Claude Skills允许开发者为Claude Code提供定制化的技能包,使其能够理解和使用未曾接触过的开发框架和工具包。
本教程将通过一个完整的实战案例——构建企业级智能客服系统——来演示Claude Skills的核心使用方法。这个系统包含Next.js前端、Clerk用户认证以及基于Google Agent Development Kit(ADK)的多智能体框架。
通过本教程,读者将掌握如何创建自定义技能、将新技术框架文档转化为Claude可用的知识库,以及构建完整的生产级应用。希望对你有所启发。
PART 01 Claude Skills核心概念:超越MCP的渐进式知识加载
1.1 什么是Agent Skills
Agent Skills是Claude Code的一项新功能,它允许开发者将特定技术框架或工具的文档打包成"技能包",供Claude在开发过程中动态加载和使用。与传统的将所有文档一次性塞入上下文窗口的方式不同,Agent Skills采用渐进式加载机制。
- 按需加载
:只在需要时加载相关文档片段 - 层次化结构
:通过目录结构组织知识 - 智能检索
:Claude能够根据任务需求自主查找相关文档 - 持久化知识
:技能包可复用,无需重复提供相同文档
1.2 Agent Skills vs MCP vs Sub-agents
三种技术的核心区别:
传统的MCP如Context7虽然能查询最新文档,但只是"检索"功能——Claude可以看到文档内容,但不一定能深度理解如何使用。而Agent Skills通过结构化的知识组织和渐进式学习,让Claude真正"理解"一个框架的使用方法,类似人类开发者阅读技术文档的过程。
1.3 渐进式知识加载的工作原理
Agent Skills采用层次化的文档结构:
skill-name/
├── SKILL.md # 技能概述和快速入门
├── references/ # 详细API参考文档
│ ├── core-concepts.md
│ ├── api-reference.md
│ └── advanced-topics.md
├── examples/ # 实战代码示例
│ ├── basic-usage.py
│ └── advanced-features.py
└── development/ # 开发指南
├── setup.md
└── best-practices.md
Claude首先读取 SKILL.md了解框架概况根据任务需求,查询 references/中的相关文档参考 examples/中的代码示例遵循 development/中的最佳实践
这种方式避免了一次性加载所有文档导致的上下文污染,同时保证了知识获取的精准性。
PART 02 创建自定义Agent Skill:以Google ADK为例
2.1 项目需求与技术选型
构建一个电商客服系统,支持:
产品信息查询(价格、库存) 订单管理(查询、退货) 客户信息检索 多客服代表独立登录
- 前端
:Next.js - 认证
:Clerk(支持Gmail OAuth) - 多智能体框架
:Google Agent Development Kit (ADK) - AI模型
:Gemini 2.5 Flash
ADK是Google推出的多智能体开发框架,支持并行和顺序智能体编排。但Claude Code默认不了解ADK的使用方法,因此需要创建自定义技能。
2.2 准备ADK文档
访问ADK官方文档网站,下载所有HTML格式的文档文件。通常包括:
概述和架构说明 Python SDK文档 Java SDK文档 API参考 示例代码
将下载的文档按照以下结构整理:
adk-docs/
├── overview.html
├── quickstart/
│ ├── python-quickstart.html
│ └── java-quickstart.html
├── core-concepts/
│ ├── agents.html
│ ├── tools.html
│ └── orchestration.html
├── api-reference/
│ ├── agent-api.html
│ └── tool-api.html
└── examples/
├── basic-agent.html
└── multi-agent-system.html
将整理好的文档打包成adk-documentation.zip,准备提供给Claude。
2.3 使用Skill Creator创建技能
Claude Code内置了一个特殊的"Skill Creator"技能,专门用于从文档创建新技能。
在Claude Code中,找到Skill Creator功能,上传准备好的adk-documentation.zip文件。
这是Google Agent Development Kit (ADK)的完整文档。
ADK是一个多智能体开发框架,支持:
- 创建单个和多个智能体
- 并行和顺序智能体编排
- 工具定义和调用
- 与Google AI模型集成
请基于这些文档创建一个技能包,使Claude能够使用ADK构建多智能体系统。
Skill Creator会执行以下步骤:
解压ZIP文件 分析文档结构(识别HTML层级) 提取核心概念和API定义 生成 SKILL.md(快速入门指南)创建 references/目录(详细文档)生成 examples/目录(代码示例)打包成新的技能ZIP文件
2.4 技能包结构解析
生成的技能包包含以下内容:
# Google ADK Skill## OverviewGoogle Agent Development Kit (ADK) is a framework for building multi-agent AI systems with orchestration capabilities.## Quick Start### Python```pythonfrom google.adk import Agent, Tool# Create a basic agentagent = Agent( name="support_agent", model="gemini-2.5-flash", tools=[search_tool, order_tool])```### Java```javaAgent agent = Agent.builder() .name("support_agent") .model("gemini-2.5-flash") .tools(searchTool, orderTool) .build();```## Core Concepts- Agents: AI entities that can use tools- Tools: Functions agents can call- Orchestration: Sequential and parallel execution
agent-creation.md:智能体创建详解 tool-definition.md:工具定义规范 orchestration-patterns.md:编排模式 error-handling.md:错误处理
basic-agent.py:基础智能体示例 multi-agent-parallel.py:并行智能体 multi-agent-sequential.py:顺序智能体 custom-tools.py:自定义工具
2.5 安装技能到项目
在项目根目录创建:
mkdir -p .claude/skills
将Skill Creator生成的ZIP文件下载,解压到:
.claude/skills/google-adk/
├── SKILL.md
├── references/
├── examples/
└── development/
在Claude Code中,技能会自动被识别。可以通过以下方式验证:
查看 .claude/skills/目录Claude Code会在启动时加载所有技能 可以在对话中要求Claude"查看可用的技能"
PART 03 使用ADK技能构建多智能体客服系统
3.1 项目初始化与需求说明
帮我创建一个多智能体系统用于电商客服支持。
系统要求:
1. 使用Google ADK框架(参考我提供的ADK技能)
2. 创建模拟数据集,包括:
- 产品信息(名称、价格、库存)
- 客户数据
- 订单记录
3. 客服功能:
- 产品查询:查询产品价格和可用性
- 订单管理:查询订单状态、处理退货
- 客户信息:根据客户名称检索信息
4. 智能体编排:
- 使用并行智能体处理独立查询
- 使用顺序智能体处理复杂流程
5. 使用ADK UI界面进行测试
请先查看我提供的Google ADK技能文档,然后基于最佳实践实现。
- 读取技能文档
[Claude] 正在查看Google ADK技能...
[Claude] 已理解ADK框架的核心概念
- 规划实现
[Claude] 计划创建以下组件:
- 产品搜索工具
- 订单查询工具
- 客户查询工具
- 退货处理工具
- 主客服智能体(协调所有工具)
- 生成代码
Claude会创建项目结构并实现所有组件
3.2 核心代码实现解析
# customer_data.py
customers = [
{
"id": "C001",
"name": "Michael Johnson",
"email": "michael@example.com",
"phone": "+1-555-0123"
},
{
"id": "C002",
"name": "Sarah Williams",
"email": "sarah@example.com",
"phone": "+1-555-0456"
}
]
products = [
{
"id": "P001",
"name": "Wireless Headphones",
"price": 79.99,
"stock": 150,
"category": "Audio"
},
{
"id": "P002",
"name": "Samsung 1TB SSD",
"price": 129.99,
"stock": 85,
"category": "Storage"
}
]
orders = [
{
"id": "O001",
"customer_id": "C001",
"products": ["P001", "P002"],
"total": 209.98,
"status": "shipped",
"date": "2025-10-20"
}
]
# tools.py
from google.adk import Tool
# 产品搜索工具
product_search_tool = Tool(
name="search_products",
description="搜索产品信息,支持按名称、类别筛选",
parameters={
"query": {"type": "string", "description": "搜索关键词"},
"category": {"type": "string", "description": "产品类别(可选)"}
},
function=search_products_handler
)
# 客户查询工具
customer_lookup_tool = Tool(
name="find_customer",
description="根据客户名称或ID查询客户信息",
parameters={
"customer_name": {"type": "string", "description": "客户姓名"},
"customer_id": {"type": "string", "description": "客户ID(可选)"}
},
function=find_customer_handler
)
# 订单查询工具
order_lookup_tool = Tool(
name="get_customer_orders",
description="获取客户的所有订单",
parameters={
"customer_id": {"type": "string", "description": "客户ID"}
},
function=get_orders_handler
)
# 退货处理工具
return_tool = Tool(
name="process_return",
description="处理产品退货请求",
parameters={
"order_id": {"type": "string",…