/dr-dream 命令 — 知识库维护
/dr-dream 如何组织、去重并交叉引用 datarim/ 知识库——以三种模式运行清单、lint、整合与索引重建。
每个项目都会随时间积累文档:PRD、计划、反思、归档。在完成足够多的任务后,这些文件之间的关系会变得模糊。某个决定在反思中做出,却从未从相关 PRD 中链接过去。两份规划文档重叠了百分之七十。某个目录空空如也。/dr-dream 正是用来处理这种漂移的。
这个名字遵循一个生物学类比:正如睡眠巩固记忆,Dream 巩固知识。工作发生在 datarim/ 目录和 documentation/archive/ 中——不是源代码,不是配置文件,只是项目的制度性知识。由 Librarian agent 执行。
三种模式
不带参数运行 /dr-dream 会触发完整维护:清单、lint、整合提案和索引重建——大约两到五分钟。/dr-dream lint 仅运行健康检查,不做任何更改,约一分钟。/dr-dream index 单独重建 datarim/index.md,耗时三十秒。
建议的频率是每完成十到十五个任务,或在任何创建了超过五个新文档的 /dr-archive 运行之后。
完整检查会检查什么
清单步骤会扫描两个目录中的每个 .md 文件,记录路径、大小、frontmatter 字段以及入站和出站链接。lint 步骤会查找文档之间的矛盾、对已完成任务却仍标记为活跃的过时引用、没有入站链接的孤立文件、重叠超过百分之七十阈值的重复内容、损坏的交叉引用对称性,以及超过五百行的超大文件。
接下来是整合提案——合并候选、交叉引用补充、frontmatter 缺失、位置错误的文件、命名不一致。这些都不会自动应用。命令会呈现列表,并在触碰任何内容之前等待明确批准。
索引
每次完整检查或 /dr-dream index 运行都会重写 datarim/index.md。索引按类型编目所有文档,在可用时按 frontmatter 标签分组,列出近期活动,并显示知识图谱指标:文档总数、连接数和孤立数。它是导航已积累的项目知识而无需搜索单个文件的入口点。
日志与后续步骤
每次运行后,维护摘要会追加到 datarim/history/activity-log.md。如果检查发现框架漂移——各技能之间的指令已变得不一致——建议的下一步是 /dr-optimize,它在框架层面而非知识库层面处理结构性问题。
查看 Datarim 是什么 了解更全面的图景,或阅读关于驱动此命令的 Librarian agent 的内容。