用.cursorrules文件定义项目上下文，再将规范拆解为@引用的.md规则块，chat中通过@精准激活，最后git版本化并支持跨项目复用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想把在Cursor里反复用到的个人开发习惯、项目规范或高频操作固化成一套能随时调用、不随对话消失的提示词流程，而不是每次都要重新组织语言描述“我用的是Next.js 14、API路由写在/app/api下、所有错误必须返回JSON格式”。
第一步：用.cursorrules文件定义项目级上下文
在项目根目录新建一个名为 .cursorrules 的纯文本文件，不要加扩展名。这个文件就是你个人IP提示词的“注册证”，它会在你打开该项目时自动加载，覆盖全局默认行为。
直接写入角色+约束+工具三要素，例如：
你是一名专注Next.js 14 App Router的全栈工程师，只修改当前项目内已存在的文件路径，禁止创建新目录；所有API路由必须导出POST/GET等标准方法，响应体严格使用{ success: boolean, data?: any, error?: string }结构；可读取@src/lib/api/client.ts中的baseURL和authHeader配置。
注意：文件名必须是 .cursorrules，少个点或拼错都会失效。
第二步：按场景拆解为可复用的.md规则块
把大而泛的“我是谁”拆成具体动作指令，每个功能单独存为一个 .md 文件，放在项目根目录下的 .cursor-rules/ 子目录里（需手动创建）。这样以后在Chat中输入 @codegen-api-route 就能精准触发对应逻辑。
例如，新建 .cursor-rules/api-route-template.md，内容写成：
生成一个Next.js App Router风格的API路由文件，路径为/app/api/{name}/route.ts；请求体解析用Request.json()；成功响应返回status 200 + { success: true, data }；错误统一捕获并返回status 400 + { success: false, error }；代码必须包含JSDoc说明函数用途和参数。
Agents 正在你的整个代码库中处理越来越复杂、运行时间更长的任务。本次版本引入了新的 agent 框架改进，以实现更好的上下文管理，并在编辑器和 CLI 中带来了许多提升使用体验的修复。
再建一个 .cursor-rules/zustand-store.md，内容聚焦状态管理规范：“用Zustand v4.5创建store，使用create
第三步：在Chat中用@引用精准激活
打开Cursor Chat面板，输入任意自然语言需求，比如“我要给用户列表加个搜索接口”，然后在句末加上 @api-route-template。
Cursor会自动读取该.md文件内容，并将其作为本次对话的强约束条件，生成的代码将严格遵循你定义的API结构、错误格式和JSDoc要求。
这一步不能写成“参考api-route-template”，必须用 @ 符号直接引用文件名（不含.md后缀），否则AI只会当普通文字阅读。
第四步：版本化管理与跨项目复用
把整个 .cursor-rules/ 目录和 .cursorrules 文件一起提交到Git仓库，团队成员克隆后开箱即用。
若想在多个项目间复用同一套规则，可将这些文件打包为独立仓库（如my-cursor-rules），然后在新项目中用git subtree或git submodule引入，再在新项目的.cursorrules里添加一行 include: ../my-cursor-rules/.cursorrules。
这一步操作前请确认子模块路径正确，路径错误会导致规则完全不生效且无报错提示。
