命令 Manage

/dr-dream

知识库维护、整理与整合

概述

/dr-dream 是知识库维护——如同睡眠对大脑记忆的巩固。图书管理员智能体会扫描整个 datarim/ 目录,识别结构性问题,在文档之间建立交叉引用,标记矛盾之处,并提出整合方案。它支持三种模式:完整维护、仅检查、索引重建。

用法

/dr-dream
/dr-dream lint
/dr-dream index

模式

  • /dr-dream(完整)—— 入库检查、检查、构建索引、整合提案。耗时 2-5 分钟。
  • /dr-dream lint —— 仅健康检查,不做任何更改。约 1 分钟。
  • /dr-dream index —— 仅重建 datarim/index.md。约 30 秒。

工作内容

  1. 清点 —— 递归扫描 datarim/ 和 documentation/archive/ 中的所有 .md 文件(归档也是知识库的一部分)。记录路径、大小、frontmatter、目录以及入站/出站链接。
  2. 入库检查 —— 发现目录位置错误的文件、文件名缺少任务 ID、缺少 frontmatter、内部链接损坏以及命名不一致。
  3. 检查 —— 检测文档之间的矛盾、过时引用(已完成任务仍标记为活跃)、孤立文件(无入站链接)、重复文件(重叠超过 70%)、损坏的交叉引用、空目录、超大文件,以及 backlog.md 中仍保留的已完成待办条目(prune-backlog-terminal.sh --check)。
  4. 构建索引 —— 创建或更新 datarim/index.md,按类型编目所有文档,按标签分组,并包含近期活动和知识图谱指标。
  5. 整合(完整模式)—— 提出结构性改进:合并重复内容、将反复出现的主题提炼为模式文档、归档过时内容、添加双向交叉引用、补全缺失的 frontmatter,并修正命名规范。
  6. 报告并应用 —— 呈现 Dream Report,包含健康状态、问题数量和提案。在应用任何更改之前等待批准。

运行时机

  • 在大量任务之后 —— 当 datarim/ 变得杂乱无章时
  • 在 /dr-archive 之后 —— 如果自上次 dream 以来创建了超过 5 个文档,会自动建议运行
  • 在新项目阶段开始之前
  • 每完成 10-15 个任务作为例行维护

示例会话

> /dr-dream

=== 知识库清点 ===
文档总数:42
按类型:PRD:5,任务:3,反思:8,QA:4,归档:15,其他:7
含 frontmatter:35/42(83%)
孤立文件(无入站链接):4

=== 检查 ===
  发现 1 处矛盾
  4 个孤立文件
  2 个损坏链接
  1 对重复文件(重叠 72%)

=== 整合提案 ===
1. [合并] 合并 reflection-API-NNNN.md 和 reflection-API-MMMM.md
2. [归档] 将 3 个已完成任务文档移至 archive/
3. [交叉引用] 添加 6 个双向链接
4. [frontmatter] 为 7 个文档添加元数据
5. [重命名] 修正 2 个文件的命名

应应用哪些提案?(all / none / 1,3,4)

相关命令

  • /dr-archive —— 归档后可能建议运行 /dr-dream
  • /dr-optimize —— 优化框架本身,而非知识库
  • /dr-init —— 清理后开始下一个任务

报告结果

在面向人工的更新或结果之前,应用 Human Outcome Reporting。说明用户可见的结果、原始条件、检查与证据,以及未解决的限制。阶段结果并不意味着整个任务已完成。保持精确的协议和技术记录完整。如需在不继续工作的情况下再次解释,请使用 /dr-explain。