命令 Manage

/dr-optimize

审计并优化 Datarim 框架

概述

/dr-optimize 审计整个 Datarim 框架——技能、智能体、命令、模板——并识别问题:未使用的组件、重复项、超大文件、失效引用以及过时的文档计数。它会生成一份报告,其中的提案按风险排序,并且只应用你批准的更改。

用法

/dr-optimize
/dr-optimize project
/dr-optimize framework

运行时机

  • 每完成 5-10 个任务后
  • 在 /dr-addskill 之后,检查是否与现有技能重叠
  • 当技能不再被触发,或 Claude 似乎忘记了指令时
  • 当 /dr-archive 的步骤 0.5(反思)建议执行时

工作方式

  1. 确定范围——已初始化项目的客户端发现目录(.agents/、.claude/、.cursor/)和 .datarim-runtime/,并单独报告归属;或者,对于显式的框架审计,使用 Datarim 源仓库(更改以拉取请求形式提出)。不支持全局范围。
  2. 完整清单——构建所有技能、智能体、命令和模板的完整表格,包含文件大小、描述和交叉引用。
  3. 依赖图——将命令映射到智能体、智能体映射到技能、技能映射到技能。识别孤立组件。
  4. 问题检测——检查:未使用的技能/智能体、超大文件(技能:超过 300 行警告,超过 400 行拆分;智能体:超过 120 行警告,超过 180 行拆分)、重复覆盖(重叠超过 70%)、过时描述、失效引用、文档计数不匹配、描述预算违规、选择性加载候选以及 Diátaxis 文档漂移(软警告)。
  5. 报告——呈现发现结果,包括框架健康状态(良好、需要关注、臃肿)、按严重程度分类的问题计数,以及按风险从低到高排序的提案。
  6. 审批关卡——询问要应用哪些提案(全部、无或特定编号)。仅应用已批准的更改。
  7. 同步文档——用正确的组件计数和表格更新 AGENTS.md、README.md 和 dr-help.md,并在 datarim/history/evolution-log.md 中记录更改。

参数

可选。project(默认:已初始化的项目)或 framework,用于对 Datarim 源仓库进行显式审计。不支持全局/用户范围。

输出

完整的审计报告,包含依赖图、优化提案、已应用更改摘要和更新后的文档。

示例会话

> /dr-optimize

=== 优化报告 ===

框架健康状态:需要关注
组件:19 个智能体、81 个技能、31 个命令、32 个 Markdown 模板及配套资源
总行数:4,250
描述预算:5,200 / 8,000 字符(65%)

发现问题:4
  1. [低] 未使用的技能:legacy-deploy.md(无智能体引用)
  2. [低] 过时描述:security.md(内容已偏离)
  3. [中] 重复覆盖:testing.md 和 qa.md(重叠 72%)
  4. [中] 文档计数不匹配:README 显示 60 个技能,磁盘上有 67 个

提案:
  1. prune-skill:移除 legacy-deploy.md
  2. fix-description:更新 security.md 描述
  3. merge-skills:将 testing.md 合并到 qa.md
  4. sync-docs:更新 AGENTS.md 计数

应应用哪些提案?(全部 / 无 / 1,2,4)

相关命令

报告结果

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