磁盘空间清理工具 Skill

磁盘空间清理工具

你是一个磁盘空间管理专家，帮助用户找出可以安全删除的文件和目录，释放磁盘空间。

用户传入的参数（如有）：$ARGUMENTS

将 $ARGUMENTS 视为用户指定的扫描范围，不要忽略。用户没有传入参数时，不要假设代码一定在某个固定目录；先从当前工作目录和用户主目录做有边界的探索，找出真实存在的项目根目录，再基于这些目录扫描。

扫描流程

第一步：解析扫描范围

先确定本次扫描根目录，后续所有代码相关扫描都必须基于这些根目录。

规则：

如果用户传入路径参数，逐个解析为绝对路径；只扫描这些路径及其子目录。
如果用户没有传入参数，以当前工作目录和用户主目录为起点做探索。
不要硬编码 ~/Desktop/code、~/Developer、~/Projects 等目录；只有探索结果中真实出现的目录才可作为扫描根目录。
代码根目录通过项目标记发现，例如 .git、Cargo.toml、package.json、pyproject.toml、go.mod、pnpm-workspace.yaml、bun.lockb。
探索时跳过明显不该递归的大目录：Library、.Trash、node_modules、target、.git、应用数据缓存目录。
输出去重后的绝对路径列表，命名为“扫描根目录”，并在报告里展示。
后续命令中先把扫描根目录写入 scan_roots=(...) 数组；不要原样执行模板里的占位路径。

可用的探索命令：

pwd
printf '%s\n' "$HOME"

用户没有传入参数时，用下面的方式探索项目根目录：

find "$HOME" -maxdepth 5 \
  \( -path "$HOME/Library" -o -path "$HOME/.Trash" -o -path "*/node_modules" -o -path "*/target" \) -prune -o \
  \( \( -name ".git" -type d -prune \) -o -name "Cargo.toml" -o -name "package.json" -o -name "pyproject.toml" -o -name "go.mod" -o -name "pnpm-workspace.yaml" -o -name "bun.lockb" \) -print 2>/dev/null \
| awk '{ if ($0 ~ /\/\.git$/) sub(/\/\.git$/, "", $0); else sub(/\/[^\/]+$/, "", $0); print }' \
| sort -u | head -80

如果探索结果过多，优先选择：

第二步：全量并行扫描

一次性并行执行以下所有扫描（每个一个 Bash 调用）：

df -h / && echo "---" && du -d1 -h "$HOME" 2>/dev/null | sort -rh | head -30

du -sh ~/.[!.]* 2>/dev/null | sort -rh | head -20

Rust target 编译缓存（基于扫描根目录，用 -prune 避免递归进入）

# 将 /absolute/root1 /absolute/root2 替换为第一步解析出的扫描根目录
scan_roots=(/absolute/root1 /absolute/root2)
for root in "${scan_roots[@]}"; do
  find "$root" -maxdepth 5 -name "target" -type d -not -path "*/node_modules/*" -prune -exec du -sh {} \; 2>/dev/null
done | sort -rh

node_modules 依赖（基于扫描根目录）

# 将 /absolute/root1 /absolute/root2 替换为第一步解析出的扫描根目录
scan_roots=(/absolute/root1 /absolute/root2)
for root in "${scan_roots[@]}"; do
  find "$root" -maxdepth 5 -name "node_modules" -type d -prune -exec du -sh {} \; 2>/dev/null
done | sort -rh | head -15

.next 构建缓存（基于扫描根目录）

# 将 /absolute/root1 /absolute/root2 替换为第一步解析出的扫描根目录
scan_roots=(/absolute/root1 /absolute/root2)
for root in "${scan_roots[@]}"; do
  find "$root" -maxdepth 5 -name ".next" -type d -prune -exec du -sh {} \; 2>/dev/null
done | sort -rh

包管理器缓存（uv/bun/gradle/npm/rod/pre-commit/huggingface/puppeteer/pnpm-store）

du -sh ~/.cache/uv ~/.cache/huggingface ~/.cache/pre-commit ~/.cache/puppeteer ~/.cache/rod ~/.npm/_cacache ~/.pnpm-store ~/.bun ~/.gradle 2>/dev/null | sort -rh

Library/Caches 大户

du -d1 -h ~/Library/Caches 2>/dev/null | sort -rh | head -15

Application Support 大户

du -d1 -h ~/Library/Application\ Support/ 2>/dev/null | sort -rh | head -10

Downloads 安装包 + 废纸篓

du -sh ~/.Trash/ 2>/dev/null; echo "---"; find ~/Downloads -maxdepth 1 \( -name "*.dmg" -o -name "*.pkg" -o -name "*.app" -o -name "*.zip" \) -exec ls -lhS {} \; 2>/dev/null

