Cursor 项目规则要写在仓库的 .cursor/rules/中,并使用 .mdc文件。要限制组件修改范围,可用 globs只让规则在匹配的组件文件进入上下文时自动附加,再在规则正文写出能检查的约束。规则是给 Agent 的指引,不能代替 Git 差异审查或自动化测试。
先确定规则要解决的重复问题
假设团队反复遇到 Agent 改 React 组件时顺手修改服务层,目标应写成“组件任务只改组件及其样式;确需跨层时先说明原因”。这是教学场景,不是对某个真实仓库的诊断。先检查项目现有目录和规则,避免新增一份相互冲突的约束。Cursor 官方 Rules 文档建议规则聚焦、可执行,并优先引用现有规范文件。

建立只作用于组件文件的 .mdc 规则
在项目根目录建立 .cursor/rules/components.mdc。以下示例假定组件位于 src/components/;你的仓库路径不同就改 globs:
---
globs: src/components/**/*.tsx
alwaysApply: false
---
处理 src/components 下的组件时:
1. 先阅读当前组件和相邻样式文件,再提出改动。
2. 默认只修改该组件及相邻样式;若需要修改 API 或服务层,先说明原因和影响文件。
3. 完成后列出修改文件与验证命令,不把未运行的测试写成已通过。
官方文档说明:项目规则是带 frontmatter 的 .mdc文件;当 alwaysApply: false且提供 globs时,匹配文件进入上下文后规则会自动附加。直接把普通 .md文件丢进 .cursor/rules/不会按项目规则识别。若只需简单的全项目说明,也可用项目根目录的 AGENTS.md,但不要把同一条要求散落在多个地方。
检查是否生效,以及如何避免误判
- 保存规则后,在 Cursor 的 Customize → Rules查看规则与状态;也可从 Agent 中用
/create-rule创建规则,官方文档列有这两个入口。 - 在一项真实组件任务中明确引用匹配的
.tsx文件,要求 Agent 先说明计划。核对它是否遵循“跨层修改先说明”的约束。 - 查看最终 diff:若它仍改了服务层,记录具体原因并修正规则或缩小任务范围。规则出现于上下文不等于每次行为都可靠。
Cursor 官方文档还说明,项目 Rules 作用于 Agent(Chat),不会控制 Cursor Tab 等其他 AI 功能。本文示例未在读者仓库中运行;实际 glob 是否匹配、规则是否与团队规则冲突,都需按当前项目和 Cursor 版本核对。资料核验日期为 2026 年 10 月 1 日。
Ai菜鸟网。发布者:AI小管家,转载请注明出处:https://www.alyyhw.com/29790.html