增城项目Cursor实战案例分享

cases/backend/20250703-cursor基于交付项目定制化开发案例.md

+# Cursor基于交付项目定制化需求快速开发案例分享
+# Cursor基于交付项目定制化需求快速开发案例分享
+
+> **场景**: 针对交付项目中，全新定制化需求（与其它业务交互较少或者不涉及其它业务），通过Cursor快速进行代码生成。
+> 
+> **作者**: yanrui  
+> **日期**: 2025-07-03
+
+---
+
+## 分享内容（结合实际演示）
+
+- #### Cursor-rules介绍以及使用方法
+
+- #### 使用Cursor结合需求原型快速构建表结构以及数据初始化脚本
+
+- #### 通过指定rule快速生成代码
+
+------
+
+
+
+## 1、Cursor-rules介绍
+
+#### 在 Cursor 当中，支持两种级别的规则：
+
+- **全局规则（User Rules）**：针对所有项目通用的规则
+- **项目规则（Project Rules）**：存放于项目目录下的 `.cursor/rules` 中，只用于约束当前项目。
+
+目前使用的是**项目规则（Project Rules）**,可以针对不同项目，更加灵活的添加规则约束。
+
+------
+
+#### 添加Cursor-rule
+
+- 首先打开Cursor，点击【设置齿轮】，进入Cursor Setting 设置页面，然后点击【 Rules】进入【Add new rule】界面
+- 点击 【Add New Rule】后，先输入规则的名称，比如命名为：`db-rules`，约束AI在编写数据库项目的规范
+- 规则文件是md格式，可以使用其它AI工具进行编写（deepseek、智普清言、豆包等），自己再加以修改。
+- 同时，在编写规则文件时，可以使用@来添加引入文件，文件中的内容会作为额外上下文添加到规则文件中。
+
+------
+
+#### **Cursor 支持四种规则类型：**
+
+- Always：始终应用规则（想始终生效）
+- Auto Attached：当匹配 globs 模式的文件被引用时自动附加规则（想自动触发用）
+- Agent Requested：根据 AI 代理的判断决定是否应用规则，需要提供规则说明（想让 AI 自己决定是否用）
+- Manual：仅在提示中显式使用 @规则名 时附加规则。（想手动调用规则）
+
+
+
+## 2、使用Cursor结合需求原型快速构建表结构以及数据初始化脚本
+
+- #### 编写数据库涉及规范
+
+- #### 在Cursor对话框中通过@规则文件名称.mdc，使用规则，将原型图拖入对话框。简单描述需求，让Cursor完成库表设计
+
+- #### 使用AI设计的表结构，还需结合实际业务，对库表、字段进行修改。
+
+
+
+## 3、通过指定rule快速生成代码
+
+- #### 制定项目需求规则。
+
+- #### 对话框中指定代码生成路径，基于表结构生成对应的实体类。
+
+- #### 对话框中指定代码生成路径，生成各个表的Dao接口以及对应的mapper.xml。
+
+- #### 根据制定的需求规则，生成对应的service接口以及其实现类，并实现对应的业务方法。
+
+- #### 基于生成的service接口，生成对应的Controller。
+
+- #### 涉及服务间的调用，可以根据生成的Controller在其它服务上生成对应的feign接口
+
+  
+
+## 分享总结
+
+#### 使用Cursor生成代码前置工作（个人建议）：
+
+- ##### 需求梳理、功能设计、表结构设计
+
+- ##### 基于当前需求，整理Project-Rule
+
+- ##### 基于rule开始和Cursor进行问答，生成相关业务代码
+
+------
+
+#### 本次增城在线客服需求，全量使用Cursor进行代码生成，效率提升如下表：
+
+| **指标**       | **原计划** | **实际完成** | **提升幅度** |
+| :------------- | :--------- | :----------- | :----------- |
+| 总工作日       | 10天       | 2天          | **减少80%**  |
+| 日均任务完成率 | 10%        | 50%          | **提高5倍**  |
+| 资源消耗(人天) | 10人天     | 2人天        | **节省80%**  |
+| 提前完成时间   | -          | 8天          | **提前80%**  |
+| 项目交付速度   | 1x         | 5x           | **加速5倍**  |
+
+
+
+---
+
+## 💡 学习建议
+
+- [官方rule模板](https://cursor.directory/java-spring-cursor-rules)
+- [Cursor AI中文教程_w3cschool](https://www.w3cschool.cn/cursordocs/)
+- [Cursor论坛](https://forum.cursor.com/)
\ No newline at end of file