Cursor

Cursor

Cursor 是基于 VS Code 的 AI 代码编辑器，内置 Agent、补全、终端与 MCP 等能力，通过 Rules 和 Skills 提供可复用的上下文与工作流。

• 官网与下载：cursor.com/download
• 文档：docs.cursor.com

Rules

规则为 Agent 提供系统级指令。它们将提示词、脚本等打包在一起，便于在团队内管理和共享工作流。

Cursor 支持四种类型的规则：

• 项目规则 存储在 .cursor/rules 中，受版本控制且仅作用于你的代码库。
• 用户规则 在你的 Cursor 环境中全局生效，供 Agent (聊天) 使用。
• 团队规则 在仪表盘中集中管理的团队级规则，适用于 Team 和 Enterprise 方案。
• AGENTS.md 以 Markdown 格式编写的 Agent 指令，是 .cursor/rules 的简化替代方案。

大语言模型在各次补全之间不会保留记忆。规则在提示层面提供持久、可复用的上下文。

应用规则时，其内容会被加入到模型上下文的开头。这为 AI 在生成代码、理解修改或协助处理工作流程时提供一致的指导。

项目规则存放在 .cursor/rules 目录中的 Markdown 文件里，并纳入版本控制。它们可以通过路径模式限定作用范围、手动触发，或按相关性自动应用。

使用项目规则可以：

• 固化与你代码库相关的领域知识
• 自动化项目特定的工作流或模板
• 统一风格或架构决策

每条规则对应一个 Markdown 文件，文件名可自定义。Cursor 支持 .md 和 .mdc 扩展名；使用带 frontmatter 的 .mdc 可指定 description 和 globs，以更精细地控制规则的生效条件。

目录示例：

1
.cursor/rules/
2
  react-patterns.mdc       # 带前置元数据（description, globs）
3
  api-guidelines.md        # 简单 Markdown 规则
4
  frontend/                # 子目录组织
5
    components.md

规则结构

每条规则是一个带 frontmatter 的 Markdown 文件；在 Cursor 中可通过类型下拉菜单控制 description、globs、alwaysApply 等应用方式。

Frontmatter 字段：

规则示例

1
---
2
name: api-guidelines
3
description: API 与 RPC 服务约定
4
globs: ["**/api/**/*.ts", "**/services/**/*.ts"]
5
alwaysApply: false
6
---
7

8
- 定义服务时使用内部 RPC 模式
9
- 服务名使用 snake_case
10

11
@service-template.ts

创建方式

1. 对话中创建：在 Agent 中输入 /create-rule，描述需求，Agent 会生成带正确 frontmatter 的规则并保存到 .cursor/rules。
2. 设置中创建：打开 Cursor Settings → Rules, Commands，点击 + Add Rule，在 .cursor/rules 中新建规则；可在设置中查看所有规则及状态。

规则准则

好的规则应当聚焦、可操作且范围明确：

• 将规则控制在 500 行以内
• 将大型规则拆分为多个可组合的规则
• 提供具体示例或引用相关文件
• 避免模糊的指导，像撰写清晰的内部文档那样来写规则
• 在聊天中重复提示时复用规则
• 引用文件而不是复制其内容——这样可以让规则更简短，并避免在代码变更后规则变得陈旧

应避免：

• 整份照搬风格指南 → 用 linter；Agent 已了解常见风格。
• 把每个命令都写进文档 → Agent 熟悉 npm、git、pytest 等常用工具。
• 为极少出现的边缘情况写规则 → 只聚焦常用模式。
• 重复代码库已有内容 → 引用示例文件，而非复制代码。

推荐Rules

推荐仓库：https://github.com/PatrickJS/awesome-cursorrules

个人收录

Skills

Agent Skills 是一个开放标准，用于为 AI Agent 扩展专用能力。Skills 将特定领域的知识和工作流打包封装，供 Agent 调用以完成特定任务。

Cursor 启动时，会自动从技能目录中发现技能，并将其提供给 Agent。Agent 会获知可用的技能，并根据上下文决定何时使用它们。

也可以在 Agent 对话中输入 / 并搜索技能名称来手动调用技能。

Skills 存放目录：

兼容性：Cursor 会同时从 Claude / Codex 的目录加载技能，便于与 Claude Code 共用一套 skills：

