Cursor 规则设置：项目、用户和 Team Rules、.mdc frontmatter、globs 与 AGENTS.md

• Project Rules：.cursor/rules 中的 .mdc 文件。它们受版本控制，作用范围为代码库。支持子文件夹。
• User Rules：在 Cursor 规则设置中配置的全局偏好。适用于所有项目。
• Team Rules：在 Team 和 Enterprise 计划中通过 Cursor 后台管理。
• AGENTS.md：不带元数据的纯 markdown 指令。

项目规则必须使用 .mdc 扩展名。.cursor/rules 中的普通 .md 文件会被规则系统忽略。

• Always Apply：alwaysApply: true。包含在每个聊天会话中。
• Apply to Specific Files：alwaysApply: false 加 globs。当匹配的文件在上下文中时附加。
• Apply Intelligently：alwaysApply: false 加 description，不设 globs。Agent 会在相关时引入。
• Apply Manually：不设 description 或 globs。仅在你 @ 提及它时使用。

多个 glob 模式用逗号分隔。例如，src/**/*.tsx 匹配 src/ 下的 .tsx 文件。

---
globs: src/components/**/*.tsx
alwaysApply: false
---

- Use named exports, not default exports
- Keep components under 200 lines
- Prefer composition over prop drilling

---
alwaysApply: true
---

- Read the relevant source files before proposing changes
- Never modify generated files in dist/ or build/

规则中的 @file 引用告诉 Agent 去哪里查找。该文件不会被内联，因此必须始终在上下文中的内容请写在规则正文中。

• 适用于 Team 和 Enterprise 计划。管理员在 Cursor 后台创建和管理。
• Team Rules 是自由格式文本，不使用 .cursor/rules 文件夹结构。
• 每条规则可以是强制或可选的。用户可以在 Customize 的 Team Rules 下关闭非强制的 Team Rule。强制规则无法在那里禁用。
• 带 glob 模式的规则仅在匹配文件位于上下文中时生效。不带 glob 的规则适用于每个对话。
• 不勾选启用框可将规则保存为草稿，在你启用之前不会生效。
• 已启用的 Team Rules 会包含在团队所有仓库和项目的 Agent（Chat）上下文中。

Cursor 指出，即使是强制规则，AI 指导也不应成为你唯一的安全控制手段。

将 AGENTS.md 放在项目根目录。子目录中嵌套的 AGENTS.md 文件在该目录中工作时生效。它们会与父级文件合并，更具体的文件优先。

• 优先级为 Team Rules、Project Rules、User Rules。所有规则会合并，冲突时靠前的来源优先。
• User Rules 仅适用于 Agent，不适用于 Inline Edit。
• 规则不影响 Cursor Tab。
• 每条规则保持在 500 行以内，并将大规则拆分为多个小规则。