第 5 章 协同：让系统不依赖“唯一懂的人”

项目走到团队阶段，会出现一个看似无关技术、却最致命的问题： 这个系统是“我们在用”，还是“某一个人替我们用”？

如果答案是后者，那么系统再先进，也只是个人能力的放大器，不是团队能力的放大器。

费曼式协作的第一原则是：任何关键过程都要能被第二个人讲清楚。 这不是礼貌要求，而是工程生存条件。

在 EvoScientist 里，你可以把这件事落到非常具体的层面。 比如你们团队内部对“成功”到底怎么定义？是看最终回复语气很好，还是看工具层状态真的闭环？“可复现”是口头说“我这边也差不多”，还是同配置可重放？“人工确认”是不是必须留下 ask_user 的触发与回答记录？术语一旦悬空，协作马上变成鸡同鸭讲。

第二个动作是把分歧前置到配置。谁可以自动执行命令、哪些命令白名单放行、MCP 工具暴露给哪些 sub-agent，这些都能在系统里落成开关。把它们写进配置，就把“人和人争论”变成“规则与规则对齐”。

第三个动作是重新看待失败。失败不是丢人的事故，而是团队的训练数据。ToolErrorHandlerMiddleware 已经把错误结构化，ChannelManager 也有健康状态与失败计数。你们要做的是把“失败类型 -> 恢复动作 -> 复盘结论”沉淀下来，让同类问题第二次出现时不再从零开始。

第四个动作是让多入口协同。CLI 是深操作台，消息渠道是协同表面。ChannelManager 的路由、探活、排空机制，本质上是在保证“执行层”和“沟通层”同步，不会出现“群里说好了，系统里没跑完”的断层。

最后，用三个费曼问题收口每次重要评审：我们让系统做了什么？为什么它这么做？换一个人值班，能否复现并接着跑？只要这三问长期成立，团队就真的接管了系统。

当你走到这里，EvoScientist 对你们不再是一个会聊天的工具，而是一套能穿越人员变化的工作方法。那才是真正的“从入门到精通”。