Claude Skill Demo 入门实战：从零构建你的第一个AI技能

1次阅读

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

Claude Skill 是基于 AI 模型的技能开发框架，允许开发者通过 API 调用构建各类智能交互功能。常见应用场景包括：

智能客服对话系统
个性化推荐引擎
自动化数据处理工具
多模态内容生成

API 认证复杂：首次接触 OAuth2.0 等认证协议时，容易在 token 获取环节出错
响应格式处理困难：AI 返回的 JSON 数据结构嵌套较深，提取目标字段需要特殊处理
调试成本高：交互式调试需要模拟完整请求链路，初期难以快速验证功能

安装 Python 3.8+ 环境
创建虚拟环境：
```
python -m venv claude_env
```
安装必要依赖包：
```
pip install requests python-dotenv
```

import os
import requests
from dotenv import load_dotenv

# 加载环境变量
load_dotenv()

CLAUDE_API_KEY = os.getenv('CLAUDE_API_KEY')
WEATHER_API_KEY = os.getenv('WEATHER_API_KEY')

class WeatherSkill:
    def __init__(self):
        self.claude_url = "https://api.claude.ai/v1/skills"
        self.weather_url = "https://api.weatherapi.com/v1/current.json"

    def get_weather(self, location):
        """获取指定地点的天气数据"""
        params = {
            'key': WEATHER_API_KEY,
            'q': location
        }

        try:
            response = requests.get(
                self.weather_url,
                params=params,
                timeout=5
            )
            response.raise_for_status()
            return response.json()
        except requests.exceptions.RequestException as e:
            print(f"Weather API error: {e}")
            return None

    def process_request(self, user_input):
        """处理用户天气查询请求"""
        # 提取地点信息（实际项目应使用 NLP 处理）location = user_input.replace("天气", "").strip()

        # 获取天气数据
        weather_data = self.get_weather(location)

        if not weather_data:
            return "无法获取天气信息，请稍后再试"

        # 构建 Claude 兼容响应
        return {
            "response_type": "text",
            "content": f"{location}当前天气：{weather_data['current']['condition']['text']}，温度{weather_data['current']['temp_c']}℃"
        }

请求参数处理：
使用 params 字典管理 API 参数
对用户输入进行基础清洗
响应数据提取：
通过字典层级访问嵌套字段
添加异常处理防止关键字段缺失

对相同地点的天气数据缓存 5 -10 分钟
使用内存缓存或 Redis 存储临时数据

from datetime import datetime, timedelta

cache = {}

class CachedWeather:
    @staticmethod
    def get(location):
        if location in cache and cache[location]['expire'] > datetime.now():
            return cache[location]['data']
        return None

    @staticmethod
    def set(location, data, ttl=300):
        cache[location] = {
            'data': data,
            'expire': datetime.now() + timedelta(seconds=ttl)
        }