一、Cursor IDE 中的 Skills 功能(技术特性)
1. 什么是 Cursor Skills?
Skills 是 Cursor 编辑器中引入的一种动态上下文管理机制 ,用于扩展 AI Agent 的特定领域能力。它是一个按需加载 的知识包系统,遵循开放的 SKILL.md 标准。
核心特性:
- 动态发现:Agent 根据任务相关性自动决定是否加载
- 按需注入:仅在需要时才将上下文加入对话,节省 Token
- 跨平台兼容 :基于
agentskills.io开放标准,可在 Claude Code、Cursor、Windsurf 等工具间复用 - 可手动触发 :支持通过
/skill-name斜杠命令主动调用
2. Skills 的文件结构
markdown
.cursor/
└── skills/
└── <skill-name>/
├── SKILL.md # 核心定义文件(必需)
├── scripts/ # 辅助脚本(可选)
│ └── deploy.sh
└── references/ # 参考资料(可选)
└── env-setup.md
3. SKILL.md 文件格式
markdown
---
name: deploy-app
description: Deploy the application to staging or production.
Use when deploying code or discussing releases and environments.
---
# Deploy App Skill
## When to use
- User mentions "deploy", "release", or "ship"
- Changes are ready for staging or production
- User asks about environment configuration
## Workflow
1. Run validation: `python scripts/validate.py`
2. Deploy: `scripts/deploy.sh <environment>`
3. Verify deployment succeeded
4. Report back with the deployed URL
## Environments
- `staging`: Pre-production testing
- `production`: Live environment, requires extra confirmation
4. Skills vs Rules vs Commands 对比
| 特性 | Rules | Commands | Skills |
|---|---|---|---|
| 触发方式 | 自动应用(Always-on)或智能匹配 | 手动触发(/命令) |
Agent 自动发现 + 手动触发 |
| 上下文成本 | 始终占用(昂贵) | 使用时占用 | 按需加载(节省Token) |
| 适用场景 | 代码规范、安全约束、架构标准 | 可复用的工作流 | 特定领域的专业知识 |
| 内容长度 | 简短(<500行) | 中等 | 可较长(按需加载) |
| 核心作用 | 约束行为(必须遵守) | 执行任务(明确意图) | 扩展能力(专业知识) |
| 存储位置 | .cursor/rules/ |
.cursor/commands/ |
.cursor/skills/ |
决策法则:
- Rules: "无论我是否想到,都必须遵守" → 代码风格、安全规范
- Commands: "我现在明确要做这个" → 代码审查、生成文档
- Skills: "遇到特定领域问题时需要指导" → 部署流程、框架最佳实践
5. Skills 的实际应用示例
场景1:云成本优化检查
markdown
---
name: org-pre-deploy-review
description: Review project for infrastructure compliance and cost-efficiency.
Use when discussing repo resources, deployment readiness, or resource standards.
---
# Pre-deploy Review Skill
## 检查清单
- [ ] 日志级别是否设置为 WARN(避免过度日志费用)
- [ ] Lambda 内存配置是否过度供应
- [ ] 非生产环境是否启用了自动休眠
- [ ] 数据库连接池配置是否合理
场景2:React 组件开发
markdown
---
name: react-component-dev
description: Guidelines for building React components with TypeScript and Tailwind.
Use when creating or modifying React UI components.
---
# React Component Development
## 强制规范
- 使用函数组件 + TypeScript 接口
- Props 命名:`interface {ComponentName}Props`
- 样式:优先使用 Tailwind,复杂样式使用 CSS Modules
- 性能:默认使用 React.memo,列表使用 useMemo
二、Vibe Coding 所需的核心技能(能力要求)
Vibe Coding 虽然降低了编码门槛,但对开发者提出了新型能力模型的要求:
1. 思维框架技能(Thinking Frameworks)
在编写 Prompt 前,需在四个层面思考:
| 层面 | 关注点 | 示例 |
|---|---|---|
| 逻辑层 | 定义想要什么 | "一个抓取网站 SEO Meta 标签的 App" |
| 分析层 | 明确如何工作 | "获取 HTML → 解析 title/meta → 计算评分" |
| 计算层 | 功能映射到技术 | "React + Node.js + Tailwind" |
| 程序层 | 定义卓越标准 | "移动端适配、颜色编码警告、无障碍支持" |
2. 技术基础技能(Technical Foundation)
| 技能领域 | 重要性 | 具体说明 |
|---|---|---|
| 编程语言基础 | ⭐⭐⭐⭐⭐ | 能评估和优化 AI 生成的代码(HTML/CSS/JS/TS) |
| 框架理解 | ⭐⭐⭐⭐ | 知道何时指定 React/Vue/Next.js 等框架 |
| 系统架构 | ⭐⭐⭐⭐⭐ | 确保 AI 生成代码的架构合理性 |
| 调试能力 | ⭐⭐⭐⭐⭐ | 识别和修复 AI 代码中的问题 |
| 安全原则 | ⭐⭐⭐⭐⭐ | 防止 AI 引入漏洞(41-62% AI 代码有安全问题) |
3. Prompt 工程技能(Prompt Engineering)
核心能力:
- 精准描述:将模糊想法转化为 AI 可执行的指令
- 上下文管理:提供充足但不过量的背景信息
- 迭代优化:通过多轮对话 refine 结果
- 框架指定:明确技术栈和工具选择
示例对比:
❌ 低效 Prompt:
"做一个登录页面"
✅ 高效 Prompt:
"创建一个响应式登录页面,使用 React + TypeScript + Tailwind CSS。包含:邮箱/密码输入框(带验证)、'记住我'复选框、'忘记密码'链接、Google OAuth 按钮。要求:深色模式支持、WCAG 2.1 AA 无障碍标准、移动端优先设计。"
4. 创意与设计技能(Creative Skills)
| 技能 | 说明 |
|---|---|
| 视觉设计基础 | 色彩理论、排版、间距、构图 |
| 动效设计 | 缓动函数、时间控制、物理动画 |
| 用户体验 | 用户旅程设计、情感化设计 |
| 原型思维 | 快速低保真原型验证想法 |
5. 软技能(Soft Skills)
- 同理心:理解用户情感需求
- 审美判断:知道"什么感觉是对的"
- 协作能力:与跨职能团队沟通设计决策
- 迭代心态:接受持续改进而非追求完美
- 质量把控:在快速迭代中保持标准
6. 工程化技能(Engineering Practices)
即使是 Vibe Coding,生产级开发仍需:
| 实践 | 说明 |
|---|---|
| 版本控制 | Git 提交规范、分支管理 |
| 自动化测试 | 为关键路径编写测试(AI 生成后需验证) |
| 安全检查 | 定期审计 AI 代码的漏洞 |
| 代码审查 | 人工 review AI 生成的关键代码 |
| 文档维护 | 记录架构决策和 AI 协作模式 |
三、Skills 生态系统与工具链
1. Skills 市场与资源
- Agent Skills Marketplace (agentskillsrepo.com):13,000+ 开源 Skills
- Context Engineering Kit (GitHub):支持 Cursor、Claude Code、Windsurf 的插件市场
- Cursor Kit (GitHub):包含 7+ Commands、3+ Rules、6+ Skills 的模板库
2. 相关技术概念
| 技术 | 与 Skills 的关系 |
|---|---|
| MCP (Model Context Protocol) | Skills 的底层通信协议,标准化工具调用 |
| Subagents | Cursor 中的子代理,可并行处理任务,与 Skills 协同 |
| Hooks | 事件驱动的自动化机制,与 Skills 互补 |
| RAG (检索增强生成) | Skills 的上下文注入机制之一 |
四、最佳实践总结
对于初学者
- 从简单的 Rules 开始定义代码规范
- 学习编写有效的 Prompt(比学语法更重要)
- 逐步引入 Skills 管理复杂工作流
对于团队
- 建立组织级 Skills 库(部署规范、安全审查等)
- 定义清晰的 Rules 作为代码基线
- 使用 Commands 标准化常见任务(PR 审查、发布流程)
关键认知转变
传统开发 :开发者 = 代码实现者
Vibe Coding:开发者 = 创意总监 + 质量把控者 + AI 协作者
Skills 系统本质上是将这种新角色编码化------通过结构化的知识管理,让 AI 成为可编程的、领域专家级的协作伙伴。
参考资源: