Claude创建Skill步骤详解：从零开始构建你的第一个AI技能

1次阅读

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

Claude Skill 是 Anthropic 公司推出的 AI 技能开发框架，允许开发者构建基于 Claude 模型的定制化对话交互能力。它类似于 Alexa Skill 或 Google Action，但专注于 Claude 的对话式 AI 特性。通过创建 Skill，你可以让 Claude 具备特定领域的专业知识或完成特定任务，比如天气查询、日程管理、知识问答等。

在开始创建 Skill 前，需要准备以下环境和工具：

一个有效的 Claude 开发者账户
Python 3.8 或更高版本
文本编辑器或 IDE（如 VS Code、PyCharm）
Claude 开发者工具包（可通过 pip 安装）
基础的 Python 编程知识

安装 Claude SDK 的命令如下：

pip install claude-sdk

创建一个新的 Python 项目目录
初始化虚拟环境（推荐）
安装必要的依赖
创建基本的项目结构

建议的项目结构：

my_skill/
├── skill.py       # 主技能文件
├── config.yaml    # 技能配置文件
└── requirements.txt

在 config.yaml 中定义技能的基本信息：

name: WeatherSkill
description: 一个简单的天气查询技能
version: 1.0
invocation_name: 天气助手

意图定义了用户可能表达的需求。在 skill.py 中定义意图处理器：

from claude.skill import Skill, intent

class WeatherSkill(Skill):
    @intent('WeatherIntent')
    async def handle_weather(self, request):
        """处理天气查询意图"""
        city = request.slots.get('city')
        # 这里添加获取天气的逻辑
        return self.tell(f"{city}的天气是晴，25 度")

设计对话流程需要考虑用户可能的表达方式。在 config.yaml 中添加示例语句：

intents:
  WeatherIntent:
    samples:
      - "{city}的天气怎么样"
      - "查询 {city} 的天气"
      - "{city}今天天气如何"

Claude 提供了本地测试工具，可以通过以下命令启动测试：

claude skill test --skill my_skill

测试时可以使用不同的表达方式来验证意图识别是否正确。

下面是一个简单的天气查询 Skill 的完整实现：

from claude.skill import Skill, intent

class WeatherSkill(Skill):
    def __init__(self):
        super().__init__()
        # 初始化代码可以放在这里

    @intent('WeatherIntent')
    async def handle_weather(self, request):
        """
        处理天气查询请求
        参数:
            request: 包含用户请求信息的对象
        返回:
            返回给用户的响应
        """city = request.slots.get('city')

        # 实际应用中这里应该调用天气 API
        # 这里简化处理，直接返回固定响应
        weather_data = {
            "北京": "晴，25 度",
            "上海": "多云，23 度",
            "广州": "阵雨，28 度"
        }

        if city in weather_data:
            return self.tell(f"{city}的天气是{weather_data[city]}")
        else:
            return self.tell(f"抱歉，我找不到 {city} 的天气信息")

# 技能入口函数
def create_skill():
    return WeatherSkill()