aisync 统一多编程助手规则与协作记录
aisync 用本地 Git 仓库集中管理规则,通过三方合并同步,并提供哈希链活动日志、文件占用声明和会话内协作通知。文件声明依赖 Agent 主动遵守协议;日志校验能发现记录被改动,但不能证明操作真实发生。
AI 深度解读
Claude Code、Codex 和 Cursor 装在同一台机器上,规则却各存一份;多个 agent 同时干活,还可能改到同一个文件。aisync 想用一个本地中心,把共享规则、活动记录和文件占用声明串起来。
它的思路很轻:数据放进普通 git 仓库,通过原生 hooks、CLI 或 MCP 接入。值得看的不是它支持多少工具,而是它把多 agent 协作拆成了几个具体问题,同时明确了边界:能报告冲突,不等于能阻止冲突;记录可校验,也不等于操作真实发生。
一份规则,怎样交给不同的 agent
aisync 把所有数据放在 ~/.ai-sync,这个目录就是一个普通 git 仓库。核心设计不绑定某个 agent,目前为 Claude Code、Codex 和 Cursor 提供原生 hooks,其他 agent 可以通过 CLI、MCP server 或共享指令文件使用同一个中心。
其中最直接的用途,是减少规则的重复维护。规则写一次,再同步到各个工具;同步使用三方合并(3-way merge),结合共同基础版本和两边的修改处理差异。
这比简单覆盖多考虑了一步:不同工具侧的规则可能都发生过变化。但原文没有说明,出现无法自动合并的冲突时由谁处理,也没有交代各工具指令格式的适配细节。不能仅凭「共享规则」就认定所有规则都能无损通用。
安装命令只有一行:
pip install aisync-cli
要注意,安装包名是 aisync-cli。运行需要 Python 3.11 或更新版本,项目采用 MIT 许可证,且没有运行时依赖。
多个 agent 同时改代码,靠什么减少冲突
aisync 用文件声明(file claims)协调编辑:agent 动手前,先声明自己准备修改哪些文件。如果声明与其他 agent 重叠,工具会报告冲突,并返回退出码 3。
例如,一个 agent 准备修改组件,另一个也要碰同一个文件,声明流程就能提前暴露重叠,给后续调度留下处理机会。
文件声明是协作协议,能否避开冲突取决于 agent 是否遵守它。
它不是操作系统级文件锁。没有接入声明流程的 agent,或者绕过流程的编辑动作,仍然可能修改文件。原文也没有说,返回退出码 3 后,所有接入工具都会自动停止或重新安排任务。
另一个补充是会话中通知:在 hooks 可用的地方,agent 工作期间可以得知其他 agent 做了什么。这有助于减少信息滞后,但覆盖范围取决于 hooks 是否可用,不能默认所有接入方式都有相同体验。
我的判断
我认同它把规则一致性、编辑冲突和活动追踪放到同一个本地中心处理。这三个问题经常一起出现,只统一指令文件,解决不了谁正在改什么;只保留 git 提交,也未必能表达 agent 在会话中的活动。
活动追踪采用哈希链日志:记录通过哈希串联,可以运行 aisync verify 检查链是否被修改。它回答的是「已记录的事件有没有变化」,而不是「记录里的操作是否真的发生」。原文明确承认了这个区别。
日志通过校验,不能作为操作真实发生的证明。
取舍也很清楚。相比只维护共享指令文件,aisync 增加了协调和记录能力,也增加了接入协议的成本。相比用独立工作目录隔离修改,文件声明更依赖参与者配合,两者解决冲突的方式不同。
原文没有给出冲突减少比例、同步成功率、性能测试或真实团队案例。因此,这更像一份功能说明,还不足以证明它已经改善了多 agent 开发效率。是否适合采用,首先要看常用工具能否稳定走完声明、检查和记录流程。
能拿来做什么
- 如果你同时使用 Claude Code、Codex 和 Cursor,可以先选一条通用项目规则,验证它经过同步和修改后能否保持一致,再决定是否迁移更多规则。
- 如果你让多个 agent 并行修改前端或 Node 项目,可以先在容易重叠的文件上试用声明流程,重点检查退出码
3是否会让实际编辑暂停。 - 如果你需要回看 agent 的工作过程,可以检查活动日志并运行
aisync verify,同时用代码差异和测试结果核对任务是否完成。