Cursor Skill 概念、编写与接入指南第一步Skill 是什么一句话定义Skill技能是一份 Markdown 文件教会 Cursor AI 如何执行特定任务——代码审查、生成提交信息、查询数据库等任何专业化工作流。类比理解把 Skill 想象成岗位操作手册没有手册时新员工只能靠通用常识做事有了手册后新员工也能按标准流程高质量完成工作Skill 就是给 AI 的操作手册——让它掌握你团队特有的知识、流程和标准。与 Rules 和 MCP 的区别┌─────────────────────────────────────────────────────────────┐ │ Cursor AI Agent │ ├──────────┬──────────────────┬───────────────────────────────┤ │ Rules │ Skills │ MCP │ │ 守则 │ 操作手册 │ 工具箱 │ │ │ │ │ │ 始终生效的 │ 按需加载的 │ 连接外部系统的 │ │ 简短约束 │ 详细操作指南 │ 标准协议 │ └──────────┴──────────────────┴───────────────────────────────┘Rules简短的约束条件始终或按文件类型生效 50 行Skills详细的操作指南AI 判断场景后按需加载 500 行MCP连接外部系统的协议赋予 AI 调用外部工具的能力第二步Skill 编写流程2.1 确定目录结构skill-name/ ├── SKILL.md # 必须 - 主文件AI 会读取 ├── reference.md # 可选 - 详细参考文档 ├── examples.md # 可选 - 使用示例 └── scripts/ # 可选 - 工具脚本 └── validate.py2.2 编写 SKILL.md文件由两部分组成YAML 头部Markdown 正文。--- name: code-review description: - 审查代码的质量、安全性和可维护性。 当用户提交 Pull Request、要求代码审查或提到review时使用。 --- # 代码审查 ## 快速开始 审查代码时按以下顺序检查 1. 逻辑正确性和潜在 Bug 2. 安全最佳实践 3. 代码可读性 4. 测试是否充分 ## 审查清单 - [ ] 逻辑正确边界情况已处理 - [ ] 无安全漏洞SQL 注入、XSS 等 - [ ] 代码符合项目规范 - [ ] 错误处理完善 - [ ] 测试覆盖了变更内容 ## 反馈格式 - **严重**合并前必须修复 - **建议**建议改进 - **锦上添花**可选优化 ## 补充资料 - 详细编码标准见 [STANDARDS.md](STANDARDS.md)2.3 头部字段说明字段要求作用name最长 64 字符仅小写字母/数字/连字符Skill 的唯一标识description最长 1024 字符不能为空AI 根据描述判断何时加载该 Skill2.4 编写关键原则description 决定一切——AI 靠描述来决定是否加载你的 Skill用第三人称写Generates commit messages by analyzing diffs同时说明 WHAT做什么和 WHEN什么时候用包含触发关键词如pull request,code review,PDF正文要精简——上下文窗口是共享的每个 token 都有成本SKILL.md 控制在 500 行以内只写 AI 不知道的专有知识不要教它基础常识详细内容放到reference.md等附属文件中渐进式展开第三步接入方式3.1 存放位置两种作用域放到对应目录即可生效类型路径范围个人 Skill~/.cursor/skills/skill-name/SKILL.md你的所有项目都可用项目 Skill.cursor/skills/skill-name/SKILL.md仅当前项目随仓库共享给团队注意不要放到~/.cursor/skills-cursor/该目录是 Cursor 内置 Skill 专用。3.2 示例在项目中添加一个 Skillyour-project/ └── .cursor/ └── skills/ └── code-review/ ├── SKILL.md └── STANDARDS.md不需要任何配置文件放到目录里即可自动识别。3.3 接入后的效果Cursor 启动时自动扫描 Skill 目录当用户对话匹配 Skill 描述中的关键词时AI 自动加载对应 SkillAI 按照 SKILL.md 中的指引执行任务总结维度核心要点概念Skill AI 的岗位操作手册教会它执行特定专业任务编写创建SKILL.md写好 name description 头部正文控制在 500 行内接入放到~/.cursor/skills/或.cursor/skills/目录下即可自动生效