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