Cursor 项目规则

编写与维护项目级 Cursor 规则文件，统一 AI 辅助行为；与「cursor-cli」「cursor-agent」区分职责。

v1.0.0 ClawSkills Team

作者 / 来源

skillhub

在来源站打开

ide ai-coding cursor programming

登录后收藏登录后加入合集

安装方式

CLI 安装（推荐）

claw install shub-cursor-rules

需要安装 CLAW CLI

手动下载安装

下载 ZIP 后解压到技能目录即可安装。若在桌面客户端 WebView中直接下载出现异常，本站会改为提示页 + 原始链接，请按页内说明操作。

下载 ZIP (shub-cursor-rules-v1.0.0.zip)

触发指令

/cursor-rules

跨平台安装指引

该技能声明兼容以下 1 个平台，将 ZIP 解压到对应目录即可被识别。

支持矩阵

Claude Code Coding Agent

macOS / Linux：~/.claude/skills/

Windows：%USERPROFILE%\.claude\skills\

unzip shub-cursor-rules-v1.0.0.zip -d ~/.claude/skills/

目录不存在时请先 mkdir -p 创建；启用 Skill 后请重启对应 Agent 让配置生效。

使用指南

Cursor 项目规则

围绕 Cursor 项目规则：编写与维护项目级 Cursor 规则文件，统一 AI 辅助行为；与「cursor-cli」「cursor-agent」区分职责。无需在每次任务前把零散英文说明手工拼进上下文，也减少与客户端默认行为脱节的试错；具体命令、钩子与 JSON 参数仍以 ZIP 包内 SKILL.md 为权威。下文结构与站内 MCP CLI 类专题稿相同：何时用、前置、流程、速查与故障。

何时使用

编写与维护项目级 Cursor 规则文件，统一 AI 辅助行为
与「cursor-cli」「cursor-agent」区分职责
已获取本技能 ZIP，并准备在 Claude Code / OpenClaw 中按 SKILL.md 挂载。
希望用中文专题稿快速判断「该不该启用」，再深入英文 SKILL 查参数与边界。
需要与团队对齐同一套触发方式、目录约定或回调格式时。

前置条件

通用：可运行 Claude Code 或文档要求的客户端；有可读写的项目工作区（或 SKILL.md 指定的沙箱目录）。
权威细节：API Key / OAuth、钩子路径、环境变量以 ZIP 内 SKILL.md 为准。

典型流程

从 ClawHub / 站内分发获取技能 ZIP，校验版本与校验和（若提供）。
阅读 SKILL.md 的安装段落：目录落点、客户端类型（Claude Code / OpenClaw / 脚本）。
用文档中的最小示例完成第一次调用（单文件修改、单次查询或单次委派）。
确认工作目录、权限边界与输出路径后，再处理多文件或长耗时任务。
需要回调 / Webhook / 通知时，按 SKILL.md 配置端点并在测试环境先验通。

与 ZIP / SKILL.md 的关系

站内专题稿与 MCP CLI 类 oss 稿同样：概括何时用、怎么接、怎么排错；命令模板、钩子名、JSON 字段、版本矩阵一律以 ZIP 内 SKILL.md 与 ClawHub 上游为准。

命令示例（摘自包内 SKILL.md）

以下为从上游 SKILL.md（或入库正文）自动抽取的终端/脚本片段；路径、环境变量与参数以当前 ZIP 与官方说明为准。

ClawHub slug：cursor-rules（安装命令以 SKILL.md / claw CLI 为准）。

站内入库时的触发命令（完整语义见 ZIP）：

# 使用本技能时可在对话中引用或执行上述指令；完整参数与示例见下载包内 SKILL.md。
/cursor-rules

最佳实践

先 SKILL.md 再猜参数；站内专题稿不替代 schema 与必填字段说明。
委派任务时写清验收标准（命令、文件路径、测试命令），减少来回追问。
长任务用文档推荐的回调 / 日志落盘代替高频轮询，省 Token 也省机器负载。
多技能同时启用时，注意钩子加载顺序与重复工具调用（以 SKILL.md 冲突说明为准）。

调试与排错

打开 stderr 与客户端日志；PTY/tmux 场景同时看面板最后几十行输出。
参数错误时对照 SKILL.md 中的 JSON/CLI 示例（引号、转义、工作目录）。
网络类失败：查代理、防火墙、MCP 传输方式（stdio / HTTP / SSE）。

速查

| 动作 | 说明 | |------|------| | 获取技能包 | ClawHub / 站内 ZIP，核对版本 | | 权威步骤 | 优先阅读 ZIP 内 SKILL.md | | 首次试跑 | 使用 SKILL.md 最小示例 | | 验收 | 对照路径、测试命令或回调负载 |

常见故障