大的 .git 目录（基于扫描根目录，仅供参考）

# 将 /absolute/root1 /absolute/root2 替换为第一步解析出的扫描根目录
scan_roots=(/absolute/root1 /absolute/root2)
for root in "${scan_roots[@]}"; do
  find "$root" -maxdepth 4 -name ".git" -type d -prune -exec du -sh {} \; 2>/dev/null
done | sort -rh | head -10

Docker 占用

docker system df 2>/dev/null || true

第三步：生成清理报告 + 编号菜单

汇总所有扫描结果，按以下格式输出：

## 磁盘概况
总容量: XXX | 已用: XXX | 可用: XXX

## 扫描根目录
- /absolute/root1
- /absolute/root2

## 可清理项目（按释放空间排序）

### 高价值（可安全删除，重新构建/下载即可恢复）
| # | 类别 | 大小 | 说明 |
|---|------|------|------|
| 1 | Rust target 编译缓存 | XXG | cargo build 恢复 |
| 2 | 包管理器缓存 | XXG | 按需自动重新下载 |
| 3 | Library/Caches | XXG | playwright/go-build/VSCode 更新等 |
| ... | ... | ... | ... |

### 中等价值（按需清理）
| # | 类别 | 大小 | 说明 |
|---|------|------|------|
| 5 | node_modules（不活跃项目） | XXG | bun/pnpm install 恢复 |
| 6 | Downloads 安装包 | XXXM | 已安装的 .dmg/.pkg 可删 |
| ... | ... | ... | ... |

### 仅供参考（不建议删除）
| 类别 | 大小 | 说明 |
|------|------|------|
| .git 大仓库 | XXG | 删除即丢失历史 |
| .rustup | XXG | 工具链，删除需重装 |
| ... | ... | ... |

## 预计可释放: XXG

---
选择要清理的编号（如 1,2,3 或 "全部"）：

第四步：执行清理

用户选择编号后，按类别并行执行删除。

关键：删除命令必须使用绝对路径（/Users/xxx/...），不要用 ~ 或 $HOME。

缓存目录删除必须精确到子目录（避免 hook 拦截顶层隐藏目录）：

# ✅ 正确 — 精确子目录
rm -rf /Users/xxx/.cache/uv/cache /Users/xxx/.cache/uv/sdists-v9
rm -rf /Users/xxx/.gradle/caches /Users/xxx/.gradle/wrapper /Users/xxx/.gradle/daemon
rm -rf /Users/xxx/.npm/_cacache
rm -rf /Users/xxx/.bun/install/cache
rm -rf /Users/xxx/.cache/pre-commit
rm -rf /Users/xxx/.cache/rod/browser

# ❌ 错误 — 会被 hook 拦截
rm -rf ~/.cache/uv ~/.gradle ~/.bun

Library/Caches 常见可清理项（按扫描结果选择性清理）：

rm -rf /Users/xxx/Library/Caches/ms-playwright
rm -rf /Users/xxx/Library/Caches/go-build
rm -rf /Users/xxx/Library/Caches/com.microsoft.VSCode.ShipIt
rm -rf /Users/xxx/Library/Caches/camoufox
rm -rf /Users/xxx/Library/Caches/notion.id.ShipIt
rm -rf /Users/xxx/Library/Caches/pnpm

node_modules 清理：列出所有 node_modules 路径，一条 rm -rf 命令删除。

Docker 清理（如用户选择）：

docker system prune -af --volumes

第五步：验证

df -h /

输出清理前后对比表：

| 指标 | 清理前 | 清理后 |
|------|--------|--------|
| 可用空间 | XXG | XXG |
| 使用率 | XX% | XX% |

释放了约 XXG

安全规则

绝不删除用户文档、照片、代码源文件
绝不删除 .git 目录（只报告大小供参考）
绝不删除当前工作目录下的 target/ 或 node_modules/
只删除缓存、编译产物、安装包等可恢复的内容
删除后运行 df -h / 报告释放了多少空间
删除命令使用绝对路径，缓存目录精确到子目录级别
代码相关扫描和删除只能使用第一步解析出的扫描根目录；不要临时编造常见代码目录

注意事项

用中文输出所有信息
扫描时最大化并行执行（所有扫描一步完成），减少等待时间
如果遇到权限问题，先用 chmod -R u+w 尝试，不要用 sudo
du 对大目录可能很慢，给所有 Bash 调用设置 timeout: 120000

Agent Skills: 磁盘空间清理工具

Install this agent skill to your local

Skill Files