Cursor
上下文管理
@ 符号引用、Notepads 持久化与上下文窗口管理策略。
上下文是 AI 编码的核心燃料——给对的上下文，准确率从 62% 跃升到 91%。
@ 符号引用
在 Chat 或 Composer 中输入 @ 唤出引用菜单：
| 引用 | 说明 |
|---|---|
@Files & Folders | 引用文件或目录，大文件自动压缩 |
@Docs | 引用内置或自定义文档（@Docs > Add new doc 可添加） |
@Terminals | 引用终端输出内容 |
@Past Chats | 引用历史对话，延续之前的工作 |
@Branch | 引用当前分支与主分支的 Diff |
@Browser | 引用浏览器页面内容 |
越精准越好：
❌ 帮我修复登录的 bug
✅ @src/auth/login.ts 第 45 行的 validateToken 抛异常，@src/types/auth.ts 是类型定义，帮我修复已知具体文件直接用 @filename；不确定在哪就让 Agent 自行搜索。组合使用效果更好：@src/api/users.ts @Docs:Next.js 改成 App Router 格式。
Notepads：跨会话复用
Notepads 存储持久化上下文（架构说明、API 文档、业务逻辑等），不会自动注入，需通过 @notepad-name 手动引用。
创建方式：命令面板 → Cursor: Open Notepad → 编辑内容 → 对话中 @notepad-name 引用。
上下文管理策略
上下文质量在 20–40% 容量时就开始下降，核心策略：
- 一个对话一个任务 — 完成后新建会话
- 按需引用 — 让 Agent 自主搜索比手动添加 20 个文件更有效
- Notepads 存持久信息 — 避免每次重复粘贴
- Rules 承载规范 — 技术栈、风格、架构写入
.cursor/rules/ - 复杂任务分阶段 — 上一阶段产出自然成为下一阶段上下文
提示词技巧
| 技巧 | 示例 |
|---|---|
| 链式思维 | 先看 SQL 执行计划，再检查 N+1 查询，最后给优化建议 |
| Few-Shot | 格式参考 @src/api/users.ts，按相同风格写 orders 接口 |
| MECE 拆解 | 分三步：1. 提取类型 2. 分离逻辑到 hooks 3. 添加错误边界 |