Claude Code Skill 入门指南：从零开始掌握核心开发技巧

1次阅读

没有评论

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

Claude Code Skill 是一个基于人工智能的对话式技能开发框架，允许开发者构建可以集成到各种聊天平台和语音助手中的智能技能。它的核心优势在于提供了丰富的自然语言处理能力，同时保持了高度的可定制性。

常见应用场景包括：

智能客服机器人
语音控制智能家居
企业业务流程自动化
个性化推荐系统

OAuth 认证流程复杂
多个权限作用域需要理解
令牌刷新机制容易出错
回调 URL 配置经常遗漏
请求处理效率低下
未优化的 JSON 解析
同步阻塞式代码结构
缺少必要的缓存机制
错误处理不完善
未捕获第三方 API 异常
用户输入验证不足
错误响应格式不规范

Python 3.8+
pip 20.0+
虚拟环境（推荐 venv）

创建项目目录
```
mkdir weather_skill && cd weather_skill
```

设置虚拟环境

python -m venv venv
source venv/bin/activate  # Linux/macOS
venv\Scripts\activate    # Windows

安装核心依赖

pip install fastapi uvicorn requests python-jose[cryptography]

weather_skill/
├── main.py          # 主应用入口
├── auth.py          # 认证相关逻辑
├── weather.py       # 天气服务实现
├── schemas.py       # Pydantic 模型定义
├── requirements.txt # 依赖文件
└── tests/           # 测试目录

from fastapi.security import OAuth2AuthorizationCodeBearer
from jose import jwt
from datetime import datetime, timedelta

# 配置 OAuth2
oauth2_scheme = OAuth2AuthorizationCodeBearer(
    authorizationUrl="https://auth.claude.ai/authorize",
    tokenUrl="https://auth.claude.ai/token",
    scopes={"weather.read": "读取天气信息"}
)

# 示例配置 - 生产环境应从环境变量读取
SECRET_KEY = "your-secret-key"
ALGORITHM = "HS256"
ACCESS_TOKEN_EXPIRE_MINUTES = 30

def create_access_token(data: dict):
    to_encode = data.copy()
    expire = datetime.utcnow() + timedelta(minutes=ACCESS_TOKEN_EXPIRE_MINUTES)
    to_encode.update({"exp": expire})
    return jwt.encode(to_encode, SECRET_KEY, algorithm=ALGORITHM)

from fastapi import FastAPI, Depends, HTTPException
from fastapi.responses import JSONResponse
from typing import Optional
import requests

app = FastAPI()

# 模拟天气 API
WEATHER_API = "https://api.weatherapi.com/v1/current.json"
API_KEY = "your-weather-api-key"  # 应使用环境变量

@app.get("/weather")
async def get_weather(
    location: str,
    token: str = Depends(oauth2_scheme)
):
    """
    获取指定位置的天气信息
    :param location: 城市名称或邮编
    :return: 格式化天气数据
    """
    try:
        # 调用第三方天气 API
        params = {
            "key": API_KEY,
            "q": location,
            "aqi": "no"
        }
        response = requests.get(WEATHER_API, params=params)
        response.raise_for_status()

        # 解析响应数据
        weather_data = response.json()

        # 构建 Claude Skill 响应格式
        return {
            "version": "1.0",
            "response": {
                "outputSpeech": {
                    "type": "PlainText",
                    "text": f"{location}当前气温 {weather_data['current']['temp_c']} 度"
                }
            }
        }
    except requests.exceptions.RequestException as e:
        raise HTTPException(
            status_code=502,
            detail=f"天气服务不可用: {str(e)}"
        )

from functools import lru_cache
import time

@lru_cache(maxsize=100)
def get_cached_weather(location: str):
    """带缓存的天气查询"""
    return get_weather(location)  # 实际实现需要移除 OAuth 依赖

from fastapi import Request
from fastapi.responses import JSONResponse

@app.exception_handler(Exception)
async def global_exception_handler(request: Request, exc: Exception):
    return JSONResponse(
        status_code=500,
        content={
            "error": {
                "message": "内部服务器错误",
                "code": "INTERNAL_ERROR",
                "details": str(exc)
            }
        }
    )

import httpx

async def async_get_weather(location: str):
    async with httpx.AsyncClient() as client:
        response = await client.get(WEATHER_API, params={"q": location})
        return response.json()