乐于分享
好东西不私藏

AI代码开发工具处理多项目多分支协同的问题

AI代码开发工具处理多项目多分支协同的问题

核心问题与解决思路

AI会话的最大痛点是上下文断裂——每次新会话都像失忆一样。在多项目、多分支场景下,这个问题被放大:Agent A在分支feature-x完成的工作,Agent B在分支feature-y完全不知道,导致重复劳动、决策冲突。

解决思路可以归纳为三个层面:

层面
解决的问题
代表工具/方法
会话记忆
同一项目跨会话的上下文连续性
crossmem、Tocket Memory Bank
并行隔离
多分支/多任务互不干扰
Codex worktree、Trellis
编排协同
多Agent分工与交接
Gastown、Thenvoi Mesh

方案一:轻量级——文件化的”记忆银行”

核心思想:在仓库中创建.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并触发恢复

工作流大致是:

  1. 告诉Mayor你要做什么

  2. Mayor创建Convoy(工作单元)并分配给Polecats

  3. Polecats在Hooks(持久存储)中记录状态

  4. 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
文件化记忆银行
极低(5分钟)
任何项目,想先试试
crossmem
跨项目自动记忆
低(5分钟)
多项目切换频繁
Trellis
规范+worktree+记忆
中(1小时)
需要并行任务
Gastown
完整Agent编排
高(半天)
10+ Agent、企业级
Thenvoi
跨组织Agent网格
多团队/跨公司协作

个人建议:从Tocket + crossmem开始,这是成本最低、见效最快的方式。等遇到并行瓶颈时,再加入Trellis的worktree支持。只有在Agent数量真正超过10个、需要自动化编排时,才需要考虑Gastown这类重型方案。