AI编程助手自定义技巧【2026】：Cursor Rules、Windsurf Skills与Claude Projects详解

项目级配置：.cursor/rules 或 .cursorrules
全局配置：Cursor Settings > General > Rules for AI

# 项目规范

## 代码风格
- 使用 TypeScript 严格模式
- 优先使用函数式编程范式
- 组件使用 PascalCase 命名
- 工具函数使用 camelCase 命名

## 技术栈
- 前端框架：React 18 + Next.js 14
- 状态管理：Zustand
- 样式方案：Tailwind CSS
- 测试框架：Vitest + Testing Library

## 注释规范
- 不要添加多余的注释
- 复杂逻辑需要简短说明
- 使用 JSDoc 为公共 API 添加文档

components/
  ComponentName/
    index.tsx              # 主组件
    ComponentName.test.tsx # 测试文件
    types.ts               # 类型定义

name: React Component Generator
description: 生成符合项目规范的React组件
triggers:
  - "创建组件"
  - "新建组件"
  - "generate component"

instructions: |
  当用户请求创建React组件时：
  
  1. 使用函数式组件和TypeScript
  2. 遵循以下模板结构：
  
  ```tsx
  import { FC } from 'react';
  
  interface ${ComponentName}Props {
    // props定义
  }
  
  export const ${ComponentName}: FC<${ComponentName}Props> = (props) => {
    return (
      <div>
        {/* 组件内容 */}
      </div>
    );
  };

### 常用Skills模板

**代码审查Skill**：

```yaml
name: Code Review Assistant
description: 提供专业的代码审查建议

instructions: |
  审查代码时关注以下方面：
  
  ## 代码质量
  - 命名是否清晰表达意图
  - 函数是否遵循单一职责
  - 是否存在重复代码
  
  ## 性能考虑
  - 是否有不必要的重渲染
  - 数据结构选择是否合理
  - 是否存在内存泄漏风险
  
  ## 安全检查
  - 输入验证是否完整
  - 是否存在XSS/注入风险
  - 敏感数据处理是否安全
  
  输出格式：
  1. 问题描述
  2. 风险等级（高/中/低）
  3. 修复建议
  4. 修复后的代码示例

name: API Endpoint Generator
description: 生成RESTful API端点

instructions: |
  创建API端点时遵循以下规范：
  
  - 使用RESTful命名约定
  - 包含完整的错误处理
  - 添加请求参数验证
  - 生成OpenAPI文档注释
  - 包含单元测试示例

# 项目背景
这是一个企业级SaaS应用的后端服务，使用以下技术栈：
- 语言：Python 3.11
- 框架：FastAPI
- 数据库：PostgreSQL + Redis
- 部署：Kubernetes

# 代码规范
- 遵循PEP 8风格指南
- 使用类型注解
- 编写docstring文档
- 单元测试覆盖率 > 80%

# 响应偏好
- 优先考虑代码可维护性
- 解释设计决策的原因
- 提供多种实现方案对比
- 标注潜在的性能影响

# 角色定义
你是一位资深的Python后端工程师，专注于：
- 高性能API设计
- 数据库优化
- 系统架构设计

# 任务处理流程
1. 理解需求，确认关键点
2. 分析现有代码结构
3. 提出解决方案
4. 编写实现代码
5. 补充测试用例

# 输出要求
- 代码需要可直接运行
- 包含必要的import语句
- 添加错误处理逻辑
- 考虑边界情况

# AI编程助手配置模板

## 项目信息
- 项目名称：[项目名]
- 技术栈：[框架/语言/工具]
- 项目类型：[Web应用/API服务/CLI工具]

## 代码规范
- 命名约定：[camelCase/snake_case/PascalCase]
- 缩进方式：[空格数/Tab]
- 最大行长：[80/100/120]
- 引号风格：[单引号/双引号]

## AI行为偏好
- 解释详细程度：[简洁/适中/详细]
- 代码注释：[无/关键处/详细]
- 错误处理：[基础/完整/防御式]
- 测试生成：[不需要/单元测试/完整测试]

## 禁止事项
- 不要使用已废弃的API
- 不要硬编码敏感信息
- 不要忽略错误处理
- 不要生成过长的函数

# 团队共享规则

## Git提交规范
提交信息格式：<type>(<scope>): <description>
- feat: 新功能
- fix: 修复bug
- docs: 文档更新
- refactor: 重构

## PR描述模板
生成PR时包含：
1. 变更概述
2. 测试说明
3. 截图（如适用）
4. 关联Issue

## 代码审查清单
- [ ] 代码符合项目规范
- [ ] 包含必要的测试
- [ ] 无安全隐患
- [ ] 性能影响可接受