先开门见山。Cursor Skills 是 Cursor 这款 AI 编程编辑器里的一项核心能力:把“指令 + 示例 + 输出格式”打包成一个 markdown 文件,放到指定目录,当你在对话里提出相关需求时,AI 会自动加载这份技能说明,并按你定义的规范工作。我最初以为它只是 Rules 换了个名字,真正用起来才发现,它解决的是我一直很头疼的问题——每次开新项目都要重新交代技术栈、编码规范、输出格式,现在全装进技能包里,让 AI 自己读。
这篇指南适合三类人:刚接触 Cursor 的小白,想知道 Skills 怎么用、在哪配;已经在用 Cursor 但总感觉 AI 回答不够“懂你”的开发者;以及对 agent 指令工程感兴趣、想系统化提升 AI 协作效率的朋友。我会从原理讲到安装,从白嫖社区技能包到自己手写,最后附上我在实际使用中踩过的坑,尽量让你看完就能直接上手。
1. Cursor Skills 到底是干什么的
1.1 Skills 和 Rules 的本质区别
很多人容易把 Cursor 的 Skills 和 Rules 搞混,其实它们的加载机制完全不同。Rules 是“常驻上下文”,你写在项目规则文件里的每一条要求,AI 在每一轮对话里都会看到,相当于给 AI 立了一个一直在执行的“员工手册”。而 Skills 是“按需加载”,每个技能是一个独立文件夹,里面放一个 SKILL.md 文件,文件开头用 frontmatter 写清楚技能的名称和描述。AI 会先根据你当前提问的语义,去匹配所有技能的 description,匹配上了才把完整的 SKILL.md 注入上下文。
打个比方。Rules 就像公司墙上贴的规章制度,任何时候都得遵守;Skills 更像仓库里的一摞专项作业指导书,比如“客户投诉处理流程”,只有真的来了投诉工单,员工才会去翻那本手册。这个设计有个直接好处:省上下文。如果你的项目规则里塞了几十条规范,那每次对话都会白白消耗大量 token,AI 的注意力也会被稀释。用 Skills 之后,平时只保留少量核心规则,遇到专业任务才临时加载对应的操作手册,既精准又不浪费。
1.2 它解决的三类真实痛点
我在实际项目里总结下来,Cursor Skills 主要解决三件事。
第一,不用反复“教育” AI。以前写前端项目,每次让 AI 生成组件,我都要在对话里补一句“我们用的是 React + TypeScript,组件用 function 声明,样式用 CSS Modules,变量名统一小驼峰”。这听起来不麻烦,但一旦项目换人、换分支、隔了几周再看,这些约定早就丢了。把技术栈和规范写进一个前端开发技能后,AI 会自动按约定输出,人只需要审查结果。
第二,专业任务输出更稳定。比如让 AI 分析一份日志、写一段测试用例、给一段代码审查意见,如果没有技能约束,它每次的格式和深度都有随机性。技能里可以定义步骤、检查清单、输出模板,把“AI 的自由发挥”压缩到可控范围内。社区里流传比较广的“月老打分”技能就是这个思路:让 AI 给回复质量逐项打分,最后输出一张打分表,评价标准全部写在技能文件里。
第三,团队交付标准统一。你在项目根目录放一个 .cursor/skills,新同事 clone 仓库后重新打开 Cursor,他就会自动拥有团队定义的代码规范、提交信息格式、测试要求。这对多人协作项目来说,价值比个人使用高得多。
1.3 它的触发链路
理解触发链路是学会写技能的关键。一次完整调用分三步:用户在对话框输入需求;Cursor 把当前对话内容与每个技能 SKILL.md 里的 description 做语义匹配;一旦判定相关,就把整份技能内容注入上下文,AI 再结合用户输入输出结果。
这意味着 description 是决定技能会不会被调用的“入口开关”。你 description 写得太宽,AI 会在无关任务里乱加载;写得太死,又容易错过真正需要它的场景。一个合格的 description 应该像搜索引擎的关键词列表:覆盖对应任务的常见说法、任务类型、产物名称,但不要用太多形容词。后面讲手写技能时我会再详细展开。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境准备:先搞清楚技能放在哪
2.1 版本要求与入口位置
Cursor Skills 是内置功能,不需要额外安装任何插件,前提是你用较新的 Cursor 版本。如果你打开设置或者官方文档时完全找不到相关介绍,优先检查版本,把客户端升级到最新版再说。
它和 Rules 在官方文档里属于同一个大的上下文部分,入口通常在 Cursor 设置 > 关于 页面能找到版本号,docs 目录则对