• 项目：.claude/skills/、.codex/skills/
• 用户：~/.claude/skills/、~/.codex/skills/

每个技能都应当是一个包含 SKILL.md 文件的文件夹

1
.agents/
2
└── skills/
3
    └── deploy-app/
4
        ├── SKILL.md
5
        ├── scripts/                      # 可选的脚本文件 智能体可以运行的可执行代码
6
        │   ├── deploy.sh
7
        │   └── validate.py
8
        ├── references/                   # 可选的参考文件 按需加载的补充文档
9
        │   └── REFERENCE.md
10
        └── assets/                       # 可选的资源文件 模板、图片或数据文件等静态资源
11
            └── config-template.json

SKILL.md 文件格式

每个技能都在带有 YAML frontmatter 的 SKILL.md 文件中定义

1
---
2
name: my-skill
3
description: Short description of what this skill does and when to use it.
4
---
5

6
# My Skill
7

8
Detailed instructions for the agent.
9

10
## When to Use
11

12
- Use this skill when...
13
- This skill is helpful for...
14

15
## Instructions
16

17
- Step-by-step guidance for the agent
18
- Domain-specific conventions
19
- Best practices and patterns
20
- Use the ask questions tool if you need to clarify requirements with the user

Frontmatter 字段：

script：存放供 Agent 运行的可执行代码；在 SKILL.md 中引用时使用相对于技能根目录的路径。

::: tip 脚本应自包含、有清晰错误提示，并能优雅处理边缘情况。 :::

示例：

1
---
2
name: deploy-app
3
description: Deploy the application to staging or production environments. Use when deploying code or when the user mentions deployment, releases, or environments.
4
---
5

6
# Deploy App
7

8
Deploy the application using the provided scripts.
9

10
## Usage
11

12
Run the deployment script: `scripts/deploy.sh <environment>`
13

14
Where `<environment>` is either `staging` or `production`.
15

16
## Pre-deployment Validation
17

18
Before deploying, run the validation script: `python scripts/validate.py`

references：补充文档。主 SKILL.md 保持精简，详细内容放到单独文件，Agent 会按需加载，节省上下文。

assets：模板、图片、数据文件等静态资源。

推荐SKILL

推荐仓库：https://github.com/ComposioHQ/awesome-claude-skills

中国国内环境最佳配置

在国内网络环境下，Cursor 连接官方 API 可能不稳定或无法访问，可通过以下方式改善体验。

代理与网络

::: warning Cursor 的 AI 请求由应用自身发起，不一定读取终端环境变量。若仅设环境变量无效，需在 Cursor 或系统级配置代理。 :::

模型与 API

• 使用 Cursor 自带模型：依赖 Cursor 官方线路，受网络影响大；开代理后通常可正常使用。
• 自建/中转 API（若支持）：若 Cursor 或插件支持自定义 OpenAI/Anthropic 兼容端点，可将 base_url 指向国内中转或自建网关，减少直连海外。

更新与下载

• 安装包：从 cursor.com/download 下载可能较慢，可尝试镜像站或离线包（若有社区维护）。
• 扩展与 MCP：部分扩展从境外拉取，可对 marketplace.visualstudio.com、GitHub 等配置代理以加速。

推荐做法小结

1. 在系统或 Cursor 中配置稳定的 HTTP(S) 代理。
2. 需要时在终端环境变量中设置 HTTP_PROXY/HTTPS_PROXY，便于 Agent 执行命令时的网络访问。
3. 将大文件、锁文件、构建产物等加入 .cursorignore，减少索引与请求量，在弱网下更稳定。

与 Claude Code 的兼容

Cursor 与 Claude Code 在「规则 + 技能」思路上相近，部分目录和格式可复用，便于同一项目在两种环境中一致使用。

规则（Rules）对应关系

• 格式差异：Cursor 用 globs（如 ["*.vue", "src/**/*.ts"]），Claude Code 用 paths（如 ["src/api/**/*.ts"]），语义类似。若需双端共用，可写两份 frontmatter 或在一个文件中同时写 globs 与 paths（各自工具只读自己识别的字段）。
• 共用策略：把通用内容放在同一份 Markdown 里，仅 frontmatter 按工具区分；或项目内同时维护 .cursor/rules/ 与 .claude/rules/，内容上保持对齐。

技能（Skills）兼容

