Cursor 规则库

这个 pack 装了什么

Cursor 的 Project Rules（.cursor/rules/ 下的 .mdc 文件）是给一个代码库锁死风格、架构、流程预期的最高杠杆工具。Cursor 默认安装不带规则；团队要么从零写（慢、漂移），要么每个项目粘贴同样模板（无共享维护）。这个 pack 收齐 九个 .mdc 包，覆盖多数团队真想要的 80%，加一个从你现有文档生成定制规则的 MDC 生成器。

为什么要装

没有规则的 Cursor agent 是通才。装上规则就是有立场的队友 —— 它已经懂你的栈、习语、护栏。装这个 pack 后团队报的三个具体收益：

1. 新人 onboarding 从天到小时。新工程师 Cmd-K 出来的代码已经长得像代码库其他部分，因为 Cursor 在读人类入职第一天读的同一份约定文档。
2. review 疲劳下降。reviewer 不再每个 PR 都揪同样五个风格/架构小问题 —— 规则在生成阶段就抓了。review 聚焦逻辑和取舍，那才是人类增值最多的地方。
3. AI 越界被限制。Devin 工程师模式规则建立「先规划、最小修改、别重构无关代码」。单这条规则就阻止了 Cursor 最常见的失败：一行 bug 修变成 200 行没要求的「优化」。

一条命令装齐

# 装整个 pack 进当前项目
tokrepo install pack/cursor-rules-library

# 或者只装单个语言 / 框架
tokrepo install python-cursor-rules
tokrepo install react-cursor-rules
tokrepo install devin-engineer-mode

TokRepo CLI 把 .mdc 文件写进 repo 的 .cursor/rules/。Cursor 下次 prompt 就拿到 —— 不用重启。从你现有文档重新生成规则：

tokrepo run mdc-generator --input ./docs --output ./.cursor/rules/project.mdc

常见坑

• 一条大规则覆盖一切。Cursor 按 glob 范围每次请求加载匹配规则。一个 2000 行的 .mdc 把你每次 prompt 的上下文预算炸掉。按域拆：语言规则一个文件，架构一个，安全一个。
• 没设 glob 范围。一个后端规则在每个前端文件都触发会浪费 token 还把 agent 带偏。在 frontmatter 用 globs: 把规则限到 **/*.py、app/**/*.tsx 等。
• 非 Devin 工具忽略 Devin 工程师模式。这条规则其实不是 Devin 专属 —— 它是通用的「像高级工程师那样」操作手册。在 Cursor / Claude Code / Codex CLI / Cline 一样能跑（用 Skill 生态 pack 的转换器）。
• 把规则当静态的。栈在演进，规则也得演进。.cursor/rules/ 进版本控制，像别的代码一样在 PR 里 review 改动。文档变时 MDC 生成器能重新发规则。
• 粘贴跟现实漂移的代码示例。规则说「X 用 fooBar()」结果代码里是 bar_foo()，比没规则更糟。要么示例最少最抽象，要么用 MDC 生成器从真代码生成。

这个 pack 一个不够时

如果你同时用 Cursor 和别的 AI 工具（Claude Code / Codex CLI 等），直接写 .mdc 把你锁死在 Cursor。Skill 生态 pack 让你用规范 skill 格式写一次，给 Cursor 出 .mdc、给 Codex CLI 出 AGENTS.md、给 Claude Code 出 subagent 等。只用 Cursor 就用这个 Cursor 规则库 pack；多工具就转用 skill。

纯 Cursor 重度用户：配合 AI 代码编辑器横评 pack，看 Cursor 跟 Zed / Cody / Continue / Morphic / OpenCode 比哪赢哪输 —— 内部推 Cursor 或决定何时换工具时有用。