第 1 周 · D4🔒 锁定约 4 小时
文件编辑与 shell 执行:精确替换、冲突检测与超时可杀的子进程
把读权限升级成写权限:实现基于精确替换的编辑工具与能跑命令的 shell 工具,处理旧内容不匹配、文件被外部改动、命令卡死与输出过大四种真实故障,然后让 Agent 第一次把失败的测试修绿。
今日目标
- 能说清精确替换与补丁式编辑各自的失败模式,并选出适合模型的那一种
- 能实现带冲突检测的编辑工具,让并发或外部改动不会被悄悄覆盖
- 能实现一个可超时、可杀死、输出有上限的命令执行工具
今天是 mca 第一次真的改你的代码。读完回到页面顶部把三条目标勾掉。
小白版讲解
再给写权限:风险一下变了一个量级
昨天那个新人拿到了读权限。今天你要给他提交权限——但在按下那个按钮之前,你的心态和昨天完全不一样了。
差别不在他的能力,而在可逆性。昨天他读错一个文件,代价是浪费五分钟;今天他改错一个文件,代价可能是把别人半天的工作覆盖掉。而且写操作的错误有一个很讨厌的性质:它经常是静默的。读错了他自己会发现「这不是我要找的东西」;改错了,程序照样跑,测试照样绿,问题在两周后才浮出来。
给 Agent 加写工具,风险比给新人还高三分,因为它有三个新人没有的特点:
- 它没有「我不太确定,先问一下」的本能。 你给它一个编辑工具,它就会用;它对自己记错原文这件事毫无察觉。
- 它一次能改很多处。 新人改错一个文件,Agent 在一轮里能改五个。
- 它的输入是猜出来的。 它写进
old_string的那段代码,来自几轮之前read_file的结果——那份内容可能已经过期了。
所以今天的重点不是「怎么把字写进文件」,那是一行 writeFile。今天的重点是三种失败模式,以及每一种该怎么让它失败得足够响:原文对不上、原文不唯一、命令卡死不返回。这三件事处理不好,你会得到一个「看起来能用、偶尔悄悄改坏东西」的工具——这是 Coding Agent 里最糟的一类 bug,因为它不会报错。
那具体该给它什么形状的写工具?三种主流做法各有各的翻车方式,先把它们摊开比一比。
面试题库
让模型改文件,你会选整文件重写、精确替换还是补丁?为什么?To let a model edit files, do you pick whole-file rewrite, exact string replacement, or patches? Why?
国内高频海外高频基础#file-editing#tool-design🔒 解锁本章后查看答题要点。
编辑工具怎么做冲突检测?检测失败时该给模型什么信息?How does an edit tool detect conflicts, and what should it tell the model when detection fails?
国内高频海外高频进阶#file-editing#conflict-detection🔒 解锁本章后查看答题要点。
在 Agent 里执行任意 shell 命令,你会加哪些约束?超时之后怎么真正把它杀掉?What constraints do you put on running arbitrary shell commands from an agent, and how do you actually kill one after a timeout?
国内高频海外高频深入#shell-execution#process-management🔒 解锁本章后查看答题要点。
