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

1次阅读

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

Claude Code 是一个强大的 AI 开发平台，允许开发者创建自定义的 AI 技能（Skill）。这些技能可以被集成到各种应用中，为用户提供智能化的交互体验。打个比方，这就像给你的应用装上一个能听懂人话、会思考的大脑。

安装 Python 3.8+（推荐使用最新稳定版）
安装 Claude Code SDK：pip install claude-code-sdk
注册 Claude Code 开发者账号并获取 API 密钥
推荐使用 VS Code 或 PyCharm 作为开发工具

新建项目文件夹：mkdir weather-skill && cd weather-skill
创建虚拟环境：python -m venv venv
激活虚拟环境：
Windows: venv\Scripts\activate
Mac/Linux: source venv/bin/activate

创建 weather_skill.py 文件，内容如下：

import requests
from claude_code.skill import Skill, Intent

class WeatherSkill(Skill):
    """
    天气查询技能示例
    功能：根据城市名称查询当前天气情况
    """

    def __init__(self):
        super().__init__(
            name="weather_query",
            description="查询指定城市的天气情况"
        )

        # 注册意图（用户可能说的话）self.register_intent(
            Intent(
                "query_weather",
                patterns=["{city}的天气", "{city}天气怎么样", "查询 {city} 天气"]
            )
        )

    async def handle_query_weather(self, city: str):
        """处理天气查询请求"""
        try:
            # 这里使用模拟 API，实际开发时可接入真实天气 API
            weather_data = self._mock_weather_api(city)
            return f"{city}当前天气：{weather_data['condition']}，温度{weather_data['temp']}℃"
        except Exception as e:
            return f"抱歉，获取 {city} 天气信息失败：{str(e)}"

    def _mock_weather_api(self, city):
        """模拟天气 API 返回数据"""
        # 实际项目中应该替换为真实的 API 调用
        weather_conditions = ["晴天", "多云", "小雨", "阴天"]
        return {
            "city": city,
            "condition": random.choice(weather_conditions),
            "temp": random.randint(0, 35)
        }

# 创建技能实例并运行
if __name__ == "__main__":
    import random
    skill = WeatherSkill()
    skill.run()