你可能在用 Cursor 写代码,也可能已经知道 .cursorrules 文件可以自定义 AI 行为。但你知道吗?围绕 Cursor 的 Rules 系统已经长出了一个庞大的生态——从让 500 个请求变成 2500 个的"请求放大器",到把14本软件工程经典著作蒸馏成 AI 规则,再到一套工具同时管理 30+ 种 AI Agent 的配置。这些隐藏玩法,国内几乎没人系统性讲过。今天这篇文章,带你一次性解锁 Cursor Rules 生态里最值得掌握的 8 个隐藏技巧。
.cursorrules,拥抱 .mdc 项目规则大多数国内用户还在用根目录的 .cursorrules 单文件来写规则。但 Cursor 早已升级到了 .mdc(Markdown Context)项目规则系统,支持按文件类型、目录、甚至 glob 模式自动匹配不同的规则。
具体操作步骤:
.cursor/rules/ 文件夹.mdc 文件,文件头加上 YAML front matter:---
description: "React组件开发规范"
globs: ["src/components/**/*.tsx"]
alwaysApply: false
---
# React 组件开发规范
- 使用函数组件 + TypeScript
- Props 必须定义 interface
- 样式统一使用 Tailwind CSS
src/components/**/*.tsx 的文件时自动加载这条规则预期效果: 相比单文件 .cursorrules,你可以为不同模块设置不同规范——API 层用 RESTful 规范,测试文件用 testing 规范,互不干扰。这是团队协作的基础。
适用场景: 任何多人项目,尤其是前后端分离或 monorepo 项目。
你不需要从零手写规则。awesome-cursorrules 是目前最大的 Cursor 规则集合,⭐39812 颗星,覆盖 200+ 个场景。
具体操作步骤:
rules/ 目录下找到你的技术栈对应的 .mdc 文件.cursor/rules/ 目录即可重点推荐规则:
| 规则名 | 适用场景 | 亮点 |
|---|---|---|
nextjs15-supabase |
Next.js + Supabase | 27条防AI幻觉规则,防不安全认证 |
anti-sycophancy-code-discipline |
所有项目 | 17条指令,阻止AI编造API和签名 |
nestjs-anti-hallucination |
NestJS | 阻止废弃/幽灵导入 |
pr-review |
代码审查 | 按安全/性能/测试/架构四维度审查 |
harmony-arkts |
鸿蒙开发 | 鸿蒙 ArkTS 组件和生命周期规范 |
为什么值得关注: 这些规则经过社区千锤百炼。比如 anti-sycophancy-code-discipline 专门解决 AI "谄媚症"——当你问"这样写对吗?",AI 总是回答"是的"而不是真正审查代码。这条规则强制 AI 在不确定时说"不确定"。
Cursor Pro 每月大约 500 个快速请求。对于重度用户,这远远不够。Review Gate V2(⭐1532)是一个 MCP 工具,让一个请求当五个用。
核心原理:
graph LR
A[用户发起1个请求] --> B[Cursor执行任务]
B --> C[Review Gate弹出交互框]
C --> D{用户输入}
D -->|文本/语音/图片| E[Cursor继续执行]
E --> C
D -->|TASK_COMPLETE| F[请求结束]
style A fill:#FF9800
style F fill:#4CAF50,color:#fff
具体操作步骤:
git clone https://github.com/LakshmanTurlapati/Review-Gate.git
cd Review-Gate/V2
./install.sh # macOS
复制 V2/ReviewGateV2.mdc 规则到 Cursor 设置中
安装 Cursor 扩展:V2/review-gate-v2-2.7.3.vsix
重启 Cursor
核心玩法: 当你给 Cursor 一个复杂任务时,AI 执行完初始部分后会自动弹出交互框。你可以:
- 打字:"给新函数加 docstring"
- 说话:点击麦克风,语音输入(本地 Whisper 处理,不上传云端)
- 上传图片:截图、设计稿、架构图直接发给 AI 看
- 输入 TASK_COMPLETE 结束
省钱计算: 假设你每月 500 个请求,每个请求平均用 5 轮 Review Gate 交互 = 实际获得 2500 轮对话效果。相当于 Pro 订阅的价值翻了 5 倍。
你可能在 Cursor 写代码、在 Claude Code 做架构、用 GitHub Copilot 做补全、用 Codex CLI 做批量任务……每个工具都有自己的配置文件格式。Ruler(⭐2729)解决了这个痛点。
支持的 Agent(部分列表):
| Agent | 规则文件 | MCP配置 |
|---|---|---|
| Cursor | AGENTS.md |
.cursor/mcp.json |
| Claude Code | CLAUDE.md |
.mcp.json |
| GitHub Copilot | AGENTS.md |
.vscode/mcp.json |
| Windsurf | AGENTS.md |
.windsurf/mcp_config.json |
| Cline | .clinerules |
- |
| Aider | AGENTS.md |
.mcp.json |
| Gemini CLI | AGENTS.md |
.gemini/settings.json |
| Kiro | .kiro/steering/ |
.kiro/settings/mcp.json |
| JetBrains AI | .aiassistant/rules/AGENTS.md |
- |
| Warp | WARP.md |
- |
具体操作步骤:
npm install -g @intellectronica/ruler
cd your-project
ruler init
在 .ruler/AGENTS.md 中编写你的统一规则
一键分发:
ruler apply # 分发到所有已安装的Agent
ruler apply --agents cursor,claude # 只分发到指定Agent
高级玩法——嵌套规则: 对于 monorepo,你可以在不同子目录放置不同的 .ruler/ 目录:
project/
├── .ruler/ # 全局规则
├── frontend/
│ └── .ruler/ # 前端规则(React规范)
├── backend/
│ └── .ruler/ # 后端规则(API规范)
└── tests/
└── .ruler/ # 测试规则
ruler apply --nested # 启用嵌套模式
agent-rules-books(⭐1702)把 14 本经典软件工程著作的核心原则蒸馏成了 AI 可以理解的规则文件。
收录的经典书籍:
| 书名 | 规则数(mini版) | 适用场景 |
|---|---|---|
| Clean Code | 29条 | 日常编码、代码审查 |
| Clean Architecture | 31条 | 系统设计、模块拆分 |
| Designing Data-Intensive Applications | 37条 | 数据系统、分布式架构 |
| Domain-Driven Design | 30条 | 业务建模、DDD实践 |
| Refactoring | 31条 | 重构、代码异味检测 |
| The Pragmatic Programmer | 47条 | 通用工程实践 |
| Working Effectively with Legacy Code | 32条 | 遗留代码改造 |
| Release It! | 30条 | 生产稳定性、容错设计 |
每个规则集提供三个版本: - full:完整版(300-900行),深度参考 - mini:精简版(46-65行),推荐日常使用 - nano:极简版(32-44行),上下文预算紧张时使用
具体操作步骤:
# 比如你需要 Clean Code 规则
curl -o clean-code.md https://raw.githubusercontent.com/ciembor/agent-rules-books/main/clean-code/clean-code.mini.md
cp clean-code.md .cursor/rules/clean-code.mdc
---
description: "Clean Code 编码规范"
alwaysApply: true
---
实测效果: 项目作者做了一个实验——用 mini 规则集重构一个 CLI 项目 vs 只告诉 AI "遵循 Clean Code 原则",前者得分 74/100,后者只有 46/100。把具体规则喂给 AI,比只提书名效果好 60%。
RIPER-5(⭐2627)是一个专为中国开发者设计的 AI 编码行为协议。它的核心理念是:不要让 AI "自由发挥",而是通过分阶段的严格流程来约束 AI 行为。
RIPER 五阶段流程:
graph TD
R[Request 需求分析] --> I[Investigate 调查研究]
I --> P[Plan 制定计划]
P --> E[Execute 执行实现]
E --> V[Verify 验证确认]
V -->|不通过| R
V -->|通过| D[任务完成]
style R fill:#F44336,color:#fff
style I fill:#FF9800
style P fill:#2196F3,color:#fff
style E fill:#4CAF50,color:#fff
style V fill:#9C27B0,color:#fff
style D fill:#607D8B,color:#fff
具体操作步骤:
curl -O https://raw.githubusercontent.com/NeekChaw/RIPER-5/main/RIPER-5/RIPER-5-CN.md
将内容复制到 Cursor 的全局规则设置中(Settings → Rules)
当你给 AI 一个复杂任务时,AI 会自动按照 R→I→P→E→V 五步执行
预期效果: AI 不再"上来就写代码",而是先理解需求、调查现有代码、制定计划、逐步执行、最后验证。尤其适合复杂功能开发和大规模重构。
配套工具链: RIPER-5 仓库还提供了多种场景化提示词: - "Linux之父帮你重构代码"——模拟 Linus Torvalds 审查代码 - "超深度思考"——多代理协作(架构师+研究员+程序员+测试员) - "专业高效提交 Git"——结构化 commit 信息
steipete/agent-scripts 是由知名 iOS 开发者 Peter Steinberger 维护的高级 Agent 脚本集合。它的核心创新是 Skills 路由系统。
核心概念:
每个 Skill 是一个独立的工作流,存放在 skills/<name>/SKILL.md 中,带 YAML front matter:
---
name: autoreview
description: "Auto review code changes"
---
Symlink 跨项目复用:
# 全局 Skills 目录
~/.claude/skills -> ~/Projects/agent-scripts/skills
~/.codex/skills -> ~/Projects/agent-scripts/skills
实战技巧——创建自定义 Skill:
~/.claude/skills/ 下创建新目录:mkdir -p ~/.claude/skills/my-react-component
SKILL.md:---
name: my-react-component
description: "Create React component with TypeScript and tests"
---
## 工作流
1. 分析需求,生成组件 interface
2. 创建组件文件(函数组件 + TypeScript)
3. 创建测试文件(Vitest + Testing Library)
4. 创建 Storybook story
5. 运行测试验证
MCP(Model Context Protocol)不只是连接外部工具——配合 Rules 使用,可以给 Cursor 打造完整的开发环境。
具体操作步骤:
.cursor/mcp.json:{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/project"]
},
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_TOKEN": "your-token"
}
},
"review-gate-v2": {
"command": "python3",
"args": ["-m", "review_gate_v2"]
}
}
}
ruler apply --with-mcp # 自动分发MCP配置到所有Agent
.cursor/rules/ 中创建规则,指导 AI 如何使用这些 MCP 工具:---
description: "MCP工具使用规范"
alwaysApply: true
---
# MCP工具使用规范
- 使用 filesystem MCP 读写文件,不要用 shell 命令
- 使用 github MCP 创建 PR 和 Issue
- 使用 review-gate-v2 在任务中途请求用户反馈
| 你以为的 | 实际上的 |
|---|---|
Cursor Rules 就是 .cursorrules 一个文件 |
.mdc 项目规则支持按文件类型、目录自动匹配 |
| 每个AI工具要单独写配置 | Ruler 一套规则分发到 30+ 种 Agent |
| 每月500请求不够用 | Review Gate V2 一个请求当五个用 |
| AI 编码质量靠运气 | 经典书籍规则化,质量提升 60% |
| 中文社区缺少高级规则 | RIPER-5 专为中文开发者设计 |
| MCP 只是连接数据库 | MCP + Rules = 可编程的 AI 开发环境 |
今天就能做(10分钟):
1. 把项目的 .cursorrules 迁移到 .cursor/rules/*.mdc 格式
2. 从 awesome-cursorrules 下载你的技术栈对应的规则
本周可以做(1小时): 3. 安装 Ruler,统一管理你的所有 AI Agent 配置 4. 从 agent-rules-books 选择一本适合你的书籍规则
进阶玩法(周末项目): 5. 安装 Review Gate V2,体验请求放大效果 6. 试试 RIPER-5 的行为协议框架 7. 创建自己的 Skills 体系,像 steipete 一样跨项目复用
本文由「51学通信」技术团队出品。51学通信由通信行业18年老兵爱卫生(微信ID: gprshome201101)维护。 聚焦5G/6G核心网、3GPP标准、AI工具实战。知识星球「51学通信」提供深度技术答疑和行业洞察。
[!tip] 51学通信知识星球 星主:爱卫生(微信:gprshome201101)——公众号「51学通信」创办者,19 年通信行业运维与讲师经验,著有《GPRS网络信令实例详解》《EPC原理与实践》《5G核心网原理与实践》三本纸质书(各大电商平台有售)。 星球定位:深耕 5G 核心网、IMS、NFV/AI、云原生等 ICT 领域,主打运维岗位与信令分析。 当前规模:5200 篇主题 / 990 个回答,198 元/年。 加入福利:加入星球后请加爱卫生微信,拉您进知识星球年度陪伴与答疑群——不限量回复您的各种问题,另有群内分享。 AI 加持:51学通信知识星球已作为 skill 接入 WorkBuddy,使用 deepseek-4-flash 在海量星球帖子中精准找贴、找视频、找 FAQ 和案例,做总结、找文档和 PPT 等场景全覆盖。
