<p>【你是一名有5年后端经验的Tech Lead，正在给研发经理写技术债整改说明书】列出3条可立即执行的整改步骤，每条含具体操作、负责人、预期耗时（小时）。不许出现“建议”“可以”“考虑”等模糊动词；每条步骤以“执行”开头；时间单位统一为“小时”；负责人写“后端组”或“前端组”，不写人名。ERROR: UserSessionService.load() 调用DB查询超时（平均1.8s），当前无缓存层，且SQL未走索引严格按以下表格格式输出，禁止额外文字：| 步骤 | 操作 | 负责人 | 耗时（小时） |</p>
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要用cursor写一份技术债说明文档，但直接输入“写技术债说明”得不到可执行步骤，它只会输出泛泛而谈的段落。必须让ai明确知道你要的是带编号、可落地、能立刻复制粘贴进会议纪要或jira的行动项。第一步：用角色+动词+约束框定输出格式
在Cursor输入框里，第一句就写：【你是一名有5年后端经验的Tech Lead，正在给研发经理写技术债整改说明书】。这句不是客套话——没有这个身份锚点，AI会默认按通用文案风格输出，比如“建议逐步优化”“需关注长期影响”，全是虚的。
紧接着加动词指令：“列出3条可立即执行的整改步骤，每条含具体操作、负责人、预期耗时（小时）。”
最后加硬性约束：“不许出现‘建议’‘可以’‘考虑’等模糊动词；每条步骤以‘执行’开头；时间单位统一为‘小时’；负责人写‘后端组’或‘前端组’，不写人名。”
第二步：绑定上下文避免空泛描述
把真实代码片段或错误日志粘贴在提示词末尾，用三个反引号包裹。例如：
```
ERROR: UserSessionService.load() 调用DB查询超时（平均1.8s），当前无缓存层，且SQL未走索引
```
这一步不能省——没有上下文的技术债说明，AI只能编造“数据库性能待优化”这种废话。有了具体报错，它才可能写出“执行：为user_session表的user_id字段添加B-tree索引 → 执行：在SessionController中接入Redis缓存load()结果 → 执行：将load()超时阈值从2s下调至800ms并加熔断逻辑”。
Agents 正在你的整个代码库中处理越来越复杂、运行时间更长的任务。本次版本引入了新的 agent 框架改进，以实现更好的上下文管理，并在编辑器和 CLI 中带来了许多提升使用体验的修复。
第三步：强制结构化输出（防AI自由发挥）
方法一：用Markdown表格模板收口
在提示词最后追加：“严格按以下表格格式输出，禁止额外文字：| 步骤 | 操作 | 负责人 | 耗时（小时） |”
方法二：用分隔符锁定段落边界
写：“请用‘---’分隔每条步骤，每条包含且仅包含：①执行动作 ②依赖条件（如‘需DBA授权’）③验证方式（如‘查NewRelic响应P95
【注意：如果漏掉‘验证方式’，步骤就不可闭环——开发做完自己都不知道算没算完成】
