Cursor Skill - Claude Code 集成文档

概述

Cursor Skill 是一个 Claude Code 技能封装，用于拉起 Cursor Agent CLI 执行代码修改、代码审查、问答等操作。

安装

方法一：直接复制

将 cursor-package 文件夹复制到你的 Claude Code 技能目录：

cp -r ~/.claude/skills/cursor-package ~/.claude/skills/cursor

方法二：符号链接

ln -s ~/.claude/skills/cursor-package ~/.claude/skills/cursor

文件结构

cursor-package/
├── SKILL.md              # 技能描述文件
├── package.json          # 包配置
├── scripts/
│   └── cursor.js         # CLI 封装脚本
└── docs/
    └── README.md         # 本文档

配置

环境变量

变量	说明	必需
CURSOR_API_KEY	Cursor API 密钥	是
CURSOR_CLI_PATH	自定义 cursor CLI 路径	否
CURSOR_MODEL	默认模型	否

Claude Code 配置

技能已配置 user-invocable: true，可直接使用 /cursor 调用。

使用方式

基本用法

# 在当前工作区执行
/cursor "解释这个函数的逻辑"

# 只读规划模式
/cursor "分析这个模块的架构" --mode plan

# 指定工作区
/cursor "重构这个模块" --workspace ./src

# 继续会话
/cursor --continue

# 恢复指定会话
/cursor --resume <会话ID>

命令行直接调用

node ~/.claude/skills/cursor-package/scripts/cursor.js "你的指令"

操作模式

模式	说明	适用场景
plan	只读规划模式，只分析不修改	代码审查、架构分析
ask	问答模式，解释代码、回答问题	学习代码、询问问题
normal	默认模式，执行实际操作	代码修改、功能实现

常用场景

代码审查

/cursor "审查这段代码的问题" --mode plan

代码修改

/cursor "将这个函数重构为使用 async/await" --workspace ./src

问题解答

/cursor "解释这个正则表达式的作用" --mode ask

批量操作

/cursor "重构所有以 legacy_ 开头的函数" --force

输出格式

默认情况下，cursor 以流式方式输出响应。如需结构化输出：

cursor "你的指令" --print --output-format json
cursor "你的指令" --print --output-format stream-json

注意事项

1. 确保 CURSOR_API_KEY 环境变量已设置
2. 使用 --trust 参数避免重复的工作区信任提示
3. 使用 --force 或 --yolo 参数跳过命令确认提示
4. 规划模式（--mode plan）是只读的，不会产生任何文件修改

版本

• Version: 1.0.0
• Author: Knifelf (刀妖)
• License: MIT