2026年6月17日

图书管理员 Agent——一个保持连贯的知识库

Datarim 的图书管理员 Agent 如何让 datarim/ 目录保持井然有序、交叉引用完整且没有矛盾——同时绝不改变文档的含义。

每个项目积累文档的速度都快于整理它们的速度。三个月前的一份 PRD 引用了一个后来被重命名的任务。两个反思文件用不同的措辞描述了同一条经验。一个索引页面仍然列着一个已不存在的文件。这些都不会导致构建失败,所以它们就一直留着。久而久之,知识库就变成了那种地方:你知道答案就在里面某处,但找到它比重新推导一遍还要花更长时间。

图书管理员 Agent 的存在就是为了防止这种漂移。它在 /dr-dream 下运行,其全部范围就是 datarim/ 目录——不是源代码,不是配置文件,只是项目的机构知识。

三种工作模式

摄取(Ingest)处理新增和放错位置的文件:将它们移动到正确的目录、修正命名不一致,并补充缺失的元数据。检查(Lint)是一次健康检查——它扫描没有任何链接指向的孤立文档、损坏的交叉引用、过时内容和命名不一致。整合(Consolidation)则更进一步:合并重复内容、提取反复出现的模式、构建或更新索引,并添加双向链接,使得如果文档 A 引用了 B,B 也引用 A。

图书管理员采取的每一个操作都会追加到 datarim/history/activity-log.md,因此维护历史始终可审计。

它不会做的事

图书管理员会标记矛盾——即文档之间相互冲突的说法——但不会解决它们。解决矛盾需要对哪份文档具有权威性做出判断,而这是人的决定。该 Agent 会用标注标出冲突然后停下。同样,文件绝不会被静默删除:删除是提议,而非执行,直到操作者批准。

一个实际例子

在运行了若干任务之后,图书管理员可能会报告:两个反思文件在不同标题下讨论了同一条部署经验(合并候选);一份 PRD 通过一个后来被重命名的文件名引用了一份计划文档(损坏的链接);以及索引中有四个标记为活跃的任务实际上已在两周前归档(过时条目)。报告会提出修复建议;在操作者说“开始”之前,什么都不会改变。

它的定位

图书管理员运行在 Sonnet 级模型上。组织性工作是结构化且重复性的——它不需要为架构或安全决策保留的那种更重的推理能力。该 Agent 足够轻量,可以在冲刺结束时作为例行维护环节运行,而不只是在明显出问题时才运行。

在图书管理员参考卡上查看完整的能力列表,或阅读Datarim 是什么以了解更大的图景。