Cursor 高级进阶手册：用 .cursorrules 与多模型路由驯服工程级代码生成

一、为什么你的 Cursor 总是“答非所问”？

很多工程师在使用 Cursor Composer 时经常抱怨： - 总是喜欢删掉原有注释和关键逻辑 - 随意引入项目中根本没有安装的第三方依赖 - 频繁生成假大空的客套话，浪费生成 Token 与等待时间

根本原因在于：未对模型输入施加硬性的工程规则约束（Engineering Guardrails）。

二、生产级 .cursorrules 实战配置

在项目根目录下创建 .cursorrules，将以下工业级规约固化：

# 团队工程代码生成红线
- 严禁删除未变更区域的代码注释与类型定义
- 严格遵循当前项目的包管理器 (pnpm / poetry)，严禁自作主张新增依赖
- 代码必须是完整的、可编译的，严禁输出 "// ... rest of code here ..." 等伪代码
- 输出风格：直接给出 diff 或修改后代码，严禁输出“好的，我已经为你修改完毕”等客套废话
- 所有公开函数必须带有 JSDoc / Type Annotations

三、双模型混合路由实战策略

在 Cursor 高级设置中，建议按任务维度进行模型解耦：

1. 日常代码补全与轻量单文件修改：路由给 Gemini 2.5 Flash 或 Claude 3.5 Haiku，响应延迟 < 200ms，极速流畅。
2. 多文件全局重构与架构设计：强行指定 Claude 3.7 Sonnet (Thinking)，借助扩展思考链精准推演复杂的依赖拓扑。

musen 建议：好工具的关键在于立好规则。把规范写入代码库，新入职员工与 AI 都能即刻遵循最严谨的开发水准。