怎么防止ai 在长任务的项目编码中 风格偏移 缺乏全局思维 最后导致屎山代码 难以维护

来自夹夹 QQ 群讨论,审核后公开 · 。查看原始讨论

提问

怎么防止ai 在长任务的项目编码中 风格偏移 缺乏全局思维 最后导致屎山代码 难以维护

回答

这是个真问题,而且大多数人的解法都错了。他们靠嘱咐——在提示词里写「请保持风格一致、注意全局架构」,然后指望模型自己记住。长任务里这套必然失效,原因不是你提示词写得不够狠,是上下文物理上装不下:跑到第三十轮,前面写的约定早被挤出窗口了。

所以正确思路是把「风格」和「全局」从模型的自律问题,变成仓库的确定性约束问题,模型想偏也偏不了。

先说风格漂移。这是最容易根治的一类,因为它可以机械校验。做法是把你们团队的风格写成机器可执行的规则,而不是自然语言描述:eslint 加 prettier 加类型检查,配好自定义 rule 把你们的约定写死(不许 any、必须显式返回类型、文件按某某结构导出)。然后做成 Hook——每次模型改完文件立刻跑 lint 和 tsc,报错直接把原始错误喂回去让它自己修,不许它说「已完成」。这一步能干掉八成的风格偏移,因为它不依赖模型记性,是每次落盘必跑的确定性关卡。再往前一步,让它改任何文件前先读同目录的相邻文件,抄邻居的写法,比抽象描述有效得多。

全局思维这块更麻烦,因为「全局」不能被 lint 校验。我的经验是别指望模型自己抬头看全局,得靠你把这个动作写进流程。三个东西:

一是把架构约束压成一份很短的文件,只写代码里看不出来的东西——分层规则、谁可以引用谁、新功能该落在哪个目录。别写成几千字的架构文档,那份东西模型读一半就开始飘。控制在百来行,每次会话开头必读。

二是给目录结构索引,让它有「地图」。长任务里模型出问题的典型形态不是写错,是把新功能随手塞进一个已有文件里,或者重造一个叫 utils2 的东西。你给它一份「现有模块职责一句话清单」,它才有地方落位。

三是防重造。让它实现任何东西前先搜一遍仓库:「这个能力是不是已经有了」。搜完再说。这一条能省掉最多的屎山。

然后是长任务真正的机制问题:不要一个会话从头跑到尾。屎山代码绝大多数是单会话长跑出来的,因为上下文被污染、前期的决策被遗忘、后期模型的自我一致性需求会逼着它给前面的烂决定打补丁。正确拆法是按「可验收的切片」拆,每个切片一个独立会话,用 git worktree 隔离工作目录,干完一个合一个。每个新会话的初始上下文只带三样:架构约束文件、目录索引、这次要做的切片的明确验收条件。前一个切片的结论通过代码和一次 commit 传递,不通过对话传递。

再加一层最有效的兜底:人来审 diff,不审它的总结。模型每次交付都说「已完成,测试通过」,这个不可信。你看三样——实际跑了哪些命令和原始输出、diff 里有没有夹带你没要求的东西、有没有偷偷改配置文件。审 diff 这件事没法自动化绕过,你偷懒一次就埋一颗雷。

最后说个更根本的取舍。很多人想让 agent 在一个长任务里保持全局一致,本质是想让它有「架构师」的能力。现在这层别指望它。你自己得是那个持有全局的人:你定契约、你定目录、你定这个切片做完算什么样,模型只负责在这个框里填内容。人退不出去也没必要急着退。你把它当执行者,代码质量就稳;你把它当架构师,前面省下的时间后面全还回去。

落地顺序就三件事:先上 lint + tsc 的 Hook 门禁,这是收益最大的一步;然后把仓库约束写成百来行必读文件,配目录索引;再把长任务改成按切片拆的独立会话。这三条跑顺,屎山基本长不出来。

所属话题:Agent 工程