Cursor Agent Skill 入门指南：从零构建你的第一个智能开发助手

1次阅读

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

Cursor Agent Skill 是一种用于构建智能开发助手的工具，它允许开发者通过编写自定义技能来扩展开发环境的功能。简单来说，它就像给你的 IDE 装上一个智能插件，能帮你自动完成代码补全、错误检查、代码优化等任务。

核心功能 ：代码生成、错误诊断、自动补全、代码重构
典型应用场景 ：
快速生成常见代码模板（如 REST API、数据库操作）
自动修复语法错误或代码异味
根据注释生成对应代码实现
项目特定规范的自动化检查

安装最新版 Cursor 编辑器（官网下载）
确保 Python 3.8+ 或 Node.js 16+ 环境
在 Cursor 设置中启用 “Developer Mode”

在 Cursor 插件目录创建新文件夹 my-first-skill
初始化技能配置文件 skill.json：

{
  "name": "My First Skill",
  "version": "0.1.0",
  "description": "A simple demo skill",
  "entry": "main.py"
}

以下是一个基础技能实现，当用户输入 //sum 注释时自动生成求和函数：

from cursor_skill import Skill, Context

class SumSkill(Skill):
    def match(self, context: Context) -> bool:
        # 检测当前行是否包含特定注释
        return context.current_line.strip() == "//sum"

    def execute(self, context: Context):
        # 获取缩进级别保持格式一致
        indent = " " * (len(context.current_line) - len(context.current_line.lstrip()))

        # 生成函数代码
        code = f"{indent}def sum_numbers(a, b):\n"
        code += f"{indent}    return a + b\n"

        # 在下一行插入生成的代码
        context.insert_after(code)

# 注册技能
def setup():
    return SumSkill()

关键点说明：
– match() 方法定义技能触发条件
– execute() 包含核心业务逻辑
– 通过 context 对象与编辑器交互