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

1次阅读

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

Claude Skills 是 Anthropic 公司推出的 AI 助手开发框架，允许开发者创建自定义的对话技能。简单来说，就是让你能教会 Claude 完成特定任务的能力，比如查询天气、订餐、翻译等。它类似于 Alexa Skills 或 Google Actions，但专门针对 Claude 对话模型优化。

这些技能可以用于：

个人助手（提醒、查询等）
企业客服自动化
教育领域的智能辅导
娱乐和游戏互动

首先需要访问 Anthropic 开发者平台（https://developer.anthropic.com）注册账号。目前需要申请等待名单，获批后会收到邀请邮件。

推荐使用 Python 作为开发语言，需要安装：

Python 3.8 或更高版本
pip 包管理器
Claude Skills SDK（安装命令如下）

pip install anthropic-sdk

建议使用 VS Code 或 PyCharm 作为 IDE，并安装以下插件：

Python 扩展
REST Client（用于测试 API）
Git（版本控制）

我们要创建一个能回答用户天气查询的技能。基本功能包括：

识别用户询问天气的意图
提取地点和时间信息
调用天气 API 获取数据
以自然语言回复

典型的对话流程如下：

用户：” 今天纽约天气怎么样？”
Claude：识别为天气查询意图
技能：提取地点（纽约）、时间（今天）
技能：调用天气 API
Claude：” 纽约今天晴天，最高 25°C，最低 18°C”

创建一个 weather_skill.py 文件：

import requests
from typing import Dict, Any
from anthropic import Anthropic

# 初始化 Claude 客户端
client = Anthropic(api_key="你的 API 密钥")

# 天气 API 配置（示例使用 OpenWeatherMap）WEATHER_API_KEY = "你的天气 API 密钥"
BASE_URL = "https://api.openweathermap.org/data/2.5/weather"


def get_weather(location: str, date: str) -> Dict[str, Any]:
    """调用天气 API 获取数据"""
    params = {
        "q": location,
        "appid": WEATHER_API_KEY,
        "units": "metric",
        "lang": "zh_cn"
    }
    response = requests.get(BASE_URL, params=params)
    return response.json()


def format_weather_response(weather_data: Dict[str, Any]) -> str:
    """格式化天气数据为自然语言"""
    main = weather_data["main"]
    weather = weather_data["weather"][0]

    return (f"当前气温：{main['temp']}°C，{weather['description']}。\n"
        f"最高温度：{main['temp_max']}°C，最低温度：{main['temp_min']}°C。\n"
        f"湿度：{main['humidity']}%，风速：{weather_data['wind']['speed']}m/s。"
    )


def handle_weather_query(user_input: str) -> str:
    """处理天气查询"""
    # 这里应添加 NLU 代码来提取地点和时间
    # 简化示例直接使用固定值
    location = "New York"
    date = "today"

    try:
        weather_data = get_weather(location, date)
        return format_weather_response(weather_data)
    except Exception as e:
        return f"获取天气信息时出错：{str(e)}"


# 示例使用
if __name__ == "__main__":
    user_query = "今天纽约天气怎么样？"
    response = handle_weather_query(user_query)
    print(response)

单元测试：使用 Python 的 unittest 模块测试各个函数

import unittest
from weather_skill import format_weather_response

class TestWeatherSkill(unittest.TestCase):
    def test_format_response(self):
        test_data = {"main": {"temp": 22, "temp_max": 25, "temp_min": 18, "humidity": 65},
            "weather": [{"description": "晴天"}],
            "wind": {"speed": 3.2}
        }
        result = format_weather_response(test_data)
        self.assertIn("22°C", result)
        self.assertIn("晴天", result)

if __name__ == "__main__":
    unittest.main()