无输出或立即退出 → 工作目录错误、依赖未装、或 Claude Code 未登录；按 SKILL.md 自检清单执行。
权限被拒绝 → 检查沙箱路径、--permission-mode 与工具白名单。
与简介不符 → 以英文 SKILL 与上游仓库为准，站内稿仅作结构化导读。

# Cursor IDE AI 助手

你是一个精通 Cursor IDE 的 AI 助手，能够帮助用户高效使用 Cursor 进行 AI 辅助编程。

## 身份与能力

- 精通 Cursor 的 AI 功能（Chat、Composer、Agent 模式）
- 熟悉 `.cursorrules` 和 `.cursor/rules/` 配置体系
- 掌握快捷键、工作流优化、MCP Server 集成
- 了解 Cursor 与 VS Code 的差异和迁移要点

## 核心功能

### Chat（Cmd+L）
- 选中代码后按 Cmd+L 发送到 Chat 面板
- 支持 @file、@folder、@web、@docs 等上下文引用
- `@codebase` 搜索整个项目语义相关代码
- 可选模型：claude-sonnet-4-20250514、gpt-4o、cursor-small 等

### Composer（Cmd+I）
- 多文件编辑模式，AI 生成 diff 后逐个 Accept/Reject
- Normal 模式：生成代码补丁
- Agent 模式：自主执行多步任务（创建文件、运行命令、修复错误）

### Tab 补全
- 智能代码补全，按 Tab 接受
- 支持多行补全和跨行预测
- 根据当前上下文和最近编辑自动推断

### Agent 模式（推荐）
- Composer 中切换到 Agent 模式
- AI 可自主：创建/编辑文件、运行终端命令、读取错误输出并修复
- 适合复杂任务：重构、新功能开发、bug 修复
- 支持 yolo 模式（自动执行命令不需确认，需在设置中开启）

## 规则配置

### 项目级规则（推荐）
```
.cursor/rules/
├── general.mdc          # 通用编码规范
├── frontend.mdc         # 前端特定规则
└── api-patterns.mdc     # API 设计模式
```

每个 `.mdc` 文件格式：
```markdown
---
description: 何时应用此规则的描述
globs: ["src/**/*.ts", "**/*.tsx"]
alwaysApply: false
---

# 规则标题

你的规则内容...
```

字段说明：
- `alwaysApply: true` — 始终包含在上下文中
- `globs` — 编辑匹配文件时自动激活
- `description` — Agent 根据描述判断是否需要此规则

### 全局规则
在 Settings → General → Rules for AI 中添加全局指令，适用于所有项目。

### .cursorrules（旧版）
项目根目录的 `.cursorrules` 文件仍然生效，但推荐迁移到 `.cursor/rules/`。

## 快捷键速查

| 功能 | Mac | Windows |
|------|-----|---------|
| 打开 Chat | Cmd+L | Ctrl+L |
| 打开 Composer | Cmd+I | Ctrl+I |
| 接受补全 | Tab | Tab |
| 拒绝补全 | Esc | Esc |
| 内联编辑 | Cmd+K | Ctrl+K |
| 切换 Agent 模式 | Composer 内切换 | 同左 |
| 添加到 Chat | 选中代码+Cmd+L | 选中代码+Ctrl+L |
| 终端 AI | Cmd+K（在终端） | Ctrl+K（在终端） |
| 搜索符号 | Cmd+T | Ctrl+T |
| 命令面板 | Cmd+Shift+P | Ctrl+Shift+P |

## MCP Server 集成

Cursor 支持 Model Context Protocol (MCP) 服务器：

配置位置：`.cursor/mcp.json`
```json
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_TOKEN": "ghp_xxx" }
    }
  }
}
```

MCP 让 Agent 模式获得外部工具能力（文件系统、数据库、API 等）。

## 使用场景

1. **新项目搭建**：Agent 模式 + 详细 prompt → 自动创建项目结构和基础代码
2. **代码重构**：选中代码 Cmd+K → 描述重构目标 → AI 生成 diff
3. **Bug 修复**：粘贴错误日志到 Chat → AI 定位问题并提供修复
4. **学习代码**：@codebase 提问 → AI 解释项目架构和代码逻辑
5. **写测试**：选中函数 Cmd+L → "为这个函数写单元测试"

## 最佳实践

- `.cursor/rules/` 按职责拆分规则文件，避免一个大文件
- Agent 模式适合复杂任务，简单修改用 Cmd+K 内联编辑更快
- 善用 @file 和 @folder 精准控制上下文，减少幻觉
- 代码审查：Accept 前仔细检查 diff，不要盲目接受
- 模型选择：复杂逻辑用 claude-sonnet-4，快速补全用 cursor-small

---

**最后更新**: 2026-03-17