Cursor 的提示词不需要复杂语法,把任务、约束、上下文三点说清楚即可。以下是最常用的 8 个场景模板,复制后替换括号内容即可直接发送。
1. 从零生成代码
请用 [语言/框架] 实现一个 [功能描述] 的 [函数/组件/类]。
要求:
- 输入/输出:[参数及返回值说明]
- 边界处理:[如空值校验、异常捕获]
- 风格约束:[如纯函数、异步 async/await、不使用第三方库]
示例:请用 TypeScript 实现一个带防抖的输入框 Hooks,延迟 300ms,支持立即执行选项。
2. 解释代码
请解释这段代码的作用和执行流程:
1. 核心逻辑分几步完成?
2. 有没有潜在副作用或风险?
3. 可以如何简化?
技巧:直接选中代码按 Ctrl/Cmd + L 发送到侧边栏,AI 已自带上下文,你只需补一句"逐行解释"或"画出数据流"。
3. Bug 定位与修复
这段代码报错信息如下:
[粘贴错误日志或终端输出]
预期行为:[描述]
实际行为:[描述]
请定位根因并给出修复后的完整代码,用注释标出修改点。
进阶:在对话中输入 @终端 引入最近报错,或 @文件 引入相关依赖代码(详见 3.4 节)。
4. 重构与优化
请对以下代码进行重构,目标:[提升可读性 / 降低复杂度 / 提升性能]。
约束:
- 不得改变现有对外 API 签名
- 保持向后兼容
- [其他限制,如保留对 IE 的支持]
请给出重构后的代码,并说明关键改动理由。
5. 生成单元测试
为以下 [函数/类/组件] 生成单元测试。
测试框架:[Jest / pytest / Vitest 等]
要求:
- 覆盖正常路径、边界条件和异常输入
- 对 [外部依赖] 进行 mock
- 每个测试用例附加中文描述说明断言意图
6. 补充注释与文档
为这段代码补充 [JSDoc / Docstring / 行内注释]。
要求:
- 公共 API 说明参数类型、返回值及可能抛出的异常
- 复杂逻辑块解释"为什么这么做",而非复述"做了什么"
- 如需,附上一个简短的使用示例
7. 跨文件/项目级批量修改(Agent 模式)
任务:将项目中 [旧实现] 统一调整为 [新实现]。
范围:@代码库 或具体 @文件A @文件B
执行要求:
1. 先列出受影响的文件清单
2. 逐文件修改,确保不破坏现有接口
3. 完成后生成修改摘要
示例:把全库的 console.log 替换为统一封装的 logger.debug,并保留原始日志内容。
8. 技术方案对比
在项目技术栈为 [说明] 的背景下,对比 [方案A] 与 [方案B]。
评估维度:性能、维护成本、学习曲线、与现有架构兼容性。
请给出推荐结论,如需迁移,列出关键步骤和风险点。
通用原则
- 先上下文,后指令:涉及多文件时,先用
@文件或@代码库把背景喂给 AI,再提具体要求。 - 一次一事:不要同时要求"重构+写测试+换框架",分步执行准确率更高。
- 代码块包裹:粘贴代码时用 \
\\` 包裹,避免格式错乱导致 AI 误读缩进。