Cursor技术文档:前端开发的“断舍离”高效协作指南

一、 引言:为什么我们需要对AI做减法?

在日常开发中,大家是否遇到过这些"Cursor降智"时刻:

  • 上下文冗余:明明只是想改一个按钮样式,Cursor却在分析整个路由的鉴权逻辑,导致输出迟缓且偏离重点。

  • 幻觉严重:对话轮次超过10轮后,AI开始捏造不存在的组件Props或混淆Vue 2.7与Vue 3的语法。

  • 过度依赖:试图让AI一次性完成"重构+格式化+排错",结果代码跑不通,还需要人工修修补补。

借鉴Claude Code的"断舍离"核心心法,我们发现:想要用好Cursor,核心不在于你投喂了多少,而在于你拒绝了多少。 本文档将结合团队现有的Vue 2.7/TypeScript技术栈,拆解如何在Cursor中落地这一理念。


二、 方法论拆解:前端场景下的"断、舍、离"

1. 断 (Break):拒绝无效上下文,精简全局配置

核心理念CLAUDE.md(或.cursorrules)不是垃圾桶,不要把API文档、数据库Schema一股脑塞进去。上下文越杂,AI越糊涂。

前端场景适配
  • 配置精简 :全局规则只保留项目核心架构(如:Vue 2.7 Composition API、TS strict mode)、目录结构指针、以及最核心的负面约束

  • 指针原则:不要在规则里贴代码片段,而是告诉AI"去读哪里"。

实操规则
  • ● 必做 :全局.cursorrules文件长度严格控制在 60行以内

  • ● 必做 :使用负面约束明确界限。例如:

    • "禁止在组件内直接写行内样式,必须使用<style lang="scss" scoped>"

    • "Vue 2.7项目中,禁止使用Vue 3特有的<script setup>语法(除非在特定的子模块)"

  • ● 必做 :对于通用工具库(如src/utils/request.ts),在规则中仅提供路径引用,禁止复制粘贴全量代码。

团队落地建议
  • 统一维护 :团队共享一份精简版.cursorrules,任何新增规则需经Review,确保"每条规则在80%的会话中都有用"。

前端案例:

不要把所有的接口类型定义都塞进Prompt。

Bad: 粘贴整个User接口定义到对话框。

Good: 在规则里写"涉及用户数据时,参考src/types/user.ts",让Cursor按需读取。


2. 舍 (Discard):舍弃"黑盒"依赖,手动管理会话

核心理念:自动上下文压缩是AI变傻的元凶。与其依赖Cursor的自动记忆,不如通过"模块化"手动切断上下文。

前端场景适配
  • 会话隔离:一个会话只干一件事。开发组件就是一个会话,联调接口是另一个会话。

  • 手动重置:当发现AI开始车轱辘话时,果断舍弃当前会话,由人总结关键信息后开启新对话。

实操规则
  • ● 必做"一票一会话"原则 。处理一个新的JIRA任务或开发新组件时,必须Cmd+L开启新Chat,严禁在一个Tab里从早聊到晚。

  • ● 禁止 :在重构复杂组件(如BusinessLogicReuseAgent)时,依赖@Codebase进行全库漫游。应手动@相关文件(如@index.vue @useDeviceList.ts),将上下文限定在最小必要范围。

团队落地建议
  • 提交即结束:每次Git Commit后,强制结束当前Cursor会话。

  • 模块化开发 :利用我们现有的composables架构。开发Hook时,只让AI关注该Hook文件,不要引入UI组件的噪音。

前端案例:

正在重构useDeviceList.ts,需要修改分页逻辑。

舍:不让AI去分析整个DeviceList.vue页面。

得:只@useDeviceList.ts和@api/methods/device.ts,指令清晰:"修改fetchDevices方法,增加分页参数校验"。


3. 离 (Separate):分离繁琐工作,自动化替代人工Prompt

核心理念:把AI当人看,把格式化、Linting等死板工作剥离给工具(Linter/Hooks),让AI专注于逻辑生成。

