Cursor中Skill开发实战：从零构建你的第一个AI助手技能

1次阅读

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

Cursor 是一个面向开发者的 AI 编程平台，其核心功能之一就是 Skill 开发。Skill 可以理解为 AI 助手的技能或能力模块，开发者可以通过编写 Skill 来扩展 AI 助手的功能范围。每个 Skill 都是一个独立的代码单元，能够接收用户输入、处理数据并返回响应。

Skill 开发主要涉及以下几个核心概念：

意图(Intent)：定义用户可能表达的目标或需求
实体(Entity)：从用户输入中提取的关键信息片段
对话状态(Dialog State)：跟踪当前对话上下文
响应生成(Response Generation)：根据处理结果生成合适的回复

首先确保已安装 Python 3.8+ 版本
安装 Cursor CLI 工具：
```
pip install cursor-cli
```
创建新 Skill 项目：
```
cursor skill create my_first_skill
```
进入项目目录并启动开发服务器：
```
cd my_first_skill
cursor skill dev
```

项目初始化后会生成以下目录结构：

my_first_skill/
├── skill.json      # Skill 元数据
├── requirements.txt # 依赖包
├── src/
│   ├── __init__.py
│   ├── main.py     # 主处理逻辑
│   └── tests.py    # 测试用例

一个基本的 Skill 包含以下核心组件：

初始化函数：定义 Skill 的基本信息

from cursor.skill import Skill

class MySkill(Skill):
    def __init__(self):
        super().__init__(
            name="My First Skill",
            description="A simple demo skill",
            version="0.1"
        )

意图处理器：处理特定用户请求

@self.intent("greet")
def handle_greet(self, entities, context):
    return {"response": "Hello! How can I help you?"}

实体提取器：从用户输入中获取关键信息

@self.entity("city")
def extract_city(self, text):
    # 简单实现城市名称提取
    cities = ["北京", "上海", "广州"]
    for city in cities:
        if city in text:
            return city
    return None

下面我们实现一个完整的天气查询 Skill：

import requests
from cursor.skill import Skill

class WeatherSkill(Skill):
    def __init__(self):
        super().__init__(
            name="Weather Query",
            description="Query weather information for cities",
            version="1.0"
        )
        # 配置 API 密钥(实际使用时应从环境变量获取)
        self.api_key = "YOUR_API_KEY"

    @self.entity("city")
    def extract_city(self, text):
        cities = ["北京", "上海", "广州", "深圳"]
        for city in cities:
            if city in text:
                return city
        return None

    @self.intent("query_weather")
    def handle_weather_query(self, entities, context):
        city = entities.get("city")
        if not city:
            return {"response": "请问您想查询哪个城市的天气?"}

        try:
            # 调用天气 API(示例使用假想 API)
            url = f"https://api.weather.com/v1?city={city}&key={self.api_key}"
            response = requests.get(url)
            data = response.json()

            return {"response": f"{city}的天气是{data['weather']}, 温度{data['temp']}℃"
            }
        except Exception as e:
            return {"response": "获取天气信息时出错，请稍后再试"}