Cursor 会从 Claude/Codex 的 skills 目录加载技能，因此：

• 在 .claude/skills/<skill-name>/SKILL.md 或 ~/.claude/skills/<skill-name>/SKILL.md 中放置的技能，在 Cursor 中也可用。
• 使用 Agent Skills 标准（SKILL.md + frontmatter），两边格式一致即可；Cursor 还支持 .cursor/skills/、.agents/skills/。

若希望「一个项目同时给 Cursor 和 Claude Code 用」，优先把共享技能放在 .claude/skills/，这样 Cursor 与 Claude Code 都能加载。

项目级指令文件

• 二者互不替代：Cursor 不会读 CLAUDE.md，Claude Code 不会读 AGENTS.md。若需双端一致，可在项目中同时维护两者，或把通用说明放在一个共享文档中，在 AGENTS.md / CLAUDE.md 里用简短描述 + 引用该文档。

小结

• Skills：放在 .claude/skills/（或 ~/.claude/skills/）可被 Cursor 与 Claude Code 共用。
• Rules：目录与 frontmatter 字段不同，可内容共用、frontmatter 按工具写，或双目录同步。
• 项目指令：AGENTS.md 与 CLAUDE.md 各用各的，需双端一致时两处都写或引用同一份说明。

.cursorignore

Cursor 会读取并索引您的项目代码库，以支持其功能。

您可以在项目根目录创建一个 .cursorignore 文件，控制 Cursor 可以访问的目录和文件，使用与 .gitignore 相同的语法。

在 .cursorignore 中列出的文件将被 Cursor 限制访问，包括：

• 代码库索引
• Tab、Agent 与 Inline Edit 可读取的代码
• 通过 @ 引用可访问的代码

::: danger 由 Agent 发起的工具调用（如终端、MCP 服务器）不会受 .cursorignore 限制，仍可能访问被忽略路径。 :::

默认忽略列表（节选）：

1
package-lock.json
2
pnpm-lock.yaml
3
yarn.lock
4
composer.lock
5
Gemfile.lock
6
bun.lockb
7
.env*
8
.git/
9
.svn/
10
.hg/
11
*.lock
12
*.bak
13
*.tmp
14
*.bin
15
*.exe
16
*.dll
17
*.so
18
*.lockb
19
*.qwoff
20
*.isl
21
*.csv
22
*.pdf
23
*.doc
24
*.xls
25
*.xlsx
26
*.ppt
27
*.pptx
28
*.odt
29
*.ods
30
*.odp
31
*.odg
32
*.odf
33
*.sxw
34
*.sxc
35
*.sxi
36
*.sxd
37
*.sdc
38
*.jpg
39
*.jpeg
40
*.png
41
*.gif
42
*.bmp
43
*.tif
44
*.mp3
45
*.wav
46
*.wma
47
*.ogg
48
*.flac
49
*.aac
50
*.mp4
51
*.mov
52
*.wmv
53
*.flv
54
*.avi
55
*.zip
56
*.tar
57
*.gz
58
*.7z
59
*.rar
60
*.tgz
61
*.dmg
62
*.iso
63
*.cue
64
*.mdf
65
*.mds
66
*.vcd
67
*.toast
68
*.img
69
*.apk
70
*.msi
71
*.cab
72
*.tar.gz
73
*.tar.xz
74
*.tar.bz2
75
*.tar.lzma
76
*.tar.Z
77
*.tar.sz
78
*.lzma
79
*.ttf
80
*.otf
81
*.pak
82
*.woff
83
*.woff2
84
*.eot
85
*.webp
86
*.vsix
87
*.rmeta
88
*.rlib
89
*.parquet
90
*.svg
91
.egg-info/
92
.venv/
93
node_modules/
94
__pycache__/
95
.next/
96
.nuxt/
97
.cache/
98
.sass-cache/
99
.gradle/
100
.DS_Store/
101
.ipynb_checkpoints/
102
.pytest_cache/
103
.mypy_cache/
104
.tox/
105
.git/
106
.hg/
107
.svn/
108
.bzr/
109
.lock-wscript/
110
.Python/
111
.jupyter/
112
.history/
113
.yarn/
114
.yarn-cache/
115
.eslintcache/
116
.parcel-cache/
117
.cache-loader/
118
.nyc_output/
119
.node_repl_history/
120
.pnp.js/
121
.pnp/