前端场景适配
  • 规则即技能 :利用.cursor/rules/*.mdc将复杂的最佳实践封装成"技能包"。AI不需要每次都被教导"如何写一个标准的Vue 2.7组件",它应该直接调用规则。

  • 工具兜底:不要浪费Token让AI检查"缩进是否为2空格"或"是否漏了分号",这是ESLint/Prettier的工作。

实操规则
  • ● 必做"Agent模式"开发。针对不同文件类型,创建独立的MDC规则文件。

    • 例如:编写Vue组件时,自动触发rules/ui-rules/component-organization-agent.mdc,确保结构统一。
  • ● 禁止:在Prompt中写代码风格要求(如"请使用单引号")。应在保存时通过项目的Prettier/ESLint自动修复。

  • ● 必做 :利用Cursor的Composer功能(Cmd+I)进行多文件联动修改,而不是在Chat里生成代码后手动复制粘贴。

团队落地建议
  • 规则库建设 :完善rules/目录下的.mdc文件。

    • ts-rules:固化TS最佳实践。

    • ui-rules:固化组件结构。

    • tool-rules:固化git提交规范。

前端案例:

离:不再在Prompt里写"请按照Vue 2.7写法,使用defineComponent,不要用any"。

自动化:直接创建rules/ts-rules/composition-api-vue2.7-agent.mdc。当创建.vue文件时,Cursor会自动读取规则,生成符合规范的模板代码。


三、 总结:前端极简协作公式

协作公式

\\text{高效Cursor} = (\\text{精简Context} + \\text{MDC规则库}) \\times \\text{模块化会话}

  • 精简Context:保证AI不被噪音干扰,智商在线。

  • MDC规则库:把团队规范代码化,让AI自带"肌肉记忆"。

  • 模块化会话:像拆解组件一样拆解对话,用完即扔。

团队小实验(建议本周尝试)

  1. "60行挑战" :检查你的项目.cursorrules,将其缩减到60行以内,只保留核心架构说明和路径指针。

  2. "无Codebase日" :尝试一天内不使用@Codebase(全库搜索),仅通过手动@File引用文件进行开发,对比代码准确率的变化。


附录:Cursor前端极简配置模板

将以下内容保存为项目根目录的 .cursorrules,配合 .cursor/rules/ 目录下的详细规则文件使用。

Markdown

复制代码
---
description: 启信慧眼项目前端核心规范 (Vue 2.7 + TS)
alwaysApply: true
---

# 项目核心上下文
- 技术栈: Vue 2.7 (Composition API), TypeScript, SCSS, Pinia
- 包管理器: pnpm (禁止使用 npm/yarn)

# 关键路径指针 (Pointer Principle)
- 组件规范: 参考 rules/ui-rules/component-organization-agent.mdc
- TS规范: 参考 rules/ts-rules/typescript-vue2.7-agent.mdc
- 状态管理: 参考 rules/ts-rules/pinia-vue2.7-agent.mdc
- 接口定义: 位于 src/types/ (禁止在Chat中臆造类型)

# 负面约束 (Negative Constraints)
- 禁止使用 Vue 3 的 <script setup> 语法 (除 src/submodule/ent-module 外)
- 禁止使用 any 类型,不确定的类型请使用 unknown 或泛型
- 禁止在组件中直接编写行内样式
- 禁止手动管理 node_modules,必须使用 pnpm 命令

# 行为准则 (Danshari)
- 保持回答简洁,直接给出代码,不要过度解释
- 修改代码时,优先展示 diff 或修改后的完整函数,保持上下文清晰
- 涉及复杂逻辑重构时,请先简述思路 (CoT) 再输出代码
相关推荐
在西安放羊的牛油果8 小时前
浅谈 import.meta.env 和 process.env 的区别
前端·vue.js·node.js
鹏北海8 小时前
从弹窗变胖到 npm 依赖管理:一次完整的问题排查记录
前端·npm·node.js
布列瑟农的星空8 小时前
js中的using声明
前端
薛定谔的猫28 小时前
Cursor 系列(2):使用心得
前端·ai编程·cursor
用户904706683578 小时前
后端问前端:我的接口请求花了多少秒?为啥那么慢,是你慢还是我慢?
前端
深念Y8 小时前
仿B站项目 前端 4 首页 顶层导航栏
前端·vue·ai编程·导航栏·bilibili·ai开发
dragonZhang8 小时前
基于 Agent Skills 的 UI 重构实践:从 Demo 到主题化界面的升级之路
前端·ai编程·claude
王林不想说话8 小时前
提升工作效率的Utils
前端·javascript·typescript
weixin_584121439 小时前
vue内i18n国际化移动端引入及使用
前端·javascript·vue.js
Delroy9 小时前
一个不懂MCP的开发使用vibe coding开发一个MCP
前端·后端·vibecoding