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

三种技术的核心区别:

维度
Agent Skills
MCP
Sub-agents
知识加载方式
渐进式、按需加载
一次性工具注册
独立上下文窗口
上下文占用
极小(动态加载)
中等(工具定义)
大(完整上下文)
使用场景
学习新框架文档
调用外部工具/API
并行执行任务
学习能力
高(类似人类阅读文档)
低(固定工具调用)
中(预设指令)
为什么Agent Skills更重要:

传统的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
加载流程:
  1. Claude首先读取SKILL.md了解框架概况
  2. 根据任务需求,查询references/中的相关文档
  3. 参考examples/中的代码示例
  4. 遵循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:

ADK是Google推出的多智能体开发框架,支持并行和顺序智能体编排。但Claude Code默认不了解ADK的使用方法,因此需要创建自定义技能。

2.2 准备ADK文档

步骤1:下载官方文档

访问ADK官方文档网站,下载所有HTML格式的文档文件。通常包括:

  • 概述和架构说明
  • Python SDK文档
  • Java SDK文档
  • API参考
  • 示例代码
步骤2:组织文档结构

将下载的文档按照以下结构整理:

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
步骤3:打包为ZIP文件

将整理好的文档打包成adk-documentation.zip,准备提供给Claude。

2.3 使用Skill Creator创建技能

Claude Code内置了一个特殊的"Skill Creator"技能,专门用于从文档创建新技能。

操作步骤: 1. 上传文档包

在Claude Code中,找到Skill Creator功能,上传准备好的adk-documentation.zip文件。

2. 提供上下文描述
这是Google Agent Development Kit (ADK)的完整文档。
ADK是一个多智能体开发框架,支持:
- 创建单个和多个智能体
- 并行和顺序智能体编排
- 工具定义和调用
- 与Google AI模型集成

请基于这些文档创建一个技能包,使Claude能够使用ADK构建多智能体系统。
3. 技能生成过程

Skill Creator会执行以下步骤:

  1. 解压ZIP文件
  2. 分析文档结构(识别HTML层级)
  3. 提取核心概念和API定义
  4. 生成SKILL.md(快速入门指南)
  5. 创建references/目录(详细文档)
  6. 生成examples/目录(代码示例)
  7. 打包成新的技能ZIP文件
生成时间:通常需要2-5分钟,取决于文档规模。

2.4 技能包结构解析

生成的技能包包含以下内容:

SKILL.md(主文件):
# 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

references/(参考文档):
  • agent-creation.md
    :智能体创建详解
  • tool-definition.md
    :工具定义规范
  • orchestration-patterns.md
    :编排模式
  • error-handling.md
    :错误处理
examples/(代码示例):
  • basic-agent.py
    :基础智能体示例
  • multi-agent-parallel.py
    :并行智能体
  • multi-agent-sequential.py
    :顺序智能体
  • custom-tools.py
    :自定义工具

2.5 安装技能到项目

步骤1:创建技能目录结构

在项目根目录创建:

mkdir -p .claude/skills
步骤2:下载并解压技能包

将Skill Creator生成的ZIP文件下载,解压到:

.claude/skills/google-adk/
├── SKILL.md
├── references/
├── examples/
└── development/
步骤3:验证技能可用

在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的执行过程:
  1. 读取技能文档
   [Claude] 正在查看Google ADK技能...
   [Claude] 已理解ADK框架的核心概念
  1. 规划实现
   [Claude] 计划创建以下组件:
   - 产品搜索工具
   - 订单查询工具
   - 客户查询工具
   - 退货处理工具
   - 主客服智能体(协调所有工具)
  1. 生成代码

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",…
— 以上为试看内容(约 40%),开通会员后阅读全文 —