CURSOR-AI.CN中文资料站 · 非官方版本 3.30 · 更新 2026-11-14 · 共 20 页下载与版本 ↗
12 · 产品 / Agent任务

cursor Agent任务 - 从下达到审查的多文件改动流程

讲清任务描述四要素(做什么/在哪做/不能动什么/怎么算做完)、什么规模必须先出计划、如何逐文件审查 diff,以及跑偏时的中止与回滚顺序。

01

什么才算一个任务

不是「问一句话」,而是「交付一段可审查的改动」。

本篇专讲 cursor Agent任务。它和「问一句答一句」的区别在于:任务会读取多个文件、按计划修改、产出一组 diff,你需要逐段审查后决定接受哪些。

所以评价一次任务好坏,不看回答写得多流畅,看三件事:改动是否落在指定范围、有没有越界修改、以及本地验证能不能跑通。

注意 · 前置条件:项目索引必须完成。索引残缺时下任务,最容易出现的不是「答错」,而是「漏改文件」。
02

任务描述的四要素

缺一项,跑偏概率就上去一截。

要素写什么反例
做什么目标行为与验收标准「优化一下」
在哪做用 @ 引用文件 / 目录不指定范围,让 Agent 自己猜
不能动什么依赖、配置、其他模块完全不设边界
怎么算做完测试通过、行为可复现只看「已完成」提示
cursor / 一条完整的任务描述
在 @src/cart.ts 的结算函数里,数量为 0 时跳过折扣计算。
不要改税率逻辑,不要新增依赖。
补一个单测覆盖数量为 0 的情况,并说明怎么跑。

在 cursor Agent任务 里,「不要改什么」常常比「要改什么」更关键,因为它直接决定了审查时的工作量。

03

什么规模要先出计划

计划不是形式主义,是最便宜的纠错点。

任务规模要不要先出计划理由
单文件、几行改动不必直接做,审查成本本来就低
2–3 个文件建议确认它理解的文件范围对不对
跨模块 / 超过 3 个文件必须方向错了,改完再返工代价很大
涉及依赖或构建配置必须影响面超出代码本身
陌生仓库的排查先要解释,不改动先确认理解一致
计划阶段的提问句式

「列出你打算改哪些文件、每处改什么、可能影响什么,先不要修改任何文件。」确认清单后再说「按这个计划执行」。

04

分批审查 diff

接受改动之前,逐文件过一遍。

  1. 看文件清单

    先确认改动文件都在预期范围内,出现意外文件先停下来。

  2. 看边界条件

    空值、异常、并发、越界,这些最容易被漏掉。

  3. 看错误处理

    新增分支有没有吞掉错误、有没有改坏原有提示。

  4. 看无关改动

    格式化、排序、注释调整混进来时,手动回退这部分。

  5. 本地验证

    跑测试并手动复现关键路径,再提交。

不要因为 diff 看起来「差不多」就整体接受。一次超大 diff 里藏一处越界改动,排查成本远高于分批做。

05

跑偏时怎么中止与回滚

先止损,再重来。

情况立即做什么之后
开始改了不该改的文件中止当前任务补写「不能动什么」再重下
计划方向就错了不执行,直接重写任务把验收标准写具体
已经落下一堆改动用版本控制丢弃未提交改动拆成 2–3 个小任务重做
测试挂了但说不清哪处导致回退到上一次提交每步单独提交,缩小范围
索引明显不对重建索引并重启等完成后再下任务
注意 · 养成「每完成一个小任务就提交一次」的习惯,回滚粒度才够细;攒一大堆再提交,等于没有回滚能力。
06

与其他能力的边界、小结

知道什么时候不用它,同样重要。

小结 cursor Agent任务:写清四要素、达到规模先出计划、逐文件审查 diff、每步单独提交。

把这四件事做成习惯,工具带来的收益才稳定。