规则范围与优先级

规则作为模型上下文提供长期指导。先决定谁需要这条指令、何时需要，再选择规则类型；不要把所有项目约定都放进全局用户规则。

各层规则

范围	设置位置与用途
Team	Dashboard 管理的团队共同要求
Project	.cursor/rules/*.mdc，随仓库管理
User	Customize > Rules，全局个人偏好
AGENTS.md	项目根或子目录的普通 Markdown 指令

Team、Project、User 的顺序为 Team → Project → User，所有适用项合并，冲突时较早来源优先。规则是 AI 指导，不应成为唯一访问控制。

团队启用与强制

Enable this rule immediately 决定创建后是否立即生效；未选时保留为 draft，尚不应用。Enforce this rule 决定成员能否在 Customize 停用，非强制规则默认可以由用户关闭。

团队规则支持 glob：有模式时只在匹配文件进入上下文后应用，无模式时应用于团队各项目的聊天。其内容为自由文本，不使用项目规则的目录结构。

嵌套 AGENTS.md

根目录文件提供通用要求，子目录文件用于对应目录及其子树。嵌套要求与父级合并，更具体的指令优先。例如 frontend/AGENTS.md 可补充前端约定，backend/AGENTS.md 可描述服务端接口约束。

引用不是自动内联

规则中的 @service-template.ts 保留为路径提示，Agent 需要时用工具读取文件，文件内容不会自动塞进上下文。这一点在编辑器、CLI、Cloud Agents 相同。必须始终看到的短约束应直接写在规则正文。

规则不影响 Cursor Tab；User Rules 也不应用于 Inline Edit。需要自主 Tab 的文件控制时，使用对应 Hooks。

共享与检查

从仓库导入规则需要打包为插件并通过市场安装，不能把任意仓库当作独立规则源。未生效时检查 .mdc 扩展名、description、globs 和当前上下文，具体触发字段见Rules。