weiyi
项目MewCode

多 Agent、Mailbox 与 Worktree

将并行任务拆分、消息传递、任务状态和代码隔离分别落实,理解协作带来的收益与协调成本。

复杂代码任务可以拆成界面、接口和验证等相对独立的部分,但多启动几个模型并不会自然形成协作。MewCode 需要解决谁负责什么、如何同步结果、代码在哪里修改以及由谁合并。

两种派生任务形式

一次性 Subagent 接受一个子任务并返回结果,适合有明确输入输出的短任务。Team 中的成员拥有独立会话,可以持续接收任务和消息,适合需要多轮协调的工作。

Team、Member 和模型状态负责生命周期管理。模型通过提示和 SendMessage 等工具进行实际协调,任务列表记录分工与状态。任务状态本身不等于消息投递,也不一定会自动唤醒成员。

Mailbox 怎样交付消息

笔记中的 Mailbox 使用文件存储消息,并以约 500 毫秒周期轮询。运行中的成员通常在轮次边界读取消息并注入上下文,因此发送成功不表示对方立即中断当前工具执行。

文件消息需要处理重复读取、消费位置与并发写入。调度方也应区分成员空闲、任务成功、任务失败和等待输入。成员进入 idle 只能说明当前没有继续执行,不能替代结构化的完成结果。

外部终端与进程内成员

tmux、iTerm 等外部运行方式与进程内成员的启动、通信和工具集合有所不同。对某一种运行器验证成功,不能自动推导所有运行器都有相同能力。排查协作失败时,应先确认实际使用的运行方式和成员可用工具。

Worktree 隔离了哪些东西

Git Worktree 共享仓库对象,为成员提供独立分支、索引和工作目录。它能避免两个成员直接改写同一份未提交文件,并让 Lead 分别审查差异。

数据库、网络端口、外部服务和系统依赖仍然共享。两个成员启动同端口服务会冲突,修改同一测试库也会相互影响。需要额外分配端口、测试资源与文件所有权,不能把 Worktree 当成完整运行环境隔离。

Lead 如何收敛结果

Lead 先划定任务边界和接口,再让成员在各自目录实现。成员返回提交、变更说明、验证结果和剩余问题;Lead 阅读 diff、解决冲突并进行集成测试。

Git 能检测部分文本冲突,但两个模块即使没有修改同一行,也可能在字段含义或调用约定上冲突。接口契约与最终集成验证承担语义一致性的责任。清理工作区时也应检查未提交改动和未推送提交,无法确认安全时保留现场。

验证现状与使用取舍

笔记记录过 Team 检测测试失败,以及 macOS /var 与 /private/var 路径别名造成的 Worktree 测试问题。本次整理没有重新运行这些测试,因此不将多 Agent 功能描述为全部验证通过。

协作适合可独立推进、接口稳定的任务。任务强依赖、需要频繁改同一模块时,消息轮次、Token 成本和合并工作可能抵消并行收益。面试应说明如何划分文件责任、如何识别完成状态以及最终由谁验证,而不只展示成员数量。

本文整理依据

内容依据项目复习材料整理,本次发布没有重新审计源码或复跑历史实验。相同主题按专项笔记和较新复盘统一,原始笔记保留在本机。

  • Co Coder/MewCode_Multi-Agent实现机制复习笔记.md
  • Co Coder/code-golang简历题分析.md
  • Co Coder/MewCode_项目面试题与答案.md