实战：用 Cursor 快速搭建 AI 助手工作流

一、为什么需要搭建 AI 工作流？

很多开发者用 Cursor 只停留在"写代码时问两句"的层面，但这远未发挥 AI 助手的真正价值。

常见问题：

• 每次都要重复解释项目结构
• AI 给出的代码风格和自己不一致
• 同样的任务每次都要重新描述
• 不知道如何配置让 AI 更懂自己

解决方案： 搭建一套完整的 AI 工作流，让 Cursor 成为真正懂你的编程伙伴。

二、基础配置：让 AI 理解你的项目

2.1 创建 .cursorrules 文件

在项目根目录创建 .cursorrules，告诉 AI 你的项目规范：

# Project Context

## Tech Stack
- Frontend: React 18 + TypeScript + TailwindCSS
- Backend: Node.js + Express + PostgreSQL
- Testing: Jest + React Testing Library

## Code Style
- Use functional components with hooks
- Prefer const arrow functions
- Use TypeScript strict mode
- Follow ESLint config strictly

## Response Guidelines
- Keep explanations concise
- Provide code examples for complex concepts
- Point out potential edge cases
- Suggest performance optimizations when relevant

2.2 配置全局规则

在 ~/.cursor/rules.md 创建全局规则，适用于所有项目：

# Global Coding Preferences

## General
- Always use meaningful variable names
- Add comments for complex logic only
- Prefer readability over cleverness

## Security
- Never commit API keys or secrets
- Validate all user inputs
- Use parameterized queries for SQL

## Performance
- Lazy load heavy components
- Implement proper error boundaries
- Use React.memo for expensive renders

三、快捷命令：提升交互效率

3.1 常用快捷指令

快捷键	功能	使用场景
Cmd+K	生成代码	快速实现函数/组件
Cmd+L	对话模式	询问问题、讨论方案
Cmd+I	行内编辑	修改选中代码
@file	引用文件	让 AI 参考特定文件
@folder	引用目录	让 AI 理解整个模块

3.2 自定义快捷指令

在 .cursor/instructions/ 目录下创建常用指令：

# File: .cursor/instructions/refactor.md

## Refactoring Guidelines

When asked to refactor code:
1. Identify code smells (duplication, long functions, etc.)
2. Suggest specific improvements
3. Maintain backward compatibility
4. Add/update tests as needed
5. Document any API changes

四、实战：开发一个 AI 技能

4.1 场景描述

假设你需要经常生成 API 文档，手动写很耗时。我们来创建一个"API 文档生成器"技能。

4.2 实现步骤

步骤 1：创建技能文件

// .cursor/skills/api-doc-generator.js

/**
 * API Documentation Generator
 * Analyzes route handlers and generates OpenAPI-compatible documentation
 */

export function generateApiDoc(code, context) {
  // Extract route definitions
  const routes = extractRoutes(code);
  
  // Generate documentation structure
  const doc = {
    endpoints: routes.map(route => ({
      method: route.method,
      path: route.path,
      description: route.description,
      params: route.params,
      response: route.response
    }))
  };
  
  return formatAsMarkdown(doc);
}

步骤 2：在 .cursorrules 中注册技能

## Available Skills

### API Documentation Generator
- Trigger: "生成 API 文档" or "generate API docs"
- Input: Route handler code or Express app file
- Output: Markdown documentation with endpoints, params, responses
- Usage: @api-doc <file-path>

步骤 3：测试技能

在 Cursor 中输入：

@api-doc src/routes/user.js 生成 API 文档

AI 会调用你的技能，输出结构化的 API 文档。

五、高级技巧：让 AI 更懂你

5.1 建立项目知识库

创建 docs/ai-context.md，包含：

# AI Context for This Project

## Business Logic
- User authentication flow: JWT with refresh tokens
- Payment integration: 百望云 payment gateway
- Rate limiting: 5 requests/minute per user

## Common Patterns
- Repository pattern for data access
- Service layer for business logic
- Controller layer for HTTP handling

## Gotchas
- Never cache user-specific data without TTL
- Always validate invoice data before processing
- Payment callbacks must be idempotent

5.2 创建代码示例库

在 .cursor/examples/ 存放典型代码片段：

// .cursor/examples/auth-middleware.ts
// Standard authentication middleware pattern

export const authMiddleware = async (req, res, next) => {
  const token = req.headers.authorization?.replace('Bearer ', '');
  
  if (!token) {
    return res.status(401).json({ code: 4003, message: '未授权' });
  }
  
  try {
    const user = await verifyToken(token);
    req.user = user;
    next();
  } catch (error) {
    return res.status(401).json({ code: 4003, message: 'Token 无效' });
  }
};

这样 AI 在生成认证代码时会参考你的标准实现。

六、工作流优化建议

6.1 日常使用流程

1. 开始任务 → 先用 Cmd+L 描述需求，让 AI 理解上下文
2. 生成代码 → 用 Cmd+K 快速实现，引用相关文件 (@file)
3. 代码审查 → 让 AI 检查潜在问题和优化空间
4. 生成测试 → 自动生成单元测试和边界用例
5. 文档更新 → 同步更新 README 和 API 文档

6.2 定期维护

• 每周更新 .cursorrules，记录新的发现
• 每月清理过时的示例代码
• 每季度回顾工作流，优化低效环节

七、总结

搭建 AI 工作流的核心价值：

1. 减少重复解释 - AI 记住你的项目规范和编码习惯
2. 提升代码一致性 - 所有生成的代码都符合团队标准
3. 加速开发流程 - 常用操作变成一键执行
4. 知识沉淀 - 最佳实践被固化到配置中

关键要点：

• 从简单的 .cursorrules 开始，逐步完善
• 根据实际使用反馈持续优化配置
• 把重复性任务转化为 AI 技能
• 定期回顾和更新工作流

现在就开始搭建你的 AI 工作流吧！从创建一个 .cursorrules 文件开始，让 Cursor 真正理解你的项目。