命令
Manage
/dr-optimize
审计并优化 Datarim 框架
概述
/dr-optimize 审计整个 Datarim 框架——技能、智能体、命令、模板——并识别问题:未使用的组件、重复项、超大文件、失效引用以及过时的文档计数。它会生成一份报告,其中的提案按风险排序,并且只应用你批准的更改。
用法
/dr-optimize
/dr-optimize project
/dr-optimize framework
运行时机
- 每完成 5-10 个任务后
- 在 /dr-addskill 之后,检查是否与现有技能重叠
- 当技能不再被触发,或 Claude 似乎忘记了指令时
- 当 /dr-archive 的步骤 0.5(反思)建议执行时
工作方式
- 确定范围——已初始化项目的客户端发现目录(
.agents/、.claude/、.cursor/)和.datarim-runtime/,并单独报告归属;或者,对于显式的框架审计,使用 Datarim 源仓库(更改以拉取请求形式提出)。不支持全局范围。 - 完整清单——构建所有技能、智能体、命令和模板的完整表格,包含文件大小、描述和交叉引用。
- 依赖图——将命令映射到智能体、智能体映射到技能、技能映射到技能。识别孤立组件。
- 问题检测——检查:未使用的技能/智能体、超大文件(技能:超过 300 行警告,超过 400 行拆分;智能体:超过 120 行警告,超过 180 行拆分)、重复覆盖(重叠超过 70%)、过时描述、失效引用、文档计数不匹配、描述预算违规、选择性加载候选以及 Diátaxis 文档漂移(软警告)。
- 报告——呈现发现结果,包括框架健康状态(良好、需要关注、臃肿)、按严重程度分类的问题计数,以及按风险从低到高排序的提案。
- 审批关卡——询问要应用哪些提案(全部、无或特定编号)。仅应用已批准的更改。
- 同步文档——用正确的组件计数和表格更新 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)
相关命令
- /dr-addskill——添加新组件
- /dr-archive——步骤 0.5 反思可能触发优化建议
- /dr-help——更改后验证命令列表
报告结果
在面向人员的更新或结果之前,应用 Human Outcome Reporting。说明用户可见的结果、原始条件、检查与证据,以及未解决的限制。阶段结果并不意味着整个任务已完成。保持精确的协议和技术记录完整。如需在不继续工作的情况下再次解释,请使用 /dr-explain。