规则

控制 Agent 模型使用可重用的作用域指令的行为方式。

规则允许你为 Agent 和 Cmd-K AI 提供系统级指导。将它们视为为您的项目或您自己编码上下文、首选项或工作流程的持久方式。

我们支持三种类型的规则：

项目规则

存储在 中，并对其进行版本控制，并限定为您的代码库。.cursor/rules

用户规则

全局到您的游标环境。在设置中定义并始终应用。

.cursorrules（旧版）

仍受支持，但已弃用。请改用 Project Rules。

​规则的工作原理

大型语言模型在完成之间不保留内存。规则通过在提示级别提供持久的、可重用的上下文来解决这个问题。

应用规则时，其内容将包含在模型上下文的开头。这为 AI 提供了一致的指导，无论是生成代码、解释编辑还是帮助工作流。

规则适用于Chat 和Cmd K

​项目规则

项目规则位于 中。每个规则都存储为文件并受版本控制。可以使用路径模式确定其范围、手动调用或根据相关性包含它们。.cursor/rules

使用项目规则可以：

• 对有关代码库的特定于领域的知识进行编码
• 自动执行特定于项目的工作流或模板
• 标准化样式或架构决策

​规则结构

每个规则文件都以 MDC （） 编写，MDC （） 是一种轻量级格式，支持在单个文件中存储元数据和内容。规则支持以下类型：.mdc

​MDC 规则示例

---
description: RPC Service boilerplate
globs: 
alwaysApply: false
---
- Use our internal RPC pattern when defining services
- Always use snake_case for service names.
@service-template.ts

触发规则时，引用的文件（如）将作为附加上下文包含在内。@service-template.ts

您可以使用> “New Cursor Rule” 从 Cursor 中快速创建规则。Cmd + Shift + P

​创建规则

您可以使用命令或转到 来创建规则。这将在目录中创建一个新的规则文件。从 settings 中，您还可以看到所有规则及其状态的列表。New Cursor Rule``Cursor Settings > Rules``.cursor/rules

​生成规则

您可以使用该命令直接在对话中生成规则。/Generate Cursor Rules

当您进行过一次对话，其中就代理应该如何行为做出了许多决定时，这非常有用。只需生成规则并在将来重复使用即可。

​最佳实践

好的规则是重点突出、可作且有范围的。

• 保持规则简洁。低于 500 线是一个不错的目标
• 将大型概念拆分为多个可组合规则
• 在有用时提供具体示例或参考文件
• 避免含糊不清的指导。像编写清晰的内部文档一样编写规则
• 当您发现自己在聊天中重复提示时重复使用规则

​例子

特定于域的指南

前端组件和 API 验证的标准

样板和模板

Express 服务和 React 组件的模板

工作流程自动化

自动化开发工作流程和文档生成

​From Cursor 代码库

这些是我们在 Cursor 内部使用的规则

在 Cursor 中使用 Tailwind

在 Cursor 中添加新设置

Next.js、Cloudflare 和 Browserbase 等提供商提供了许多示例。社区贡献的规则可以在多个在线众包集合和存储库中找到。

​用户规则

用户规则在Cursor Settings > Rules 中定义。

它们适用于所有项目，并且始终包含在模型上下文中。

使用它们可以：

• 设置响应语言或语气
• 添加个人样式首选项

例：

Please reply in a concise style. Avoid unnecessary repetition or filler language.

用户规则不支持 MDC，它们只是纯文本。

​团队规则

目前没有跨项目共享规则的内置方法。

我们计划支持可在 Team Projects 之间引用的共享 MDC 格式规则。在此之前，您可以：

• 将共享规则存储在专用存储库中
• 将它们复制或符号链接到每个项目的目录中.cursor/rules

​.cursorrules（旧版）

项目根目录中的文件仍受支持，但将被弃用。我们建议迁移到 Project Rules 格式，以获得更多的控制力、灵活性和可见性。.cursorrules

​常见问题

为什么我的规则没有被应用？
检查规则类型。对于 ，请确保定义了描述。对于 ，请确保文件模式与引用的文件匹配。Agent Requested``Auto Attached

规则可以引用其他规则或文件吗？
是的。您可以使用 在规则的上下文中包含文件。@filename.ts

我可以通过聊天创建规则吗？
是的。要求 AI “将此转换为规则”或“根据此提示创建可重用的规则”。

规则是否会影响 Cursor Tab 或其他 AI 功能？不。规则仅提供给 Agent 和 Cmd-K AI 模型。