Cursor Rules Directory：模板库、示例和生成器

功能对比

模板	适合场景	建议文件
项目基线	每个仓库都需要命令和核心约定	.cursor/rules/project.mdc
React 或 Next.js 前端	组件、路由、样式、可访问性	.cursor/rules/frontend.mdc
后端 API	路由、服务、数据库访问、认证边界	.cursor/rules/backend.mdc
Monorepo package	不同 package 命令不同	.cursor/rules/package-name.mdc
测试	测试命名、fixture、mock 和命令	.cursor/rules/tests.mdc
审查防护	避免危险改动和无关 churn	.cursor/rules/review.mdc

目录结构

把规则放在仓库里，并按工作流或代码区域命名。

.cursor/
  rules/
    project.mdc
    frontend.mdc
    backend.mdc
    tests.mdc
    review.mdc

项目基线模板

新仓库先用这个模板，再把命令改成真实 package manager。

---
description: Project baseline rules
globs: ["**/*"]
---
Use the existing architecture before adding new abstractions.
Prefer small, reviewable diffs.
Run the narrowest relevant test first, then run the full build before release.
Do not edit generated files unless the task explicitly requires it.

前端模板

把前端规则限定在 app 和 component 文件上，让 Cursor 编辑 UI 代码时能读到。

---
description: Frontend rules
globs: ["app/**/*", "components/**/*", "src/**/*.{tsx,jsx,css}"]
---
Use existing components and design tokens before creating new patterns.
Keep interactive states accessible.
Check mobile layout for text wrapping and overflow.
Run npm run build after route or component changes.

后端模板

后端规则应该写清楚边界和数据安全期待。

---
description: Backend API rules
globs: ["api/**/*", "server/**/*", "src/**/*.{ts,js}"]
---
Keep validation close to request boundaries.
Do not widen auth or database permissions without explicit review.
Prefer existing service helpers before adding new clients.
Run targeted API tests for route, schema, or migration changes.

生成自定义规则

如果要按项目栈、命令、代码风格和审查期待生成 .cursor/rules/project.mdc，可以使用本地生成器。

打开 Cursor Rules Generator 阅读 Cursor Rules 设置指南

常见问题

Cursor Rules 放在哪里？

项目规则通常放在仓库的 .cursor/rules 目录，使用一个或多个 .mdc 文件。

应该创建很多 Cursor Rules 文件吗？

不必。先从 project.mdc 开始，只有当前端、后端、测试或 package 规则不同才拆分。

Cursor Rules 可以包含命令吗？

可以。好的规则会写真实 install、lint、test、typecheck 和 build 命令。

Cursor Rules 应该提交吗？

如果代表团队约定且不含密钥或本地路径，通常应该提交。