文件锁冲突会让部分编程智能体停工
Lanes 用文件租约防止多个编程智能体同时写入同一文件。在 Claude Code 搭配 Haiku 的 13 次写入拒绝测试中,9 次重试成功,4 次停止并报告冲突,促使作者移除直接拒绝写入的设计。
AI 深度解读
多 Agent 协作时,文件被占用就拒绝编辑,看起来很合理。Lanes 的作者却发现:拒绝虽然防住了覆盖,也会让 Agent 停下来找用户,甚至靠放弃任务制造出「没有冲突」的假象。
他们最终选择先排队等待,协调失效时允许继续,再用备份和重放恢复冲突。这篇值得读的地方,是把工具设计的评价标准从「有没有挡住错误」,推进到「工作有没有完成,人有没有被迫接管」。
拒绝编辑为什么会把协调问题推给用户
Lanes 在 Agent 编辑文件前发放租约(lease),用于避免两个 Agent 同时写同一文件。第一版采用直接拒绝的方式:编辑前的 hook 向服务器申请租约,如果文件已被占用,就告诉 Agent 稍后重试。
作者用 Claude Code、Haiku 测试了 13 次被拒绝的编辑。13 次都遵守了限制,没有通过 shell 绕过,没有使用 sed、echo > 或其他 Bash 命令,也没有覆盖队友的工作。
单看保护效果,这套机制成功了。但后续行为分成两组:9 次等待、重试后完成,4 次停止并告诉用户文件被其他 Agent 占用,占比 31%。
问题就在这 4 次。用户原本只想实现功能,现在却要理解另一个 Agent 的状态,再决定是否重新发起任务。协调工具把内部调度变成了人工中断。
更隐蔽的是,有些测试没有发生预期冲突,原因却是被拒绝的 Agent 已经放弃工作。如果只统计冲突次数,这类结果很容易被算成成功。
没有发生覆盖,不等于任务已经完成。
第二版把拒绝改成服务器上的先到先服务队列。等待期间,Claude Code 显示「Lanes: coordinating with teammates…」;租约释放后,hook 先同步文件,再让 Agent 编辑最新版本。
租约粒度也经历了一次调整。最初一份租约覆盖 Agent 的整个回合,排队可能长达数分钟,还可能出现双方各持一个文件、互相等待的情况。后来改为一次编辑一份租约,编辑提交并发布后立即释放,典型等待约为一秒。
协调服务故障后,为什么还允许继续编辑
排队版本仍然有三个拒绝入口:等待超过 90 秒、自动同步失败、Lanes 服务器不可达。最后一种采用的是 fail closed,即协调失效就禁止编辑。
ADR-0019 移除了这三类拒绝。原文没有逐项展开新的处理细节,但明确说明:每次放行都会记录在团队视图中,不会出现在 Agent 的对话里。
这相当于采用 fail open:协调不可用时,工作仍然可以继续。代价也很明确,服务器故障期间,两个 Agent 可能同时修改同一文件。
作者接受这个风险,依赖的是后续恢复机制。首先,本地服务器未运行时,hook 会自行启动它,减少实际不可用的情况。其次,协调关闭期间发生重叠编辑后,文件会切到较新的共享版本,当前 Agent 自己的版本保存在 refs/lanes/backup/… 备份引用中,再只通知这个 Agent 重新应用自己的修改。
作者专门测试了所有人都无法使用服务器、4 个 Agent 修改相同行的场景。过程中发生 5 次重新应用,均由 Agent 完成,12/12 个任务完成,没有丢失工作。
这里的关键前提是可恢复。允许并发写入,必须有地方找回各自的修改,并且能把恢复责任交给具体的 Agent。单独取消限制,得不到同样的结果。
提示文案也会决定 Agent 是否停工
机制改完后,作者还处理了另一类中断来源:工具消息的措辞。
Lanes 面向 Agent 的提示只解释发生了什么、下一步做什么,避免使用「stop」或「tell the user」。作者的观察是,这些表达会促使 Agent 把内部事件上报给人。
自动提交就是一个例子。Lanes 会为每次编辑自动创建 commit。在一个要求 Agent 完成任务后检查 git log 的场景中,没有解释时,8/8 个 Agent 都把这些提交归因于「另一个会话」或「其他人」。会话开始时增加一句说明,告知这些提交属于 Agent 自己,误判变成了 0/8。
同步提示也有类似影响。一个 Agent 收到队友修改后,要求用户检查内容是否符合预期。作者于是明确说明,新内容由系统自动协调,无需额外检查。重跑结果为 18/18 个任务完成,0 次询问。
整个基准中,排队且不拒绝编辑的方案有 216 个会话,只有 1 个停下来询问用户,约 0.5%;拒绝方案则是 4/13,约 31%。作者明确承认,两组场景不同,只能看作方向性信号,不能当成精确对照。
Lanes 仍保留一次必要的复查:开启团队上下文后,如果 Agent 读过或导入的文件在回合中发生变化,结束前会被要求重新检查,每回合最多触发一次。它没有把所有检查都取消。
我的判断
我认同作者把「用户被打断多少次」纳入评价。对日常 AI 编程工具来说,锁是否正确只是局部指标;任务是否做完、是否需要用户重新发提示,才直接影响使用体验。
但这篇不能证明 fail open 适合所有协作系统。13 次拒绝样本很少,216 个会话又没有使用相同场景作对照。故障实验能说明他们测试的恢复路径走通了,不能证明所有修改组合都能自动恢复。保住代码,也不等于合并后的业务逻辑正确。
和直接拒绝相比,排队减少了 Agent 自己决定是否重试的负担;和粗粒度锁相比,单次编辑租约缩短了占用时间。但它解决的是文件写入协调,多个文件之间的逻辑一致性仍然需要验证。
提示里写「无需检查」也有边界。系统可以替 Agent 承担同步确认,却不能因此跳过功能验证。原文保留回合结束前的复查,正好体现了这种区别。
能拿来做什么
- 如果你在给 Claude Code 或其他编码 Agent 写 hook,可以把可自动解决的文件占用交给队列,并在放行前同步最新内容,减少 Agent 自己反复重试的负担。
- 如果准备让协调故障时继续编辑,先实现修改备份、冲突归属和重新应用流程,再用多个 Agent 修改相同行的故障场景验证恢复能力。
- 检查自动提交、文件同步等工具提示,明确交代变更来源与下一步动作,减少 Agent 把系统行为误认成外部修改。
- 评估多 Agent 工作流时,同时记录任务完成率、恢复次数和用户询问次数。Lanes 以 Apache-2.0 开源,原文称相关运行记录在仓库中,设计决策位于
docs/design.md,可以据此检查其结论的适用范围。