用文件认领机制拦截多 Agent 编辑冲突
aisync 允许编码 Agent 在修改前声明文件占用,其他 Agent 认领相同文件时会收到退出码 3。示例展示 Claude Code 与 Codex 的冲突检测,可通过脚本或钩子在编辑前停止操作。
原文暂未完整获取,基于公开信息的快读
Claude Code 和 Codex 在同一仓库里改代码,可能同时重写一个文件,直到改动被覆盖才暴露问题。aisync 提供了一套文件认领机制:Agent 编辑前先声明要修改哪些文件,遇到已有认领就返回退出码 3,让脚本或钩子有机会在写入前拦住冲突。
目前能确认什么
作者在临时环境中演示了这个流程:Claude Code 先认领 app/payments/refunds.py,Codex 再认领同一文件时被拒绝;Claude Code 释放认领后,Codex 再次申请成功。
被拒绝的申请也会留下记录,先占用文件的 Agent 可以看到有人等待。认领带有过期时间,作者这次实验中约为两小时,不能据此认定所有配置都固定如此。
认领是协作约定,不是操作系统文件锁。
没有调用 aisync claim 的 Agent 仍然可以编辑文件。退出码只是供调用方判断结果的信号,需要脚本或钩子收到后停止编辑,拦截才成立。原文节选称 Claude Code、Codex 和 Cursor 已有原生钩子,其他 Agent 需要自行调用 CLI 或 MCP server。
aisync 还会记录认领、释放等事件,并通过哈希链检查记录是否被修改或删除;它不能证明 Agent 声称执行的动作确实发生。
我的判断
对同时开多个编码 Agent 的程序员,这种机制的价值很具体:把同一文件的争用提前暴露,减少写完之后才排查覆盖的麻烦。
我会先关注编辑入口是否都经过认领检查。只在指令文件里写一句规则,无法保证执行;即便接入钩子,也要确认冲突返回后确实停止写入。
目前节选没有交代钩子的安装配置、认领过期后仍在编辑如何处理。这些会直接影响拦截是否可靠,需要完整原文或官方文档确认。另外,文件认领也无法识别两个不同文件之间的业务逻辑冲突,代码审查仍然需要保留。