《Cursor文档》-为 Agent 编写提示

通过聊天输入框中的文本提示词指导智能体。你可以添加上下文、图像和语音,并随时切换模型。

@ 提及

在聊天输入框中输入 @,即可为提示词附加特定上下文。在 @ 后继续输入,Cursor 会显示匹配的建议。

  • 文件和文件夹:使用 @auth.ts@src/components/ 添加文件或文件夹 (选择文件夹后输入 / 可继续深入浏览)
  • 终端:使用 @Terminals 将终端输出添加为上下文
  • 聊天:使用 @Chats 引用之前对话中的上下文
  • Git diff:使用 @Commit (Diff of Working State) 添加未提交更改的 diff,或使用 @Branch (Diff with Main) 添加整个分支的 diff
  • 浏览器:使用 @Browser 附加内置浏览器中的上下文

当你知道哪些文件相关时,可使用 @ 提及。如果不确定哪些文件重要,可以跳过——智能体会自行搜索并找到相关文件。

自定义模式

在聊天输入框中输入 / 以调用技能。按 Enter 会将该技能附加到一条消息中,随着对话继续,它会逐渐淡出。将任意技能用作自定义模式,可让智能体在工作时始终专注于该技能。

/ 菜单中选择技能后,改按 Option+Enter (Mac) 或 Alt+Enter (Windows) 。你也可以在技能条目中选择 用作模式。在模式中,即使智能体持续工作数小时,该技能也会在每一轮中保持在上下文中,直到你退出该模式。

自定义模式适合描述工作方式而非一次性任务的技能。你可以在浏览多个文件时保持代码评审清单启用,或在整个功能开发过程中持续启用如 /tdd 这样的团队手册。

自定义模式可在代理窗口命令行界面中使用。任何具有有效 frontmatter 块的技能都可作为模式的基础,可选的 iconcolor frontmatter 字段可设置模式徽章的样式。请参阅将技能用作自定义模式

图像输入

在提示词中附加图像,为 UI 开发、调试和设计实现提供视觉上下文。

  • 将图像文件拖放到聊天输入框中
  • 使用 Cmd+V 从剪贴板粘贴图像,包括屏幕截图

这可用于实现设计稿、调试视觉问题,以及引用错误消息或堆栈跟踪,无需手动转录。

语音输入

点击聊天输入框中的麦克风图标,即可通过口述输入提示词,无需键入。请自然表达,并说清文件名、函数名等技术细节;发送前请检查转写内容。

上下文用量

每个聊天都会与模型共用固定大小的上下文窗口。随着你添加文件、运行工具和收发消息,这些 token 会逐渐占满窗口。当窗口接近满载时,Cursor 会将对话中较早的内容压缩为摘要,为后续对话腾出更多空间。

提示词输入框旁的上下文环可让你一目了然地查看窗口的使用情况。点击该环可打开明细面板,其中按类别显示已使用的 token 总数:

  • 系统提示词:Cursor 为模型提供的内置指令
  • 工具:智能体可用的所有工具的定义
  • 规则:提示词中包含的项目规则和用户规则
  • 技能:注入系统上下文的技能描述
  • MCP:已连接的 MCP 服务器提供的指令和目录
  • 子智能体:智能体可启动的子智能体类型文档
  • 已摘要的对话:较早轮次的压缩摘要
  • 对话:你的消息、智能体的回复和工具结果

将鼠标悬停在条形图中的某个区段或列表中的某一行上,即可高亮显示该类别。

切换模型

使用聊天输入框顶部模型选择器的下拉菜单切换模型,或按 Cmd / 在模型之间循环切换。更改会应用于当前对话的后续内容。可在 Cursor 设置 > 模型 中设置默认模型。

  • 速度更快的模型适合快速编辑和常规任务
  • 能力更强的模型更适合复杂推理和多文件重构

你可以在对话中途切换模型。例如,速度更快的模型已完成探索,但在实现时你需要更深入的推理。完整列表请参阅模型与价格

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