Cursor代码文档只讲语法不讲业务逻辑，是因为它默认聚焦语言结构而非上下文意图，必须用明确指令强制其关注功能目的、数据流向和调用约束。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Cursor生成的代码说明文档只讲语法不讲业务逻辑，是因为它默认聚焦语言结构而非上下文意图，必须用明确指令强制它关注功能目的、数据流向和调用约束。
让Cursor解释“为什么这么写”而不是“这是什么语法”
在提示词开头直接声明角色和输出目标：你是一位有5年Python后端经验的资深工程师，正在为新同事编写可维护的文档，请用自然语言说明这段代码解决什么实际问题、输入数据从哪来、输出结果被谁消费、关键分支的业务含义是什么。
把原始代码粘贴后，追加一句：不要解释for循环或try语句的语法定义，只回答“这里为什么要用重试机制？”“这个字段名为什么叫user_profile_cache_key而不是user_cache？”
这一步操作起来很简单，直接把文件拖进去就行。
注入业务上下文的三种方法
方法一：在代码块上方加三行注释，用中文写清场景。例如：# 用户登录成功后触发，需保证头像URL绝对有效，失败则回退到默认头像
Agents 正在你的整个代码库中处理越来越复杂、运行时间更长的任务。本次版本引入了新的 agent 框架改进，以实现更好的上下文管理，并在编辑器和 CLI 中带来了许多提升使用体验的修复。
方法二：提供调用链路片段。例如：前端调用 /api/v1/login → AuthController.login() → 调用本函数 → 返回 {avatar: string} 给前端渲染头像
方法三：给出输入输出样例并标注字段含义。例如：【输入】user_id=12345（数据库主键），tenant_code="cn-shanghai"（租户隔离标识）→ 【输出】返回带CDN签名的HTTPS地址，有效期2小时
封住“语法解释”的退路
第一步：在提示词末尾加上硬性禁令——禁止出现以下词汇：「语法糖」「关键字」「语句结构」「Python中表示」「JS里用于」。
第二步：要求每段说明必须包含一个动词短语作主干，如“校验手机号格式并触发短信发送”“从Redis读取缓存并合并本地配置”。
第三步：指定句式模板：“当……时，执行……，目的是……，否则会导致……”。例如：当用户连续输错密码3次时，执行账户临时锁定，目的是防止暴力破解，否则会导致账号被盗风险上升。
