Cursor Agent 支持多种输入方式提高编程效率：用 @ 引用特定文件、函数、文档和历史对话，拖拽图片或截图作为视觉上下文，语音输入减少打字，随时用 Cmd+/ 切换不同 AI 模型。本文介绍 Cursor 2.0 提示词的完整技巧，包括 @ 提及用法变化——新版 Agent 会自动收集 Web、Git、Linter 等上下文，不再需要手动附加。

Cursor Agent 提示词技巧

好的提示词让 Agent 更精准地完成任务。Cursor 提供了多种上下文附加方式——文件引用、图片、语音，以及灵活的模型切换。

---

@ 引用：给 Agent 精确的上下文

在输入框里输入 @，Cursor 会弹出候选列表：

引用方式	示例	效果
文件	@auth.ts	把整个文件包含进对话
文件夹	@src/components/	包含整个目录（输入 / 可继续导航子目录）
代码符号	@getUserById	引用特定函数、类或变量
文档	@Docs	搜索已索引的文档（支持添加自定义文档）
历史对话	@Past Chats	引用之前对话的上下文

什么时候用 @？ 当你明确知道哪些文件和 Agent 的任务相关时再用。如果不确定，直接描述任务——Agent 会自己搜索相关文件。

Cursor 2.0 变化： 以前的 @Web、@Git、@Definitions、@Linter Errors 等显式引用已移除。Agent 现在会在需要时自动收集这些上下文，更智能也更省事。例如"回顾我这个分支上的改动"——Agent 会自己去读 git diff，不需要你手动附加 @Git。

---

图片输入：给 Agent 看截图和设计稿

两种方式附加图片：

• 拖拽文件：把图片文件拖到聊天输入框
• 粘贴截图：Cmd+V（或 Ctrl+V）直接粘贴剪贴板图片

典型使用场景：

• 把 Figma 截图或设计稿发给 Agent，让它根据视觉稿写代码
• 截图 UI Bug 发给 Agent，让它定位问题
• 截图报错信息（不用手动抄错误文字）

---

语音输入

点击输入框里的麦克风图标，直接用语音描述任务。发送前可以确认转录内容再修改。

适合需要描述复杂上下文但不想打字的场景，或者想快速说出文件名和函数名。

---

切换 AI 模型

使用输入框顶部的模型选择下拉框切换，或按 Cmd+/（Ctrl+/）在模型间循环。切换后影响当前对话后续所有消息。

在 Cursor Settings > Models 可以设置默认模型。

模型选择建议：

• 快速模型：适合简单编辑、重复性任务（速度快、成本低）
• 高能力模型：适合复杂推理、多文件重构（更准确、更贵）

可以在对话中途切换，比如探索阶段用快速模型，到了实现阶段再换高能力模型。

---

常见问题

Q: Agent 找不到相关文件，怎么帮它？

用 @ 引用具体文件或函数。或者在提示词里明确说明"相关逻辑在 src/auth/ 目录"。

Q: 能把 PDF 或长文档发给 Agent 分析吗？

Cursor 主要支持图片输入（视觉模型）。长文档可以用 @Docs 先建立文档索引，Agent 可以按需检索。

Q: 换了模型，之前的对话上下文还在吗？

在，切换模型只影响后续消息使用的模型，不影响已有的对话历史和上下文。