openclaw-cleaner

# 🧹 OpenClaw Cleaner (清理大师)

> AI 可直接调用的项目清理与优化工具

本技能提供一系列自动化能力，AI 可在执行任务时直接调用，无需用户确认。

---

## 能力总览

| 能力 | 说明 | 何时调用 |
|------|------|----------|
| **快照** | 记录文件状态 | 执行修改前 |
| **Diff** | 对比变更差异 | 修改完成后展示给用户 |
| **Checkpoint** | 保存关键状态 | 重要操作前 |
| **Task Progress** | 追踪长时间任务 | 批量处理时 |
| **Health Check** | 评估目录健康度 | 用户询问或定期 |
| **Skill Match** | 推荐相关 Skills | 用户描述任务时 |
| **Optimize** | 优化文件减少 Token | 空间不足或定期 |

---

## 使用示例

### 场景：删除一个 Skill

```javascript
// 1. 先创建快照（自动，也可手动）
const snap = await snapshot.create('before-remove-old-skill');

// 2. 执行删除
await skills.remove('unused-skill');

// 3. 对比变更，展示给用户
const diff = await snapshot.compare(snap.name, 'latest');
console.log(snapshot.generateReport(diff));
// 用户看到: "我删除了 xxx，新增了 yyy"
```

### 场景：批量处理文件

```javascript
// 1. 开始任务
const taskInfo = await task.start('process-files', fileList);

// 2. 处理每个文件
for (const file of files) {
  try {
    await processFile(file);
    await task.markCompleted(taskInfo.id, index);
  } catch (e) {
    await task.markFailed(taskInfo.id, index, e.message);
  }
}

// 3. 用户可随时查看进度
const status = await task.getStatus(taskInfo.id);
```

---

## 返回格式

```javascript
// snapshot.compare()
{
  added: [{ path: string, size: number, content?: string }],
  removed: [{ path: string, size: number }],
  modified: [{ path: string, oldSize: number, newSize: number, changes: [] }]
}

// health.check()
{
  score: number,           // 0-100
  totalFiles: number,
  totalDirs: number,
  totalSize: number,
  warnings: string[]
}
```

---

## 版本

**v2.1.2** - 整合为单文件版本

---

<!-- 代码实现开始 -->
```javascript
// ============================================================================
// OpenClaw Cleaner - 完整实现代码 (2.1.2)
// ===============================...