Rules还是Skills?Awesome Cursor Skills详解:Cursor配置体系与自动建议机制完全指南 Rules还是SkillsAwesome 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后运行相关测试文件别碰 .envbeforeShellExecution时对密钥文件告警它还内置了工程化约束钩子脚本必须5 秒内跑完否则会拖慢智能体体验、以退出码 0 和标准输出汇报、合并而非覆盖已有的hooks.json。3. 建议 Skills卡住了可能有现成方案对应文件 resources/suggesting-skills/SKILL.md。当你在做某件已有技能覆盖的事情时比如问怎么加 SentryAI 会主动指出有个技能就是干这个的——adding-error-tracking可以处理 Sentry 的接入、source map 和性能监控要我用它吗它的克制原则同样值得学习每轮对话最多建议一次用户拒绝后不再重复打扰且只在时机自然时你正要动手之前提出。这三个技能共同构成了一个自我进化的闭环你的每次重复纠正都会被 AI 转化为 Rules、Hooks 或 Skills 配置配置体系随使用自然生长。新手最值得装的 5 个技能资源库按功能分为 Cursor-Native、测试、工作流、基础设施、代码质量等十余个分类。如果你刚起步建议从这 5 个入手grinding-until-passresources/grinding-until-pass/SKILL.md让 AI 自主循环修复 → 运行 → 检查直到测试全绿、构建通过或 lint 干净。自带安全护栏最多 10 轮迭代、禁止删测试、禁止用ts-ignore压制错误——大重构后让它自己磨到绿的利器codebase-onboardingresources/codebase-onboarding/SKILL.md派出多个只读子智能体并行调研架构、数据模型、认证、API 与部署最后合成一份新人上手文档writing-testsresources/writing-tests/SKILL.md分析现有代码生成带 mock、边界用例和断言的单元/集成测试parallel-code-reviewresources/parallel-code-review/SKILL.md同时启动 4 个只读子智能体分别从安全、性能、正确性、可读性四个视角审查同一份 diff合并成一份带优先级的审查报告systematic-debuggingresources/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 frontmattername定义技能名description是智能体判断何时用我的依据user-invocable决定能否手动调用。想自己写技能参考 resources/building-skills-from-patterns/SKILL.md它教你把重复的多步流程沉淀为新的SKILL.md。参与贡献项目欢迎社区提交新技能。贡献规范见 CONTRIBUTING.md提交前搜索已有条目、遵循名称 短描述的条目格式、单个 PR 只加一个条目。质量门槛也很明确——技能需在近一年内活跃维护、有清晰的SKILL.md文档、兼容 Cursor 的.cursor/skills/或插件格式且提供真实价值而不是单条提示词的包装。总结Rules 管永远怎么做Skills 管某件事怎么做Hooks 管改完自动做什么三者互补而非替代Awesome Cursor Skills 的核心价值不只是资源列表而是那三个自动建议技能——它让 AI 记住你的纠正把配置体系变成自我生长的系统新手从grinding-until-pass、codebase-onboarding等高频技能装起复制一个SKILL.md即可生效【免费下载链接】awesome-cursor-skillsA curated list of awesome skills for Cursor项目地址: https://gitcode.com/gh_mirrors/aw/awesome-cursor-skills创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考