AI代码开发工具处理多项目多分支协同的问题
核心问题与解决思路
AI会话的最大痛点是上下文断裂——每次新会话都像失忆一样。在多项目、多分支场景下,这个问题被放大:Agent A在分支feature-x完成的工作,Agent B在分支feature-y完全不知道,导致重复劳动、决策冲突。
解决思路可以归纳为三个层面:
|
|
|
|
|---|---|---|
| 会话记忆 |
|
|
| 并行隔离 |
|
|
| 编排协同 |
|
|
方案一:轻量级——文件化的”记忆银行”
核心思想:在仓库中创建.context/目录,用Markdown文件存储项目状态,任何能读文件的AI都能继承上下文。
your-project/.context/activeContext.md # 当前正在做什么systemPatterns.md # 代码组织方式techContext.md # 技术栈productContext.md # 产品目标progress.md # 进度跟踪TOCKET.md # 协议规则
优势:零依赖、工具无关、可提交Git。只需告诉AI”先读.context/activeContext.md”,它就能知道之前发生了什么。
配合crossmem使用:crossmem更进一步,能跨项目自动召回记忆——你在项目A积累的模式,项目B的AI会话启动时会被自动注入。
适用场景:个人开发者、小团队、不想引入复杂工具链。
方案二:中等——Worktree隔离 + 结构化规范
核心思想:每个任务/Agent在独立的git worktree中工作,互不干扰;同时用规范文件(specs)统一项目约定。
Trellis的方案比较完整:
.trellis/├── spec/ # 编码规范、架构约定(一次定义,AI自动注入)├── tasks/ # 任务PRD、实现上下文├── workspace/ # 个人日志,跨会话连续性└── workflow.md # 共享流程规则
配合git worktree,可以在不污染主分支的情况下并行跑多个任务:
# 每个任务一个独立worktreegit worktree add ../project-feature-x feature-xgit worktree add ../project-bugfix-y bugfix-y# 两个AI可以同时在各自的worktree里工作
Codex App也采用类似思路——每个Agent在独立的worktree中运行,10个Agent并行工作互不干扰。
适用场景:需要并行处理多个任务、团队有一定规模。
方案三:企业级——Agent编排与协同层
当Agent数量增加到10个以上,手动协调变得不可能,需要专门的编排系统。
Gastown是这方面比较成熟的方案:
-
The Mayor:主协调Agent,你只需告诉它目标
-
Polecats:工作Agent,有持久身份但会话是临时的
-
Refinery:合并队列处理器,批量处理合并请求并运行验证
-
Witness/Deacon/Dogs:三层监控系统,检测卡住的Agent并触发恢复
工作流大致是:
-
告诉Mayor你要做什么
-
Mayor创建Convoy(工作单元)并分配给Polecats
-
Polecats在Hooks(持久存储)中记录状态
-
Refinery处理合并,失败的任务自动重新分发
Thenvoi则提供跨组织边界的Agent协同层(Agentic Mesh),支持不同框架的Agent互相发现和通信。
适用场景:大型项目、20+ Agent并行、需要跨团队/跨组织协作。
实操建议:从今天开始可以怎么做
不需要一步到位,建议按这个路径渐进采用:
第1步:建立文件化记忆(今天就能做)
在你的仓库根目录创建.context/文件夹,放入activeContext.md,写上当前正在做的功能、最近改动、待解决问题。然后告诉AI:”每次会话开始时,读取.context/activeContext.md了解项目状态”。
第2步:启用跨会话记忆(5分钟)
pip install crossmemcrossmem setup
之后所有AI会话都会自动获得跨项目、跨会话的记忆注入。
第3步:引入worktree并行(1小时)
npm install -g @mindfoldhq/trellistrellis init -u your-name
让AI在独立worktree中工作,主分支保持干净。
第4步:按需引入编排层
当Agent数量超过5个、开始出现协调问题时,考虑引入Gastown或类似方案。
工具选择速查表
|
|
|
|
|
|---|---|---|---|
| Tocket |
|
|
|
| crossmem |
|
|
|
| Trellis |
|
|
|
| Gastown |
|
|
|
| Thenvoi |
|
|
|
个人建议:从Tocket + crossmem开始,这是成本最低、见效最快的方式。等遇到并行瓶颈时,再加入Trellis的worktree支持。只有在Agent数量真正超过10个、需要自动化编排时,才需要考虑Gastown这类重型方案。
夜雨聆风