在cursor中编写技术债说明必须锚定问题根源、影响范围和修复路径，采用三步结构：①【技术债类型】+【模块名】+【当前表现】；②→ 触发条件：具体操作路径；③→ 风险后果：含运行时影响与维护成本各一项，并校验代码行号、可复现参数、临时与根治方案。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在Cursor中编写技术债说明时，必须确保提示词精准锚定问题根源、影响范围和修复路径，否则生成的说明容易泛泛而谈，开发人员无法据此排期或评估风险。
明确锁定技术债的三个核心要素
第一步：在提示词开头用「【技术债类型】+【模块名】+【当前表现】」固定结构起句。例如：“【架构耦合】用户鉴权模块中Token校验逻辑与JWT解析硬编码耦合，导致无法切换认证协议”。这一步强制剥离模糊描述，【不写“性能差”“不好维护”这类主观判断，只写可验证的行为现象】。
第二步：紧接着插入「→ 触发条件：」+ 具体操作路径，如“→ 触发条件：调用/api/v2/login接口且传入refresh_token字段”。没有触发条件的技术债说明等于无效文档。
第三步：用「→ 风险后果：」列出两条客观结果，必须含一项运行时影响（如“每次刷新token失败率上升12%”）和一项维护成本（如“新增OAuth2支持需重写3个Service类”）。避免出现“可能影响”“潜在风险”等弱约束表述。
Agents 正在你的整个代码库中处理越来越复杂、运行时间更长的任务。本次版本引入了新的 agent 框架改进，以实现更好的上下文管理，并在编辑器和 CLI 中带来了许多提升使用体验的修复。
过滤冗余信息的两种方法
方法一：用「保留」指令显式声明关键字段。在提示词末尾加一句：“保留：错误码（401/403）、涉及类名（AuthFilter.java、TokenService.java）、最近一次报错时间（2024-05-12 14:22）”。Cursor会忽略其余日志堆栈和调试变量。
方法二：用「剔除」指令屏蔽干扰项。“剔除：前端报错截图、个人排查过程、历史讨论记录、非Java文件路径”。这能防止Cursor把会议纪要片段混进技术债说明里。
生成后必须校验的硬性检查点
生成结果出来后，立刻逐行核对三项内容是否全部存在：① 精确到行号的代码位置（如“src/main/java/com/app/auth/TokenService.java:87”）；② 可复现的输入参数组合；③ 明确标注「临时方案」和「根治方案」的段落。缺任何一项都必须重写提示词。
特别注意：如果Cursor输出中出现“建议后续优化”“可考虑重构”这类软性表述，说明提示词里漏掉了「→ 根治方案：」前缀——这是最常踩的坑，【必须用「→ 根治方案：」开头，且后面跟具体代码修改动作，例如“将TokenParser抽离为独立Bean并注入AuthFilter”】。
