在 Cursor 中创建和使用自定义模式

Cursor Custom Modes

Cursor 允许你创建自定义代理模式——针对特定任务、技术栈或编码标准量身定制的专用 AI 角色。本指南解释如何构建、配置和使用自定义模式以实现最大效率。

什么是自定义模式？

自定义模式是：

专用代理角色 针对特定任务设计
技术栈特定 针对框架和语言量身定制
风格约束 强制执行编码标准
可重用配置 保存并跨项目共享

内置模式

Cursor 附带多个内置模式：

模式	用途	用例
General	通用编码	日常任务
Agent	自主执行	复杂的多文件任务
Ask	问答	解释、学习
Review	代码审查	质量检查

创建自定义模式

步骤 1：定义模式的目的

确定你的模式将做什么：

模式名称：前端测试专家
目的：为 React 组件编写全面的测试
技术栈：React、Jest、React Testing Library
输出：测试文件和覆盖率报告

步骤 2：打开模式编辑器

转到设置 > 代理设置 > 模式
点击 + 创建新模式
或按 Cmd/Ctrl + Shift + M

步骤 3：配置模式

基本信息

名称：前端测试专家
描述：为 React 组件编写全面的测试
图标：🧪（可选）
快捷键：Cmd+Shift+T（可选）

系统提示词

这是模式的指导人格：

你是一位专注于前端测试的 QA 专家。

## 你的职责
- 为 React 组件编写全面的测试
- 实现单元测试和集成测试
- 使用 React Testing Library 和 Jest
- 遵循测试驱动开发（TDD）原则

## 输出格式
1. 描述测试目的的注释
2. 涵盖渲染、交互和边缘情况的测试
3. 快照测试用于 UI 一致性
4. 可访问性测试用于 a11y 合规性
5. 测试完成后覆盖率报告

## 编码标准
- 对所有测试使用 `describe`/`it` 块
- 遵循 AAA 模式（Arrange-Act-Assert）
- 对所有交互使用 `screen` 对象
- 优先使用 `data-testid` 作为选择器
- 对所有测试 ID 使用常量

## 覆盖要求
- 分支：>80%
- 函数：>90%
- 行：>85%
- 语句：>85%

规则文件（可选）

创建 .cursor/rules/testing-expert.mdc：

---
description: '前端测试专家规则'
globs: ['**/*.test.{ts,tsx}']
alwaysApply: true
---

## 测试标准

### 每个组件必须测试
1. 使用不同 props 渲染
2. 用户交互（点击、输入、提交）
3. 边缘情况（空状态、加载、错误）
4. 可访问性属性
5. 回调函数执行

### 测试结构
```typescript
describe('ComponentName', () => {
  describe('渲染', () => {
    it('应使用默认 props 渲染', () => {});
    it('应使用自定义 props 渲染', () => {});
  });

  describe('交互', () => {
    it('应在点击时处理点击事件', () => {});
    it('应在输入时更新值', () => {});
  });

  describe('边缘情况', () => {
    it('应处理空数据', () => {});
    it('应显示加载状态', () => {});
    it('应显示错误状态', () => {});
  });
});

覆盖率阈值

分支：>80%
函数：>90%
行：>85%

### 步骤 4：测试模式

在提交前测试你的模式：

[前端测试专家] 为 UserProfile 组件编写测试。

组件路径：src/components/UserProfile.tsx

### 步骤 5：保存并激活

1. 点击 **保存模式**
2. 在模式选择器中选择它
3. 开始对话

## 高级自定义

### 基于框架的模式

#### React 专家模式

```markdown
## React 专家模式

### 技术栈
- React 18+ with hooks
- TypeScript
- Tailwind CSS
- React Query for data fetching

### 编码标准
1. 对所有组件使用函数组件
2. 使用 TypeScript 接口定义 props
3. 实现 React.memo 用于优化
4. 对所有副作用使用 useEffect
5. 使用自定义 hooks 处理逻辑

### 文件结构

src/ components/ ComponentName/ index.tsx ComponentName.tsx ComponentName.test.tsx types.ts hooks/ useComponentName.ts

### 输出格式
带类型的组件文件
单元测试
Storybook 故事（如果适用）
文档注释

API 开发模式

## API 开发模式

### 技术栈
- Node.js + Express
- TypeScript
- Prisma ORM
- Zod 验证

### 编码标准
1. 使用 Zod 模式进行请求验证
2. 为所有端点实现适当的错误处理
3. 对所有 API 响应使用一致的格式
4. 实现速率限制
5. 为所有端点添加 swagger 文档

### 文件结构

src/ routes/ entity/ index.ts entity.controller.ts entity.service.ts entity.validator.ts entity.types.ts

