Cursor 的 Agent 模式和上下文感知能力，能让一个新项目的初始搭建从"先查文档再手写配置"压缩到几分钟内完成。以下是经过验证的高效流程：
1. 用一句话 Prompt 定好骨架
不要只说"创建一个 React 项目"，而是把技术栈、核心依赖和目录规范一次性交代清楚。例如：
"请帮我创建一个基于 Vite + React 18 + TypeScript 的前端项目，使用 React Router v6 做路由，Tailwind CSS 做样式，ESLint 和 Prettier 已配置好。项目目录按 pages、components、hooks、utils 划分，并给出基础的目录结构和配置文件。"
这样 Cursor 能一次性生成 vite.config.ts、tsconfig.json、路由入口和目录结构，而不是反复追问。
2. 让 Agent 模式自动落地文件（推荐）
如果需求涉及多个配置文件和目录，直接唤起 Agent 模式（侧边栏切换或快捷键 Ctrl/Cmd + I），输入：
"基于上述技术栈，初始化项目结构，创建所有必要的配置文件和空目录，并在 src/main.tsx 中写好基础路由挂载代码。"
Agent 会自动：
- 创建文件夹（如
src/pages、src/hooks） - 写入
package.json并指定依赖版本 - 生成配置文件（vite、tsconfig、tailwind、eslint）
- 在终端执行
npm install（如果你允许）
3. 用 @Docs 锁定官方最新配置
技术栈版本迭代快，AI 训练数据可能滞后。在 Prompt 中附加：
"请参考 React Router v6 最新官方文档配置路由，使用 createBrowserRouter 方式。"
或在聊天中直接 @https://reactrouter.com/en/main/start/tutorial 引入官方文档，让 AI 基于最新 API 生成代码，避免用到废弃的旧写法。
4. 分批次生成，避免"大锅炖"
如果项目较复杂，不要把所有业务模块都塞给 Agent 一次完成。建议分两轮：
- 第一轮：只搭环境、配工具链、跑通 Hello World；
- 第二轮：再让 AI 基于已确认的目录结构，生成具体的业务模块（如登录页、Dashboard 布局）。
每轮结束后人工检查 package.json 中的依赖版本是否合理，特别是 TypeScript、Vite 等工具的 major 版本，防止 AI 给出过时的模板。
5. 顺手补齐工程化配套
项目骨架跑通后，立即用 Cursor 生成配套内容：
README.md："根据当前项目结构，写一份本地启动和构建的说明".gitignore："生成一个 Node.js 项目的标准 gitignore"- 基础测试配置："配置 Vitest，并给 utils 目录下的示例函数写一个单元测试"
这样项目第一天就具备可交付的规范，而不是后期再补。
避坑提示
- 依赖版本：AI 生成的
package.json有时会引用较旧版本，建议生成后对照官方文档手动升级关键包； - 终端权限：Agent 执行
npm install前会询问，首次使用注意看清提示，避免在错误目录执行； - 逐步验证：每完成一个阶段就手动运行
npm run dev验证，不要等全部代码生成后再一次性排错。