claude-cursor-agent-skill

claude-cursor-agent-skill 是一款让 Claude Code 能够通过自然语言直接调用 Cursor 编程 Agent 进行代码评审和 TDD（测试驱动开发）的 Claude Code 技能包。它以 Claude Code 为主要操作界面，在需要代码评审或 TDD 实现时，通过 Skill 机制无缝调用 Cursor 的 AI 编程能力，实现两大 AI 编程工具的优势互补。

核心能力

claude-cursor-agent-skill 提供了以下核心能力：

• 代码评审（Review）：对指定文件或代码段进行详细评审，提供具体的改进建议；支持普通评审和基于设计文档的计划式评审（Plan-based Review）；
• TDD 实现（Implement）：遵循测试优先原则，先编写测试用例再实现功能代码，确保代码可测试性；
• 输出格式控制：默认输出简洁清晰的结果，需要时可通过 --verbose 参数显示执行详情；
• 中文自然语言触发：直接用中文描述需求（如「使用cursor帮我review这个文件」），Agent 自动识别并调用 Cursor 执行；
• 多工具协同：Claude Code 负责整体任务调度，Cursor Agent 专注深度代码分析，两者互补。

安装与配置

安装前需要先安装 ripgrep 依赖：

# macOS
brew install ripgrep

# Linux (Debian/Ubuntu)
sudo apt-get install ripgrep

# 全局安装技能包
npm install -g claude-cursor-agent-skill

配置 Cursor API Key（获取地址：https://cursor.com/dashboard/integrations）：

# 方式一：环境变量
export CURSOR_API_KEY="***"

# 方式二：配置文件
mkdir -p ~/.cursor-skill
echo '{"cursorApiKey":"crsr_..."}' > ~/.cursor-skill/settings.json

# 可选：指定模型
export CURSOR_MODEL="composer-3"

在 Claude Code 中注册技能：

npx skills add ivanon/claude-cursor-skill -y -g

使用步骤

以评审一个认证模块为例：

1. 触发技能：在 Claude Code 中用中文描述需求，如「使用cursor帮我review一下 src/auth.ts」；
2. Claude 调度：Claude Code 识别到 cursor 关键词，自动调用该 Skill；
3. Cursor 执行评审：Cursor Agent 接收任务，对代码进行详细分析；
4. 结果反馈：评审结果返回 Claude Code，输出包含改进建议和代码问题说明；
5. 后续处理：Claude Code 根据评审意见继续执行后续开发任务。

适用场景

• 深度代码评审：当 Claude Code 需要对复杂代码进行评审时，调用 Cursor 的专业评审能力获得更详细的反馈；
• 跨工具协作：同时使用 Claude Code 和 Cursor 的团队可以通过此 Skill 实现两大工具的协同工作；
• TDD 开发流程：在需要严格遵循测试优先的开发流程时，借助 Cursor 的 TDD 实现能力；
• 设计文档验证：结合 Plan-based Review 功能，根据设计文档验证代码实现的完整性和正确性。

适用人群

同时使用 Claude Code 和 Cursor 的开发者、需要更专业代码评审能力的 AI 编程工具用户，以及希望在团队中灵活切换不同 AI 编程工具的工程师。

工作原理

claude-cursor-agent-skill 的核心是一个「自然语言调度 → Cursor Agent 执行 → 结果返回」的工作流：

1. 用户在 Claude Code 中用自然语言（支持中文）描述需求；
2. Claude Code 的 Skill 系统识别到 cursor 关键词，加载该 Skill；
3. Skill 调用 Cursor SDK（cursor-agent CLI）发送请求到 Cursor API；
4. Cursor Agent 执行代码评审或 TDD 实现任务；
5. 执行结果以流式方式返回，Skill 对输出进行格式化后呈现在 Claude Code 界面。

官方链接

• npm：https://www.npmjs.com/package/claude-cursor-agent-skill
• GitHub：https://github.com/ivanon/claude-cursor-skill
• Cursor API Key：https://cursor.com/dashboard/integrations