Cursor 使用指南
# Cursor
AI 原生 IDE，基于 VS Code 改造。
# 配置结构
按作用域配置，不把所有配置项的优先级简单归结为“项目级更高”。具体匹配和加载方式见 Cursor Rules 文档 (opens new window)。
# Rules（规则）
持久化指令，告诉 AI「怎么做」，类似 .editorconfig。
| 路径 | 作用域 |
|---|---|
.cursor/rules/*.mdc | 当前项目 |
| Customize → Rules 中的 User Rules | 用户级规则 |
---
description: 规则描述
globs: ["**/*.md"] # 匹配文件范围，全局适用由 alwaysApply 控制
alwaysApply: true
---
规则正文
1
2
3
4
5
6
7
2
3
4
5
6
7
# Agents（子代理）
拥有独立系统提示词的专项 AI 助手，隔离上下文执行特定任务。
| 路径 | 作用域 |
|---|---|
.cursor/agents/*.md | 当前项目 |
~/.cursor/agents/*.md | 所有项目 |
---
name: agent-name # 唯一标识（小写+连字符）
description: 何时使用 # AI 据此判断是否自动委派
---
系统提示词正文
1
2
3
4
5
6
2
3
4
5
6
# Skills（技能）
技能包结构与编写示例统一见 AI Skill 实践，本页只记录 Cursor 配置入口。
| 路径 | 作用域 |
|---|---|
.cursor/skills/<name>/SKILL.md | 当前项目 |
~/.cursor/skills/<name>/SKILL.md | 所有项目 |
# 三者关系
Rules -> 全局行为约束（"代码用中文注释"）
Agents -> 专项 AI 角色（"code-reviewer"）
Skills -> 可复用工作流（"PDF 处理流程"）
1
2
3
2
3
# MCP
# 相关链接
- 官网：https://cursor.com/
- Rules 文档：https://cursor.com/docs/rules
- Agents 文档：https://cursor.com/docs/subagents
- Agent Skills 规范：https://agentskills.io/specification
- Cursor Agent 使用心得 (opens new window)
- Cursor 中 MCP 的接入和使用 (opens new window)
上次更新: 2026/10/18, 22:14:48