想要让Cursor生成的接口调用示例提示词更贴合平台使用场景，避免生硬模板或AI式表达，核心在于模仿真实开发者在IDE里边写代码边思考的即时沟通方式——这不是撰写操作手册，而是给同事留下一条带上下文的注释。

先明确一个关键认知：许多人在写提示词时习惯使用系统化指令，比如“请生成一个GET请求示例”，但这样产出的内容往往像考试标准答案。更高效的做法是直接描述自己的实际场景，例如“我正在开发/api/users这个接口的测试，需要一条能直接粘贴到Postman的curl命令，附带Bearer token和Accept头”。前者像是刚debug三小时后在聊天框随手敲的一句话，后者则自然得多。

关键在于，所有提示词必须以第一人称+具体动作场景开头。这一步不加任何修饰，就是把“生成”这样的动词替换为“我在……时需要……”。否则Cursor容易默认进入文档模式，输出带编号步骤的教程风格。

嵌入真实文件路径和变量名

方法一：直接引用当前项目结构。在提示词里写明“参考@src/lib/api/client.ts中的baseURL和authHeader配置”，比说“使用项目中已有的认证方式”有效十倍。Cursor会自动读取该文件内容，提取token注入逻辑、header拼接规则等细节。

方法二：复用已有变量命名。如果项目里用户ID字段统一叫userId（而非id或user_id），提示词就写“请求参数使用userId，别用id”。变量名不一致会导致生成的代码无法直接运行，且调试时难以定位。

按执行顺序组织提示词结构

第一步：说明当前卡点。比如“正在修改/src/app/settings/page.tsx，页面加载时需要调用更新通知设置的API，但不确定请求体格式。”

第二步：给出已有线索。比如“后端文档说明接口是PATCH /api/v1/notifications，返回204，请求体为{‘email_enabled’: boolean, ‘push_enabled’: boolean}。”

第三步：明确所需结果。比如“请提供一个useMutation调用示例，使用React Query，错误边界用toast.error，成功后触发router.refresh()。”

这种三段式结构完全复刻了你在Cursor里右键选中一段代码→按Cmd+K→输入提示词的真实操作流程。不需要额外解释“为什么分三步”，因为开发者本来就是这么思考的。