Cursor Rules Hub 是什么？为什么存在？

Cursor 的 Agent 默认不知道你的项目用什么栈 / 规范。`.cursorrules`（或新格式 `.cursor/rules/*.mdc`）就是项目级 system prompt——告诉 Cursor『这是一个 Nuxt 4 项目，用 Composition API + UnoCSS + pnpm workspaces，禁止用 axios……』。但写好 rules 需要经验，所以社区把优秀模板聚合：cursor.directory（首推官方风格目录）、awesome-cursorrules（PatrickJS 维护的 GitHub 大目录）、skills-hub.ai（4400+ rules+skills + CLI + lockfile + 安全扫描）。一行 CLI 或复制粘贴就能让 Cursor 懂你的栈。

.cursorrules vs .cursor/rules/*.mdc 怎么选？

Cursor 官方文档明确：legacy `.cursorrules`（项目根单文件，全局加载）仍支持但新项目应该用 `.cursor/rules/*.mdc`。`.mdc` 多文件 + YAML frontmatter + `globs` 字段可以 scope 到特定路径（如 `apps/web/**` 用一套规则，`packages/api/**` 用另一套），还支持 Always / Auto Attached / Agent Requested / Manual 四种激活模式。monorepo / 多栈项目必上 .mdc；纯单一项目可以继续用 .cursorrules。skills-hub.ai CLI 会自动选合适格式写入。

Cursor 3.x 的 alwaysApply: true 不生效是 bug 吗？

是。2026-04 Cursor 社区 forum 多个用户报告：升到 Cursor 3.1.x 后 .mdc 的 `alwaysApply: true` rules 被静默降级为 'requestable'（只在 model 觉得需要时加载），导致项目规范没被遵守。Cursor 官方已确认是 regression。临时解法：(a) 在每次对话开头明确 @rule 名引用；(b) 把核心规范也复制到 `.cursorrules`（双重保险）；(c) 关注 forum.cursor.com 跟踪修复版本；(d) 升 Cursor 时先在小项目验证。

Cursor Rules vs Claude Skills 怎么选？

Cursor Rules（.cursorrules / .mdc）= **全局或路径级 prompt 注入**（每次对话都带，污染 context 但保证遵守），Claude Skills（SKILL.md）= **按需加载**（Claude 判断要不要加载，省 context 但有黑盒性）。决策：(1) Cursor 专属用户 + 项目级规范不变 → .mdc；(2) 跨工具（Cursor + Codex + Claude Code）+ 按需加载 → SKILL.md；(3) skills-hub.ai 同时支持两种格式 + 提供 SKILL.md → .cursorrules 转换，跨工具迁移最省事。大部分团队两者都用：rules 装项目约束，skills 装重复 workflow。

Cursor Rules Hub

Name: Cursor Rules Hub
Rating: 3.6

TL;DR

Cursor Rules Hub 是聚合社区驱动的 .cursorrules / .mdc 共享平台总称，三个最常用入口：(1) cursor.directory（官方风格目录，浏览 + 复制）；(2) awesome-cursorrules（PatrickJS 维护的 GitHub 大目录，PR 投稿）；(3) skills-hub.ai（4400+ rules+skills + npx @skills-hub-ai/cli install 一键装 + .skills.json lockfile + 安全扫描 + 兼容 SKILL.md 跨工具）。2026 重大变化：Cursor 官方推荐 .cursor/rules/*.mdc（多文件 + globs scope + 四种激活模式）取代 legacy .cursorrules；同时要警惕 Cursor 3.1.x alwaysApply: true 偶发不生效 bug。

适合：Cursor / Windsurf 用户；想让 AI 遵守项目栈规范的；monorepo / 多栈项目（需要 path-scoped rules）；想学别人怎么写 rules 的；团队复用规范的。不适合：纯非 Cursor 栈（用 SKILL.md / Claude Skills）；500 字以内的极简项目（手写即可）；完全保密 + 闭源 + 自定 rules 引擎的（不需要市场）。

核心能力

cursor.directory：官方风格浏览 + 复制 + 框架/语言/角色分类
awesome-cursorrules：GitHub 大目录 + 24K+ star + PR 投稿
skills-hub.ai CLI：npx @skills-hub-ai/cli install <slug> --target cursor
lockfile（.skills.json）：团队复现同版本 rules
安全扫描：自动检测 rules 中的危险指令
SKILL.md 跨工具：同一 skill 跑 Cursor / Codex CLI / Windsurf / Copilot / MCP
格式自动适配：CLI 按项目结构选 .cursorrules 或 .mdc
bundle：full-stack-dev-kit 等组合包一键装多 rule
4400+ rules + 90+ 来源（Anthropic / Microsoft / Google / Vercel / Stripe / Cloudflare / Trail of Bits / Prisma / Supabase）
质量分 + 安全分 + 上游 GitHub 链接
路径 scope：.mdc 用 globs 字段限定 apps/web/** 等
四种激活模式：Always / Auto Attached / Agent Requested / Manual

价格

cursor.directory / awesome-cursorrules / skills-hub.ai 全部 $0
skills-hub.ai 后续可能推付费企业 feature（私有 registry / SSO），当前免费

实测（Nuxt 4 + TypeScript 项目）

亮点：

skills-hub.ai CLI 一行装 5 个 rule（nuxt4 / typescript-strict / unocss / pnpm-workspace / code-review）< 2 分钟
lockfile 让团队复现同样 rules，新人开箱即用
.mdc + globs 让 monorepo apps/web 和 packages/api 用不同规则
安全扫描发现一个 rule 里有 rm -rf 指令，及时拦截
SKILL.md 格式让同一规范跨 Cursor + Codex CLI 复用
4400+ rules 长尾需求基本能找到（Elixir / Phoenix / OCaml 都有）
90+ 来源含 Anthropic / Vercel / Stripe 等权威组织 = 信任度高
PR 流程让自家规范也能贡献回社区

踩坑：

Cursor 3.1.x alwaysApply: true 偶发降级，要 forum 跟踪 + 双重保险
部分社区 rule 已过时（react 旧 hook 写法）
长 rule 每次对话消耗 token，建议 < 500 字 / 拆 skill
legacy .cursorrules 与 .mdc 并存时优先级不清
中文 rule 数量少，主要英文
skills-hub.ai 是新项目，长期维护待观察
bundle 安装会装一堆可能用不到的 rule，要 review
Windsurf 有 .windsurfrules，rule 格式略不同要兼容

上手（3 种方式）

方式 1：cursor.directory 复制粘贴

1. 访问 cursor.directory 搜技术栈
2. 复制 .cursorrules 内容
3. 粘贴到项目根 `.cursorrules`
4. 重启 Cursor

方式 2：skills-hub.ai CLI（推荐）

# 装一个 rule
npx @skills-hub-ai/cli install code-review --target cursor

# 装一个 bundle
npx @skills-hub-ai/cli install full-stack-dev-kit --target cursor

# 团队复现
npx @skills-hub-ai/cli install   # 读 .skills.json lockfile

方式 3：手写 .mdc + globs

---
description: Nuxt 4 + UnoCSS 项目规范
globs:
  - apps/web/**
  - components/**
alwaysApply: true
---

使用 Composition API + setup script。
禁止 axios，用 $fetch / useFetch。
组件命名 PascalCase，文件名 kebab-case。

对比

维度	cursor.directory	awesome-cursorrules	skills-hub.ai	Claude Skills
收录	数百	数百 + GitHub PR	4400+ + 90 来源	Anthropic + 社区
CLI 一键装	❌ 复制粘贴	❌ 复制粘贴	✅ + lockfile	claude code 内置
安全扫描	❌	❌	✅	部分
跨工具	Cursor only	Cursor only	✅ SKILL.md 标准	✅
团队复现	手动	手动	✅ lockfile	git
质量分	❌	star 数	✅ + 上游链接	reviews
价格	Free	Free	Free	Claude 订阅
推荐场景	quick start	学写法	团队 / 生产	跨工具能力

避坑

新项目用 .mdc：legacy .cursorrules 仅向后兼容
alwaysApply: true 双重保险：Cursor 3.1.x bug 期间也复制到 .cursorrules
rule 长度控制：单 rule < 500 字，超出拆 skill
scope 用 globs：monorepo 必须 path scope，避免规则相互污染
安全扫描：装 rule 前 review，警惕 rm / curl | sh 等危险指令
lockfile 进版本控制：.skills.json 提交 git，团队复现
过时 rule：定期 review，框架版本升级要同步
Windsurf 兼容：双格式（.cursorrules + .windsurfrules）or 用 skills-hub 自动适配
中文 rule 短缺：自己写常用栈 + 提交 PR 回社区
bundle 慎用：bundle 装多 rule，review 后裁剪

适合 / 不适合

✅ Cursor / Windsurf 用户
✅ 想让 AI 遵守项目规范
✅ monorepo / 多栈项目
✅ 团队复现 + 安全扫描
✅ 想学别人写 rules
❌ 纯非 Cursor 栈（用 SKILL.md）
❌ 极简单文件项目（手写即可）
❌ 完全保密 + 自定 rules 引擎
❌ 不愿引入 npm CLI 的零 Node 项目

来源

cursor.directory 官方风格目录 https://cursor.directory/
awesome-cursorrules GitHub https://github.com/PatrickJS/awesome-cursorrules
Cursor 官方文档 — Rules（.mdc 格式 + 四种激活模式） https://docs.cursor.com/en/context/rules
skills-hub.ai — 4400+ rules + CLI + lockfile + SKILL.md 跨工具 https://skills-hub.ai/cursor-rules
Cursor Forum — Cursor 3.1.x alwaysApply: true 不生效 bug 2026-04 https://forum.cursor.com/t/cursor-rules-not-getting-applied/158740
DCMvn — Configuring Rules & Docs（含 Rule 类型详解表） https://diggtvu.github.io/pyDCMvnDocs/docs/features/configuring-rules-docs

计划	价格	限制	国内支付
cursor.directory	$0	—	—
awesome-cursorrules	$0	—	—
skills-hub.ai	$0	—	—