跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
JavaScriptAI大前端

在 Cursor 中打造专属前端 AI 助手:Agent Skills 实战指南

介绍 Cursor 编辑器中的 Agent Skills 功能,对比其与 .cursorrules 的差异,详述了从官方文档下载、本地配置到自定义开发的全流程。通过实战案例演示了如何创建生成标准 React 组件的技能,涵盖 SKILL.md 编写规范、目录结构及脚本自动化扩展,旨在帮助团队统一代码规范并提升 AI 辅助开发效率。

并发大师发布于 2026/4/6更新于 2026/10/2199 浏览
在 Cursor 中打造专属前端 AI 助手:Agent Skills 实战指南

一、什么是 Agent Skills?

简单来说,Agent Skills 是一种标准化的方式,用来封装特定任务的知识和工作流。 如果说 MCP (Model Context Protocol) 是给 AI 装上了'手'(让它能连接数据库、Github),那么 Skills 就是给 AI 的'操作说明书'(告诉它怎么用这双手去搬砖)。 它和 .cursorrules 的区别在于:.cursorrules (全局规则): 就像公司的'员工手册',是 AI 必须时刻记住的(Always on),适合放通用的代码风格(比如'永远使用 TypeScript')。Agent Skills (技能): 就像'特定的任务 SOP',AI 只有在需要的时候(Context Relevant)才会去加载它,或者通过 / 命令手动触发。这大大节省了 Token,也让 AI 更专注。

二、使用步骤

1. 下载官方提供的 agent-skills 文档

链接:https://github.com/anthropics/skills

2. Cursor 中使用

在 cursor 中新建.cursor 目录加 skills 目录,把从 Github 上下载的 skills 拷贝到该目录下。

这是参考 frontend-design 这个 skills 来设计的网站,会发现精美许多。

三、如何设计自己的 skills

通过别人提供好的 skils 文档来生成。

在 cursor 中输入提示词,cursor 会自动扫描你文件下的 skill.md 文档进行生成。

四、实战:打造一个'生成标准 React 组件'的 Skill

假设我们团队有一个严格的组件开发规范:

  1. 组件必须是 Function Component。
  2. 必须使用 CSS Modules。
  3. 必须包含一个 interface 定义 Props。
  4. 文件结构必须是文件夹形式。

我们来写一个 Skill 教会 Cursor 怎么做。

第一步:创建目录

在你的项目根目录下(或者全局 ~/.cursor/skills),创建一个存放技能的文件夹:

.cursor/
  skills/
    react-component-gen/ <-- 技能名称文件夹
    SKILL.md <-- 核心定义文件
第二步:编写 SKILL.md

这是核心部分。SKILL.md 包含两部分:Frontmatter (元数据) 和 Markdown 正文 (指令)。

在 .cursor/skills/react-component-gen/SKILL.md 中写入:

---
name: react-component-gen
description: Generate a new  functional component    and  interfaces following team standards.
disable-model-: 
---

#   

  skill when the user asks to create a   component, page, or widget.

## 

 ** the **:  the component name and props required.
 ** **:
   -  a folder named exactly  the  ().
   - , create  and .
 ** **:
   - **index.**:
     -     .
     -  styles  .
     -  an  `[]`.
     -  the component as default.
   - **styles.module.scss**:
     -  a root class `.container`.
     -  BEM naming convention for inner elements if needed.

##  

 the user asks for a "", generate:

