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

1次阅读

没有评论

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

Claude Code 官方 Skill 是一种可以扩展 Claude AI 功能的开发框架，允许开发者创建自定义技能。这些技能可以被 Claude 调用，实现特定领域的智能交互。一个完整的 Skill 包含以下核心组件：

Manifest 文件：技能的描述文件，定义了技能的名称、版本、权限等信息
入口函数：处理用户请求的核心逻辑
API 集成：与外部服务的交互接口

首先需要安装必要的开发工具：

安装 Python 3.8+（推荐使用虚拟环境）
安装 Claude SDK：pip install claude-sdk
准备一个天气 API（这里使用 OpenWeatherMap）

创建manifest.json，这是技能的配置文件：

{
  "name": "weather_forecast",
  "version": "1.0.0",
  "description": "提供全球城市天气预报",
  "permissions": ["network"],
  "entry_point": "weather.py"
}

创建weather.py，实现天气预报功能：

import requests
from claude import Skill

class WeatherSkill(Skill):
    def __init__(self):
        self.api_key = "your_openweather_api_key"  # 替换为你的 API 密钥
        self.base_url = "https://api.openweathermap.org/data/2.5/weather"

    def handle_request(self, request):
        """
        处理天气查询请求
        :param request: 包含用户输入和上下文
        :return: 天气信息响应
        """city = request.get("city")
        if not city:
            return {"error": "请提供城市名称"}

        try:
            # 调用天气 API
            params = {
                "q": city,
                "appid": self.api_key,
                "units": "metric",
                "lang": "zh_cn"
            }
            response = requests.get(self.base_url, params=params)
            data = response.json()

            if response.status_code != 200:
                return {"error": f"获取天气失败: {data.get('message',' 未知错误 ')}"}

            # 解析天气数据
            weather = {"city": data["name"],
                "temp": data["main"]["temp"],
                "description": data["weather"][0]["description"],
                "humidity": data["main"]["humidity"]
            }

            return {"response": f"{weather['city']}当前天气: {weather['description']},"
                            f"温度{weather['temp']}°C, 湿度{weather['humidity']}%"
            }

        except Exception as e:
            return {"error": f"天气查询出错: {str(e)}"}

# 注册技能
def create_skill():
    return WeatherSkill()

Claude SDK 提供了本地测试工具：