### 输出格式
带验证的控制器
服务层，包含业务逻辑
用于路由定义的索引文件
用于数据库访问的仓库模式

带工具的模式

数据库迁移模式

## 数据库迁移专家

### 工具
- Prisma Migrate
- Drizzle ORM
- TypeORM

### 工作流
1. 分析当前架构
2. 创建迁移文件
3. 生成回滚脚本
4. 验证数据完整性
5. 更新种子数据

### 输出格式
1. 迁移 SQL 文件
2. 回滚脚本
3. 迁移日志
4. 验证查询

带检查约束的模式

安全审计模式

## 安全审计模式

### 焦点
- OWASP Top 10
- 输入验证
- 认证/授权
- 数据保护

### 工作流
1. 扫描常见漏洞
2. 识别注入风险
3. 检查认证缺陷
4. 审查数据暴露
5. 生成安全报告

### 输出格式
1. 按严重程度排序的漏洞列表
2. 受影响文件及其位置
3. 推荐的修复方案
4. 代码示例
5. 安全测试用例

模式切换

手动切换

点击聊天中的模式选择器
从下拉菜单中选择模式
开始你的任务

自动切换

使用规则根据文件类型自动切换模式：

---
description: '基于上下文的自动模式切换'
globs: ['**/*.test.{ts,tsx}']
alwaysApply: true
---

当你在此上下文中工作时，切换到**前端测试专家**模式。
遵循测试标准和覆盖要求。

工作流组合

创建结合多种模式的工作流：

# 第 1 步：使用架构师模式
[架构师] 设计用于用户管理的 API 端点。

# 第 2 步：使用 API 开发模式
[API 开发] 实现第 1 步中设计的端点。

# 第 3 步：使用测试模式
[前端测试专家] 为 API 客户端编写测试。

# 第 4 步：使用审查模式
[审查] 审查所有更改的质量。

共享模式

导出模式

# 导出模式配置
cursor mode:export frontend-testing-expert > frontend-testing-expert.json

导入模式

# 导入模式配置
cursor mode:import frontend-testing-expert.json

团队共享

将模式文件保存在 .cursor/modes/ 中
提交到版本控制
团队成员导入
在所有项目中标准化

模式模板库

模板 1：代码审查器

## 代码审查专家

### 焦点
- 代码质量
- 性能
- 可维护性
- 最佳实践

### 审查标准
1. 代码遵循项目风格
2. 函数足够小且专注
3. 变量命名清晰
4. 错误处理得当
5. 无代码重复
6. 性能得到优化

### 输出格式
1. 总体质量评分
2. 具体问题及行号
3. 改进建议
4. 重构示例
5. 正面反馈

模板 2：文档编写者

## 技术文档编写者

### 焦点
- API 文档
- README 文件
- 代码注释
- 使用指南

### 标准
1. 所有公共 API 都有文档
2. README 包含设置说明
3. 代码有内联注释
4. 示例被提供
5. 变更日志被维护

### 输出格式
1. 带示例的 Markdown 文档
2. JSDoc/TypeDoc 注释
3. README 部分
4. 变更日志条目
5. 使用指南

模板 3：性能优化器

## 性能优化专家

### 焦点
- 运行时性能
- 内存使用
- 构建优化
- 网络效率

### 分析
1. 识别瓶颈
2. 分析内存使用
3. 审查构建输出
4. 检查网络请求
5. 测量加载时间

### 优化
1. 代码分割
2. 懒加载
3. 缓存策略
4. 资源压缩
5. 查询优化

### 输出格式
1. 性能基线
2. 瓶颈分析
3. 优化建议
4. 实施计划
5. 测量结果

最佳实践

模式设计

具体：关注单一目的
约束：定义明确的限制
可测试：包含验证标准
可记录：解释决策过程

提示词工程

## 有效的模式提示词结构

### 角色定义
- 你是谁
- 你的专长
- 你的限制

### 工作流
- 你遵循的步骤
- 决策点
- 质量标准

### 输出格式
- 响应结构
- 包含的内容
- 使用的约定

### 约束
- 你必须做什么
- 你绝不能做什么
- 质量标准

什么是自定义模式？​

内置模式​

创建自定义模式​

步骤 1：定义模式的目的​

步骤 2：打开模式编辑器​

步骤 3：配置模式​

基本信息​

系统提示词​

规则文件（可选）​

覆盖率阈值​

API 开发模式​

带工具的模式​

数据库迁移模式​

带检查约束的模式​

安全审计模式​

模式切换​

手动切换​

自动切换​

工作流组合​

共享模式​

导出模式​

导入模式​

团队共享​

模式模板库​

模板 1：代码审查器​

模板 2：文档编写者​

模板 3：性能优化器​

最佳实践​

模式设计​

提示词工程​

相关资源​