```tsx
// /index.tsx
import , {  }  ;
 styles  ;

   {
  : ;
  :  ;
}

 : <> =  {
   (
    
  );
};

  ;
React
with
CSS
Modules
TypeScript
invocation
false
React
Component
Generator
Use
this
new
UI
Instructions
1.
Analyze
Request
Identify
2.
Directory
Structure
Create
as
component
PascalCase
Inside
`index.tsx`
`styles.module.scss`
3.
Code
Standards
tsx
Use
`FC`
type
from
'react'
Import
as
`import styles from './styles.module.scss'`
Define
interface
ComponentName
Props
Export
Create
Use
Template
Example
If
Button
Button
React
FC
from
'react'
import
from
'./styles.module.scss'
export
interface
ButtonProps
label
string
onClick
() =>
void
const
Button
FC
ButtonProps
({ label, onClick }) =>
return
<button className={styles.container} onClick={onClick}> {label} </button>
export
default
Button

第三步:启用并使用

  1. 启用:确保你的 Cursor 是较新版本(部分功能可能在 Beta/Nightly 通道)。打开设置 -> Rules 或 Features,确保 Agent Skills 相关的开关已打开。
  2. 自动触发:
    • 打开 Cursor 的 Agent 聊天框(CMD+L 或 CMD+K)。
    • 输入:'帮我写一个 UserCard 组件,包含头像和名字。'
    • 你会发现 Agent 会自动识别意图,加载 react-component-gen 技能,并严格按照你的模板生成代码!
  3. 手动触发:
    • 输入 /,你应该能看到 react-component-gen 出现在命令列表中。

进阶玩法:带脚本的 Skill (自动化重构)

前端经常需要做一些批量重构,比如'找出所有硬编码的颜色并替换为 Tailwind 类名'。我们可以给 Skill 配上脚本。

.cursor/skills/refactor-color/
  SKILL.md
  scripts/
    find-hex.js <-- 一个扫描文件的脚本

SKILL.md:

---
name: refactor-color
description: Refactor hardcoded hex colors to Tailwind utility classes.
---

# Color Refactoring

## Instructions

1. Run the script `scripts/find-hex.js` to locate hex codes in the current file.
2. For each hex code found, map it to the closest Tailwind color (e.g., `#ef4444` -> `text-red-500`).
3. Rewrite the code.

这样,AI 就不只是在'瞎猜',而是真正执行了你写的工具脚本来辅助它工作。

总结:为什么你应该开始用 Skills?

  1. 团队规范统一:把这个 .cursor 文件夹提交到 Git 仓库,新入职的同事 git pull 下来,他的 AI 助手立刻学会了全套团队规范,不用手把手教。
  2. 减少上下文污染:只在写组件时加载组件规范,写测试时加载测试规范,让 AI 的脑子更清醒。
  3. 沉淀最佳实践:把那些你每次都要重复敲的 Prompt,固化成代码资产。

不要把试图把所有东西都塞进 .cursorrules。把 .cursorrules 当作宪法(不可动摇的原则),把 Agent Skills 当作SOP 手册(针对具体任务的流程)。

目录

  1. 一、什么是 Agent Skills?
  2. 二、使用步骤
  3. 1. 下载官方提供的 agent-skills 文档
  4. 2. Cursor 中使用
  5. 三、如何设计自己的 skills
  6. 四、实战:打造一个“生成标准 React 组件”的 Skill
  7. 第一步:创建目录
  8. 第二步:编写 SKILL.md
  9. React Component Generator
  10. Instructions
  11. Template Example
  12. 第三步:启用并使用
  13. 进阶玩法:带脚本的 Skill (自动化重构)
  14. Color Refactoring
  15. Instructions
  16. 总结:为什么你应该开始用 Skills?

更多推荐文章

查看全部
  • Dify 接入企业微信群聊机器人配置与实现指南
  • 10 款免费开源 CMS 建站系统推荐
  • 利用 Fiddler 代理抓包 JVM 发出的 HTTP 请求
  • Java IO 流体系核心梳理:字节流与字符流详解
  • CSS 渐变实战:线性、径向与锥形的常用写法
  • Meta 发布 Llama 3:架构、训练与性能深度解析
  • 爬虫技术等级与收入真相:新手月入六千是否可行
  • 绿联云 NAS 配置 WebDAV 实现公网同步
  • Linux 中 GDB 与 CGDB 调试器的使用详解
  • 5 大 AI 代码生成工具实测:DeepSeek-Coder 在测试场景的实战表现
  • C++ 类和对象:拷贝构造函数与赋值运算符重载详解
  • Electron 实战:按需构建与打包体积优化
  • 激光雷达点云配准:ICP 与 NDT 算法深度解析
  • 基于 Retinaface 与 CurricularFace 的人脸身份核验方案
  • 基于 PSO-DWA 融合的无人机三维动态避障路径规划及 Matlab 实现
  • C++ 函数重载:核心规则、匹配机制与实战
  • Milvus 实战:Attu 可视化安装与 Python 整合指南
  • Java 集合框架核心:List、Set 与 Map 的差异解析
  • Python 实战:构建文档总结、代码生成与智能检索助手
  • PentAGI 基于 Docker 的 AI 自动化渗透环境部署指南

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Keycode 信息

    查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online

  • Escape 与 Native 编解码

    JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online

  • JavaScript / HTML 格式化

    使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online