AI编程时代,团队知识为何成了孤岛

先看四个场景,对照一下你的团队情况。

你花了一下午跟Agent明确了一套架构方案。下周开新会话,Agent全忘了。重新解释项目背景、约定、踩过的坑。时间没少花,Agent没变聪明。

三个月前你认真写了一份CLAUDE.md。三个月后项目迭代了——功能加了、架构改了、约定被新约定覆盖了。CLAUDE.md还是三个月前那份。Agent按旧规范生成代码。更麻烦的是:没人知道哪些还有效。

你和一个诡异bug缠斗了二十轮,和Agent一起找到了根因。沉淀出来的隐性规则没人整理成文档。下次遇到同类问题,重头再来。

同事A跟Agent约定了一套错误处理规范,同事B不知道。Agent对两个人生成的代码风格不一致。直到code review才发现。

四个场景,同一个根源:团队的知识散落在N个人的聊天记录里。Agent每次空白开始。Agent之间从来没说过话。

现在讨论AI编程,90%的注意力在模型上——哪个更强、更便宜、上下文更长。

但就算明天Claude 5发布了,上下文一亿token,推理再翻一倍——这四个场景还是会发生。

因为问题不在"一个Agent能记住多少"。出在"多个Agent之间有没有共享记忆"。

你用Claude Code,你同事也用Claude Code。但你们各自的Claude Code是从各自的聊天记录里学习的。它们从来没见过面。

把它想成一个团队里有两个实习生——实习生A跟你开了一周会,记住了你的偏好。实习生B跟你同事开了一周会,记住了同事的偏好。两个实习生从来没交流过。你不会觉得是实习生不够聪明——你觉得是"公司没给实习生统一onboarding"。

我们现在的AI编程团队就是这样。我们叫它"Agent",但它没有团队的上下文。只有一个会话的上下文。

CLAUDE.md被当成AI编程的银弹很长时间了。zodchiii写过一篇很好的方法论——100-150条指令、五节模板、五条高影响铁律。

但真正的问题不在"怎么写",在"写了之后怎么活"。

项目启动时认真写的规范,三个月后项目演进了。没人更新它。因为更新文档不在任何人的工作流里。Agent干活的时候你不会想"等等我要先更新CLAUDE.md"——你只想让它赶紧把活干了。

于是CLAUDE.md从一个"给Agent的上下文"变成了"项目启动时的仪式感"。写完那一刻最有价值,之后每天都在贬值。

解法不是更勤奋地更新文档。解法是让文档的更新变成Agent工作流的一部分——不是人的额外工作。

我的实验方案很简单:每当Agent帮我解决了一个值得记住的问题,最后一步让它自己写一段总结,存到项目知识库里。不是让我写,是让Agent在对话结束时自己写。Agent是最清楚刚才发生了什么的人。让它写,成本趋近于零。

第三个场景最让我警觉——debug二十轮找到根因,过程极有价值,但没人整理成文档。

因为太贵了。debug完精疲力尽,还要写复盘。大多数人的选择是"我记住了,下次遇到再说"。

下次遇到的时候你已经换了新会话。Agent不知道上次你们怎么找到这个bug的。你也只记得大概方向。又花了十轮,重新踩老坑。

这不是Agent的错。是"对话里的知识没有沉淀机制"的错。

我看到的解法方向是"三层架构"——给Agent一个共享知识库,不是给人读的PRD,是给Agent读的上下文索引。

这个wiki(Writing-Factory)本身就是按这个逻辑建的。每一篇素材摘要、每一个概念定义、每一个实体页,都是为了让Agent在任何时候打开它,就拿到同一份上下文。

核心设计只有一条:Agent每次开启新会话时,不需要人重新解释"这个项目是什么"。

如果团队里每个人都能让Agent在干活之前读同一份知识库,那Agent之间"不说话"的问题就解决了一部分——它们共享了书面记忆。

不够完美。Agent之间的实时同步、隐性知识的自动提取、多人协作的冲突解决,这些都需要更复杂的系统。但在这个系统出现之前,你能做的最简单的事是:给Agent一个共享知识库。不是给人看的wiki,是给Agent读的。

我见过一些团队,每个人都在用Claude Code,效率很高。但团队整体没有因为AI变快——每个人都在单打独斗。

我也见过另一些团队,只有一两个人在用AI。但他们把每次和Agent协作中沉淀的判断、约定、教训,全都写到了一份共享文档里。新加入的人打开这份文档,Agent就知道项目规则。

后一种团队比前一种快太多了。不是因为他们用了更好的模型。是因为Agent有记忆。

未来半年,模型趋同是大概率事件。你用的和我用的,能力差距越来越小。

那时候真正拉开差距的只有一件事:谁的Agent更懂这个团队的上下文。不是更聪明——是更懂。懂的前提是有地方记、有办法更新、有人维护。不是更贵的API,是一套更好的知识管理习惯。

这篇写完我回头看了一眼这个wiki——那些互相链接的页面——突然觉得这个项目的名字应该叫"Agent的团队记忆"。改名太麻烦,先这样。如果你们团队也在做类似的事,评论区聊聊。