/dr-optimize 命令 — 审计 Datarim 框架
/dr-optimize 如何检测 Datarim 技能、代理和命令中的臃肿、未使用组件、重复覆盖和失效引用——随后在明确的审批关卡下提出并应用修复。
一个缺乏定期审查而不断扩张的框架,会像任何代码库一样出现同样的问题:未使用的组件、重叠的指令、过时的引用,以及不再与实际文件功能相符的描述。/dr-optimize 将同样的结构化审计纪律带入 Datarim 框架本身。
Optimizer 代理负责执行这项工作。它覆盖技能、代理、命令和模板——构建完整清单、映射依赖图、按类别检测问题,并在做出任何更改之前提出可执行的建议。
何时运行
建议的节奏是每完成五到十个任务后运行一次,或者当 /dr-help 的输出开始让人感到不堪重负时运行。在 /dr-addskill 之后立即运行,可以检查新组件是否与已存在的组件重叠。当反思健康检查检测到框架效率低下时,/dr-archive 的 Step 0.5 也会自动建议运行此命令。
审计
该命令会为每种组件类型构建完整的清单表:名称、行数、描述,以及由什么加载它。基于该清单,它会映射所有交叉引用——哪个命令加载哪个代理、哪个代理加载哪些技能、哪些技能相互引用。未被引用的组件会作为孤儿浮现出来。
问题检测器应用具体的阈值:超过三百行的技能会触发警告;超过四百行则建议拆分。超过一百二十行的代理会被标记;超过一百八十行则建议重写。任何两个内容重叠超过百分之七十的组件都是合并候选。超过一百六十个字符的描述会被标记为需要精简,因为过长的描述会降低技能触发的可靠性。
Datarim 状态卫生
除了框架文件之外,审计还会检查运行状态。如果某个任务 ID 同时出现在 tasks.md 的 Active Tasks 和 Archived Tasks 部分中,会自动提出移除建议——这能捕获在清理步骤存在之前运行的归档操作。同样的检查也会针对 activeContext.md 运行,以发现仍被列为活跃的已归档任务。
建议与审批关卡
每个检测到的问题都会变成一个编号建议:prune、merge、split、fix-description、fix-references 或 sync-docs。命令会呈现完整列表并询问要应用哪些。回答必须明确——全部、无,或用逗号分隔的编号。没有明确回答就不会做任何更改。
对于任何针对框架运行时(${DATARIM_RUNTIME}/{skills,agents,commands,templates}/)的更改,在写入之前会对每个建议的文本运行一个与技术栈无关的关卡。特定于技术栈的内容——对特定框架、语言或工具的引用——无法通过该关卡。该建议会被退回给操作者,要求重新措辞或改为迁移到项目范围内的目录。
在 Optimizer 代理文章中了解执行这项工作的代理,或从什么是 Datarim开始了解背景。