Claude Skill 入门指南：从零开始构建你的第一个 AI 助手

1次阅读

共计 2350 个字符，预计需要花费 6 分钟才能阅读完成。

Claude Skill 是 Anthropic 公司推出的 AI 助手开发框架，它允许开发者基于 Claude 大模型快速构建定制化的对话技能。你可以把它想象成给 Claude 这个聪明的大脑添加各种 ’ 小技能 ’，比如查天气、订餐厅、回答问题等。

这些技能可以部署在各种渠道，比如网站聊天窗口、移动应用，甚至是智能音箱。对于开发者来说，最大的优势是不需要从头训练模型，直接利用 Claude 强大的自然语言理解能力，专注于业务逻辑的实现。

在开始构建你的第一个 Claude Skill 前，需要准备好以下工具和环境：

注册 Anthropic 开发者账号（访问 Anthropic 官网）
安装 Python 3.8 或更高版本
准备一个代码编辑器（推荐 VS Code 或 PyCharm）
安装 Claude Skill SDK

让我们一步步完成环境配置：

# 1. 检查 Python 版本
python --version

# 2. 安装 Claude Skill SDK
pip install anthropic-skill-sdk

# 3. 获取 API 密钥
# 登录 Anthropic 控制台，在开发者设置中创建新的 API 密钥

每个 Claude Skill 都需要一个清晰的技能定义文件（skill_definition.yml），它描述了技能的基本信息和能力范围。

name: weather_skill
description: 提供全球城市天气查询服务
version: 1.0.0

intents:
  - name: query_weather
    description: 查询指定城市的天气情况
    examples:
      - "今天北京天气怎么样"
      - "上海明天的气温"
      - "纽约周末会下雨吗"

Claude 会自动处理自然语言理解部分，我们只需要定义好预期的用户意图。下面是一个简单的 Python 实现：

from anthropic_skill_sdk import Skill, Request, Response

skill = Skill(__name__)

@skill.intent_handler('query_weather')
def handle_weather_query(request: Request) -> Response:
    """
    处理天气查询请求
    Args:
        request: 包含用户输入和上下文信息
    Returns:
        包含天气信息的响应
    """
    # 从用户输入中提取城市名称
    city = request.entities.get('city')

    if not city:
        return skill.response('请问您想查询哪个城市的天气？')

    # 这里应该调用天气 API 获取实际数据
    weather_data = get_weather_data(city)

    return skill.response(f"{city} 今天的天气是 {weather_data['condition']}，气温 {weather_data['temp']}℃")

# 模拟天气 API 调用
def get_weather_data(city: str) -> dict:
    """模拟天气数据获取"""
    # 实际项目中这里应该调用真实的天气 API
    return {
        'condition': '晴朗',
        'temp': 25
    }

if __name__ == '__main__':
    skill.serve()

一个好的对话技能需要考虑多种用户交互场景：

用户明确提供城市名称
用户：” 北京今天天气如何？”
助手：” 北京今天的天气是晴朗，气温 25℃”
用户未指定城市
用户：” 查下天气 ”
助手：” 请问您想查询哪个城市的天气？”
用户：” 上海 ”
助手：” 上海今天的天气是 …”
处理未知城市
用户：” 查下火星的天气 ”
助手：” 抱歉，我暂时无法获取火星的天气信息 ”

实际项目中，你需要集成真实的天气 API。这里以和风天气为例：

import requests

def get_real_weather(city: str, api_key: str) -> dict:
    """调用和风天气 API"""
    base_url = "https://devapi.qweather.com/v7/weather/now"
    params = {
        'location': city,
        'key': api_key
    }

    try:
        response = requests.get(base_url, params=params)
        data = response.json()

        if data['code'] == '200':
            return {'condition': data['now']['text'],
                'temp': data['now']['temp']
            }
        else:
            return None
    except Exception as e:
        print(f"天气 API 调用失败: {e}")
        return None

在开发 Claude Skill 过程中，新手常会遇到以下问题：