必须放参考样例当需输出固定字段结构且团队有明确命名规范时，如问题位置、风险等级（p0/p1/p2）等；不放样例当只需开放列举根因且需人工判断时。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你在写 Cursor 性能排查清单的提示词（prompt）时，是否加入参考样例，直接决定 AI 是否能准确理解你要它输出的结构、粒度和专业深度——不加容易跑偏，加错反而干扰判断。
什么情况下必须放参考样例
当你需要 Cursor 输出固定字段结构的问题报告（例如：问题位置+问题描述+风险等级+修改方案），且这些字段在团队内部已有明确命名规范和分级标准时，【必须放一个真实、简洁、带注释的参考样例】。AI 对抽象格式指令的理解远弱于对具象模式的模仿。没有样例时，它可能把“风险等级”写成“高/中/低”，而你实际要求的是“P0/P1/P2”；也可能把“问题位置”模糊写成“Service 层”，而你要求精确到“OrderService.java 第 47 行”。
方法一：嵌入式样例（推荐）
在 prompt 中紧接指令后，用代码块或缩进格式插入一行真实样例：
示例输出格式：
● 问题位置：OrderService.java:47
● 问题描述：未对 userId 参数做非空校验，下游 DAO 调用可能触发 NPE
● 风险等级：P1
● 修改方案：在方法入口添加 Assert.notNull(userId, "userId must not be null")
什么情况下不该放参考样例
当你只要求 Cursor 列出“当前项目索引变慢的可能原因”，且后续要人工归类、验证、排序时，不要放样例。此时插入任何格式化模板都会诱导 AI 强行套用，导致它忽略真正关键但不符合模板的线索——比如它本该提醒你“.cursorignore 缺少 .output/ 目录”，却因样例里没出现“目录路径”字段而改写成“建议检查构建产物配置”，信息失真。
方法一：用动词限定输出行为
直接写：“列出 5 条最可能导致 Cursor 响应延迟的根因，每条独立成行，不编号，不加前缀，不解释原理。”
Agents 正在你的整个代码库中处理越来越复杂、运行时间更长的任务。本次版本引入了新的 agent 框架改进，以实现更好的上下文管理，并在编辑器和 CLI 中带来了许多提升使用体验的修复。
方法二：用否定式排除干扰
写：“只输出纯文本原因列表，禁止出现‘问题位置’‘风险等级’等字段标签，禁止使用冒号分隔，禁止给出解决方案。”
怎么放才不翻车：三个硬约束
第一步：样例必须来自你正在排查的真实项目
复制一份你刚在日志里看到的、真实的慢索引警告行，删掉敏感路径，保留原始措辞风格。AI 对“真实语境”的识别力远高于“通用模板”。
第二步：样例长度严格控制在 3 行以内
超过 3 行，AI 容易注意力偏移，开始复述样例而非生成新内容。尤其避免在样例里塞注释、括号说明、emoji 或换行符。
第三步：样例之后必须紧跟一句动作指令
例如：“按以上格式，扫描当前 workspace 下所有 .cursorignore 文件，输出缺失的关键排除项。”【缺少这句指令，AI 会停在样例理解阶段，不再执行扫描】
