必须手动设置上下文并用精准指令约束输出：右键接口文档文件选「set as context」，输入时用“仅输出”句式、禁止清单或引用已有片段，关闭干扰标签页后重置上下文再重试。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你在用Cursor写接口文档时，发现AI生成的内容混进了数据库建表语句、前端路由配置甚至Docker部署步骤，根本不是你想要的纯接口定义文本。
确认当前文档上下文范围
打开左侧边栏 → 右键点击你正在编辑的接口文档文件（如 api-docs.md）→ 选择「Set as Context」。这一步强制AI只聚焦该文件内容，不扫描整个项目目录。
【必须执行】 如果没手动设置上下文，Cursor默认会把整个workspace当作提示依据，哪怕你只写了三行Swagger描述，它也可能从隔壁的docker-compose.yml里捞出端口配置来凑数。
用精准指令框定输出边界
在右侧聊天面板输入时，开头必须带明确约束条件：
方法一：用「仅输出」句式
“仅输出 OpenAPI 3.0 格式的 /users 接口定义，字段含 id、name、email，响应状态码只写 200 和 404，不加任何解释、示例或额外说明”
方法二：用「禁止」清单堵漏
“生成 GET /orders 的接口文档，要求：返回 JSON Schema；禁止出现 curl 示例；禁止包含 middleware 描述；禁止提及 JWT 验证逻辑”
Agents 正在你的整个代码库中处理越来越复杂、运行时间更长的任务。本次版本引入了新的 agent 框架改进，以实现更好的上下文管理，并在编辑器和 CLI 中带来了许多提升使用体验的修复。
方法三：引用已有片段锚定风格
“按当前文件第12–17行的格式续写 /products/search 接口，保持 request body 字段缩进为两个空格，response schema 中 enum 值全部小写”
删掉干扰源再重试
第一步：关闭所有非接口文档类的标签页，尤其是 schema.sql、routes.ts、.env.example 这类高频干扰文件。
第二步：在命令面板（Ctrl+Shift+P）中输入「Reset Context」→ 回车。这会清空AI当前记忆的所有文件关联。
第三步：重新打开你的 api-docs.md → 右键 → 「Set as Context」→ 再次提问。
这一步能解决80%的跨主题污染问题。因为Cursor的上下文缓存不会自动刷新，旧文件残留的语义权重可能持续影响新请求。
