用途:通过 Cursor 的规则系统配置项目专属的 AI 行为,把工程规范作为可版本控制的策略来管理,使规则具体、有范围、可评审,并与仓库事实来源保持一致。
主要能力:支持现代项目规则 .cursor/rules/*.mdc 文件,每个文件由 YAML frontmatter 加 Markdown 内容组成,字段包括 description、globs、alwaysApply。alwaysApply 为 true 且 globs 为空时始终注入每个提示;alwaysApply 为 false 且设置 globs 时,在匹配文件进入上下文时自动附加;alwaysApply 为 false 且 globs 为空时仅手动引用。文件命名建议使用 kebab-case 与 .mdc 扩展名。仍支持旧版 .cursorrules 文件,但已弃用。可在规则中用 @file 语法引用额外上下文文件。
使用方式:通过 Cmd+Shift+P > New Cursor Rule 创建规则;将共享规则纳入源码控制,用路径范围规则处理本地约定;在非敏感夹具上测试新规则并检查行为,再经正常评审合并;定期删除过时或冲突规则,并记录有意保留的例外。迁移时先创建 .cursor/rules/ 目录,把全局上下文提取为 alwaysApply: true 的规则,把语言或框架规则提取为 glob 范围规则,验证全部规则加载后再删除 .cursorrules。调试时在 Chat 输入 @Cursor Rules 查看生效规则,并检查 glob 是否匹配。
适用场景:需要为团队统一 AI 编码行为、按路径限定 API 或前端规则、把工程与安全标准固化为可审计文档的项目。
限制与注意:规则不得包含 API 密钥、机密或凭据;单条规则建议聚焦并控制在 200 行以内;规则冲突时应收敛到单一权威并测试后再发布;规则过宽时按路径或任务限定范围,而不是禁用全部共享治理;规则若暴露敏感内容应立即移除、修复忽略控制并评估暴露情况。前置条件包括仓库所有者批准、既有工程与安全标准,以及测试工作区和对机密、生成文件、敏感数据的忽略策略。具体收费、价格与平台支持情况暂未提供。