Claude Skill开发入门指南：从零开始构建你的第一个AI技能

1次阅读

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

Claude Skill 是基于 Anthropic Claude AI 模型的扩展能力，允许开发者构建定制化的对话交互功能。它类似于 Alexa Skill 或 Google Action，但专注于更智能的文本交互场景。常见应用包括：

个性化知识问答系统
自动化工作流程助手
智能客服对话引擎
数据分析与可视化工具

基础工具链
Python 3.8+（推荐使用 pyenv 管理版本）
代码编辑器（VS Code/PyCharm）
Postman（用于 API 测试）

必要依赖

pip install anthropic httpx python-dotenv

API 密钥获取
前往 Anthropic 控制台创建项目并获取 API KEY，保存到 .env 文件：
```
CLAUDE_API_KEY=your_key_here
```

在 Anthropic 开发者控制台创建新技能，配置基础信息：

技能名称：WeatherBot
调用短语：” 查询天气 ”
回调 URL：https://your-domain.com/api/weather

import os
import httpx
from dotenv import load_dotenv

load_dotenv()

async def get_weather(city: str) -> dict:
    """调用天气 API 获取数据"""
    async with httpx.AsyncClient() as client:
        resp = await client.get(
            f"https://api.weatherapi.com/v1/current.json",
            params={"key": os.getenv("WEATHER_API_KEY"),
                "q": city,
                "lang": "zh"
            }
        )
        resp.raise_for_status()
        return resp.json()

async def handle_weather_query(params: dict) -> str:
    """处理用户天气查询请求"""
    try:
        city = params["city"]
        data = await get_weather(city)

        return (f"{city}当前天气：{data['current']['condition']['text']}\n"
            f"温度：{data['current']['temp_c']}℃\n"
            f"湿度：{data['current']['humidity']}%"
        )
    except httpx.HTTPStatusError:
        return "天气服务暂时不可用，请稍后再试"
    except KeyError:
        return "请输入有效的城市名称"

sequenceDiagram
    participant User
    participant Claude
    participant Skill

    User->>Claude: "查询北京天气"
    Claude->>Skill: 触发 weather_query 意图
    Skill->>WeatherAPI: 请求天气数据
    WeatherAPI-->>Skill: 返回 JSON 数据
    Skill-->>Claude: 格式化响应
    Claude-->>User: 显示天气信息