Rules还是Skills？Awesome Cursor Skills详解：Cursor配置体系与自动建议机制完全指南-平芜编程栈

Rules还是Skills？Awesome Cursor Skills详解：Cursor配置体系与自动建议机制完全指南

【免费下载链接】awesome-cursor-skillsA curated list of awesome skills for Cursor项目地址: https://gitcode.com/gh_mirrors/aw/awesome-cursor-skills

用一句话回答标题的疑问：Rules 是常驻的"约定"，Skills 是按需的"工作流"。Awesome Cursor Skills 是一个精心整理的 Cursor 技能资源库，收录了数十个即插即用的SKILL.md指令文件和官方插件，教你如何搭建完整的.cursor配置体系，并让 AI 智能体自动建议 Rules 和 Hooks，把重复纠正变成一次性设置。

为什么需要区分 Rules 与 Skills？

很多新手第一次配置 Cursor 时都会困惑：为什么既有.cursor/rules/又有.cursor/skills/？两者的定位完全不同：

维度	Cursor Rules（规则）	Cursor Skills（技能）
触发方式	常驻生效，每次对话都遵守	按需触发，只在特定任务时启用
内容形态	简洁的约定与风格规范	多步骤的完整工作流程
存放位置	`.cursor/rules/`（`.mdc`文件）	`.cursor/skills/<名称>/SKILL.md`
典型例子	"始终使用命名导出"	"从零搭建 Playwright E2E 测试"

官方定位非常清晰：rules are always-on conventions, skills are on-demand workflows（规则是常驻约定，技能是按需工作流）。想清楚这一点，你的 Cursor 配置体系就不会乱。

Cursor 配置体系：.cursor 目录全景

一个完整的 Cursor 项目配置通常由三层组成：

Rules 层：.cursor/rules/下的.mdc文件，通过 frontmatter 中的description和globs指定生效范围，例如只约束**/*.{ts,tsx}文件的导入风格
Skills 层：.cursor/skills/下的技能文件夹，每个文件夹包含一个SKILL.md，智能体可以自动发现这些文件并据此执行任务
Hooks 层：.cursor/hooks.json定义的事件钩子，比如afterFileEdit事件后自动执行 lint 或类型检查

本项目中，所有技能都以独立文件夹的形式存放在 resources/ 目录下，例如 resources/writing-tests/SKILL.md 教你分析现有代码并编写带正确 mock 和边界用例的测试，resources/systematic-debugging/SKILL.md 则提供"复现 → 隔离 → 假设 → 验证"的结构化调试方法论。

自动建议机制：AI 主动帮你沉淀配置

这个项目的最大亮点，是三个专门让 AI"长记性"的内置技能，它们都带有user-invocable: false标记，意味着由 AI 自主判断触发，而非用户手动调用：

1. 建议 Cursor Rules：纠正两次，永久编码

对应文件 resources/suggesting-cursor-rules/SKILL.md。它的触发条件很人性化：

你第 2 次以上纠正同一模式（比如反复说"用命名导出"）
你表达了不耐烦，或说出"我总想要…"、"永远不要…"这类话
智能体在这个项目里反复犯同一个错误

触发后，AI 会自然地开口："我注意到你纠正过我几次关于 [某模式] 的问题，要不要我创建一个 Cursor 规则，以后一直遵守？"你只需答应，它就在.cursor/rules/下生成对应的.mdc文件。同时它也约束自己：不要烦人——只在真正重复的模式出现后才建议，而不是第一次纠正就唠叨。

2. 建议 Cursor Hooks：重复的检查，交给自动化

对应文件 resources/suggesting-cursor-hooks/SKILL.md。当你多次要求"跑一下 lint"、"检查类型"、"跑测试"时，AI 会建议你用钩子自动完成，并给出常见映射：

你反复要求的操作	建议的自动化
"跑 lint / 修格式"	`afterFileEdit`事件触发`eslint --fix`
"检查类型"	`afterFileEdit`后执行`tsc --noEmit`
"跑测试"	`afterFileEdit`后运行相关测试文件
"别碰 .env"	`beforeShellExecution`时对密钥文件告警

它还内置了工程化约束：钩子脚本必须5 秒内跑完（否则会拖慢智能体体验）、以退出码 0 和标准输出汇报、合并而非覆盖已有的hooks.json。

3. 建议 Skills：卡住了？可能有现成方案

对应文件 resources/suggesting-skills/SKILL.md。当你在做某件已有技能覆盖的事情时（比如问"怎么加 Sentry？"），AI 会主动指出："有个技能就是干这个的——adding-error-tracking可以处理 Sentry 的接入、source map 和性能监控，要我用它吗？"

它的克制原则同样值得学习：每轮对话最多建议一次，用户拒绝后不再重复打扰，且只在时机自然时（你正要动手之前）提出。

这三个技能共同构成了一个"自我进化"的闭环：你的每次重复纠正，都会被 AI 转化为 Rules、Hooks 或 Skills 配置，配置体系随使用自然生长。

新手最值得装的 5 个技能

资源库按功能分为 Cursor-Native、测试、工作流、基础设施、代码质量等十余个分类。如果你刚起步，建议从这 5 个入手：

grinding-until-pass（resources/grinding-until-pass/SKILL.md）：让 AI 自主循环"修复 → 运行 → 检查"，直到测试全绿、构建通过或 lint 干净。自带安全护栏：最多 10 轮迭代、禁止删测试、禁止用@ts-ignore压制错误——大重构后"让它自己磨到绿"的利器
codebase-onboarding（resources/codebase-onboarding/SKILL.md）：派出多个只读子智能体并行调研架构、数据模型、认证、API 与部署，最后合成一份新人上手文档
writing-tests（resources/writing-tests/SKILL.md）：分析现有代码，生成带 mock、边界用例和断言的单元/集成测试
parallel-code-review（resources/parallel-code-review/SKILL.md）：同时启动 4 个只读子智能体，分别从安全、性能、正确性、可读性四个视角审查同一份 diff，合并成一份带优先级的审查报告
systematic-debugging（resources/systematic-debugging/SKILL.md）：用 git bisect、二分查找和日志定位问题，替代"玄学试错"式排错

此外，官方插件市场（Cursor Settings > Plugins）还内置了 Figma、Stripe、Sentry、Vercel 等插件包，一个插件往往捆绑多个技能，适合不想手动管理的用户。

安装步骤：3 步上手

git clone https://gitcode.com/gh_mirrors/aw/awesome-cursor-skills

打开你喜欢的技能文件夹，比如resources/writing-tests/
把SKILL.md复制到项目的.cursor/skills/writing-tests/SKILL.md（个人全局可用则放到用户目录下的.cursor/skills/）
智能体自动发现该文件，下次遇到对应任务时就会按技能描述工作——无需任何额外配置

每个SKILL.md的头部都有 YAML frontmatter：name定义技能名，description是智能体判断"何时用我"的依据，user-invocable决定能否手动调用。想自己写技能？参考 resources/building-skills-from-patterns/SKILL.md，它教你把重复的多步流程沉淀为新的SKILL.md。

参与贡献

项目欢迎社区提交新技能。贡献规范见 CONTRIBUTING.md：提交前搜索已有条目、遵循"名称 + 短描述"的条目格式、单个 PR 只加一个条目。质量门槛也很明确——技能需在近一年内活跃维护、有清晰的SKILL.md文档、兼容 Cursor 的.cursor/skills/或插件格式，且提供真实价值（而不是单条提示词的包装）。