2026年7月29日

dream 技能 — 知识库维护

Datarim 的 dream 技能如何保持 datarim/ 目录健康——发现错放的产物、标记矛盾、去重内容并重建索引。

逐个任务增长的知识库容易发生漂移。产物被放到错误的目录。文件丢失交叉引用。两份文档最终覆盖同一主题。dream 技能负责处理这些簿记工作,防止这种积累降低未来任务的质量。

它作用于 datarim/ 目录和 documentation/archive/。它不触碰源代码。未经批准不会删除任何内容。它不创建新知识——那是写作者的职责。

三项操作

Ingest 处理新产物。它检查每个文件是否位于正确的目录、文件名中是否带有任务 ID、是否具有 frontmatter,以及是否链接到相关文档。没有匹配反思条目的归档文件,或没有匹配归档的反思,都会作为 ingest 发现项浮现。

Lint 对整个知识库运行健康检查。它查找矛盾——两份文档对同一主题做出相互冲突的陈述——并用标注标记两者,而不是静默覆盖任何一方。它还会标记没有入站引用的孤立文件、损坏的链接、超过 500 行应拆分的文档,以及归档到错误区域子目录的归档条目。所有内容都会进入按严重程度分组的 lint 报告:critical、warning、info。

Consolidate 做更深入的工作:合并重复文档、从反思中提取反复出现的模式到模式页面、重建索引,并在相关产物之间添加双向链接。合并不会自动运行——它需要显式命令。

一个具体示例

经过十个任务后,datarim/index.md 目录已经过时——它列出了六个月前的文档,却遗漏了十五个更新的产物。运行 /dr-dream index 会重建目录:datarim/ 和 documentation/archive/ 下的每个文档都会获得一条按类型分组的单行条目。重建后的索引是可导航的目录,而不是扁平的文件列表。

dream 何时运行

不带参数的 /dr-dream 会按顺序运行全部三项操作。定向变体——/dr-dream lint 和 /dr-dream index——只运行指定的操作。每完成第十个任务后,框架会建议进行一次完整维护;任何归档中若有超过五个未索引文档,它会建议重建索引。两种建议都不会在没有操作员显式命令的情况下运行。

活动会追加到 datarim/history/activity-log.md,为每次维护运行及其发现提供带日期的记录。

另请参阅 /dr-dream 命令文章了解命令级演练,以及Datarim 是什么了解全貌。