Disk Cleanup — Claude Code 磁盘清理技能

跨平台磁盘空间分析与清理技能，支持 Windows / macOS / Linux，按用户角色定制扫描策略。

仓库地址

平台	地址
GitHub	https://github.com/HappyLy-61/disk-cleanup-skill
Gitee（国内更快）	https://gitee.com/davis-23/disk-cleanup

两个仓库内容一致，选网络更快的那个克隆即可。

---

功能介绍

• 四步交互流程：磁盘总览 → 分批扫描 → 勾选清单 → 执行验证
• 多角色适配：开发者、设计师、游戏玩家、数据/ML 工程师，每个角色扫描不同目录
• 安全优先：绝不自动删除，所有操作需逐项确认；默认软删除（移至暂存目录，7 天后自动清理）
• 三平台支持：Windows (Git Bash/PowerShell)、macOS、Linux

清理分级

等级	说明
✅ 安全清理	纯缓存/临时文件，默认勾选
⚠️ 需确认	取决于是否仍在使用，逐项确认
🚫 禁止清理	系统文件/用户文档/当前使用中的应用数据

角色扫描范围

角色	额外扫描
dev 开发者	IDE 缓存、构建产物、Docker、包管理器、SDK、AI 编程助手
design 设计师	Adobe/Blender/Figma 缓存、素材导出
game 游戏玩家	Steam/Epic 安装目录、Unity 缓存、录屏
data 数据/ML	Conda 环境、pip 缓存、模型文件、数据集
general 通用	浏览器缓存、下载、临时文件、回收站（始终启用）

---

如何在 Claude Code 中安装 Skill

1. 找到 Skills 目录

Claude Code 的 skills 存放在：

~/.claude/skills/

Windows 上对应的路径是：

C:\Users\<你的用户名>\.claude\skills\

2. 下载技能

从 GitHub 克隆：

git clone https://github.com/HappyLy-61/disk-cleanup-skill.git ~/.claude/skills/disk-cleanup/

从 Gitee 克隆（国内更快）：

git clone https://gitee.com/davis-23/disk-cleanup.git ~/.claude/skills/disk-cleanup/

二者内容完全一致，选你网络快的那个即可。

也可以手动创建文件夹并放入文件，目录结构如下：

~/.claude/skills/disk-cleanup/
├── SKILL.md          # 技能定义（核心流程）
├── README.md         # 项目说明
├── ref-win.md        # Windows 扫描命令与清理规则
├── ref-macos.md      # macOS 扫描命令与清理规则
└── ref-linux.md      # Linux 扫描命令与清理规则

3. 验证安装

重启 Claude Code（或开新会话），输入：

/disk-cleanup

如果加载成功，会进入交互式清理流程。

4. Skill 文件说明

每个 Claude Code Skill 至少需要一个 SKILL.md 文件，头部带有 YAML 元数据：

---
name: skill名称
description: 简短描述
---

# 技能内容...

name 字段就是对应的斜杠命令名（/skill名称），description 会在技能列表中显示。

---

使用流程

第一步：启动技能

在 Claude Code 中输入：

/disk-cleanup

第二步：选择扫描范围

会先展示磁盘总览和压力等级：

C:  256G 总量, 180G 已用 (70%)
D:  512G 总量, 450G 已用 (88%)
E:  1T 总量, 50G 已用 (5%)

请选择要扫描的盘符。

按提示选择扫描哪些盘，避免在不必要的盘上浪费时间。

第三步：选择你的角色

勾选匹配你在这台电脑上的使用场景：

• 开发者 — IDE 缓存、构建产物、Docker 镜像、包管理器缓存、AI 编程助手
• 设计师 — Adobe/Blender/Figma 缓存、素材导出
• 游戏玩家 — Steam/Epic 安装目录、Unity 缓存、游戏录屏
• 数据/ML — Conda 环境、pip 缓存、HuggingFace 模型、数据集
• 通用 — （始终启用）浏览器缓存、下载、临时文件、回收站

第四步：查看分批扫描结果

扫描分三批复进行：

1. 快速扫描 — 顶层目录、回收站（最快）
2. 缓存扫描 — 应用缓存、IDE 缓存、AI 助手、角色相关目录
3. 深度扫描 — 大文件（>100MB）、旧下载、重复文件

第五步：勾选清理项

会生成交互式清单：

==================== 磁盘清理确认清单 ====================

🟢 安全清理（推荐，默认全选）：
  [Y] 1. 临时文件                            1.2G
  [Y] 2. 回收站                              4.8G
  [Y] 3. Gradle 缓存                         1.8G

🟡 需确认（逐项选择 y=软删除 / d=直接删除 / n=跳过）：
  [n] 4. AI 助手模型文件                     5.1G
  [n] 5. Android 模拟器镜像                  4.2G
  [n] 6. 旧系统安装镜像                       5.2G

🔴 禁止清理（仅供参考）：
       用户文档                             12.3G

===========================================================

• 安全项默认全选，输入 -编号 取消
• 需确认项默认跳过，输入 编号y 软删除，编号d 直接删除
• 禁止清理项仅展示，不可操作

第六步：确认并执行

确认摘要后一次性执行，不再二次询问。

清理前：C: 180G/256G (70%) | D: 450G/512G (88%)
清理后：C: 150G/256G (59%) | D: 440G/512G (86%)
共释放：40G

---

安全机制

• 绝不自动删除 — 所有操作需你逐项确认
• 默认软删除 — 文件先移到 ~/.disk-cleanup-stash/，保留 7 天才彻底删除
• 系统路径屏蔽 — C:\Windows、/System、/etc 等永不扫描
• 用户文档保护 — Documents、Desktop、Pictures 等只展示总大小，不深入扫描
• 敏感内容过滤 — .git、node_modules、.env、私钥、数据库文件自动跳过

---

恢复误删文件

软删除的文件放在带时间戳的暂存目录中：

ls ~/.disk-cleanup-stash/
# 例如：2026-06-01_14-30-00/

# 恢复某个文件/目录
mv ~/.disk-cleanup-stash/2026-06-01_14-30-00/某目录 /原始路径/

超过 7 天的暂存会在下次运行技能时提醒清理。

---

卸载

rm -rf ~/.claude/skills/disk-cleanup/

---

仓库

• GitHub: https://github.com/HappyLy-61/disk-cleanup-skill
• Gitee: https://gitee.com/davis-23/disk-cleanup

许可

MIT