Personal productivity · Automation
disk-cleaner
/disk-cleaner
当用户要扫描磁盘空间、找出可安全删除的缓存/编译产物/安装包、或交互式释放空间时使用。
- Author
- majiayu000 ↗
- Repository
- spellbook ↗
- Licence
- MIT
- Last repository change
- 26.10.2026
Assessment and security
96/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability21 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
Deprecation
No signals detected. Repository changed on 26.10.2026, without references to retired models or APIs.
Licence
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
当用户要扫描磁盘空间、找出可安全删除的缓存/编译产物/安装包、或交互式释放空间时使用。
Original author description
当用户要扫描磁盘空间、找出可安全删除的缓存/编译产物/安装包、或交互式释放空间时使用。
How it works
- 扫描流程
- 安全规则
- 注意事项
Original SKILL.md headings · 235 lines, 752 words
SKILL.md preview
---
name: disk-cleaner
description: 当用户要扫描磁盘空间、找出可安全删除的缓存/编译产物/安装包、或交互式释放空间时使用。
allowed-tools: Bash
metadata:
argument-hint: '[扫描路径,默认 ~]'
---
# 磁盘空间清理工具
你是一个磁盘空间管理专家,帮助用户找出可以安全删除的文件和目录,释放磁盘空间。
用户传入的参数(如有):$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=(...)` 数组;不要原样执行模板里的占位路径。
可用的探索命令:
```bash
pwd
printf '%s\n' "$HOME"
```
用户没有传入参数时,用下面的方式探索项目根目录:
```bash
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 调用):**
1. **磁盘概况 + 主目录一级**
```bash
df -h / && echo "---" && du -d1 -h "$HOME" 2>/dev/null | sort -rh | head -30
```
2. **隐藏目录占用**
```bash
du -sh ~/.[!.]* 2>/dev/null | sort -rh | head -20
```
3. **Rust target 编译缓存**(基于扫描根目录,用 -prune 避免递归进入)
```bash
# 将 /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
```
4. **node_modules 依赖**(基于扫描根目录)
```bash
# 将 /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
```
5. **.next 构建缓存**(基于扫描根目录)
```bash
# 将 /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
```
6. **包管理器缓存**(uv/bun/gradle/npm/rod/pre-commit/huggingface/puppeteer/pnpm-store)
```bash
du -sh ~/.cache/uv ~/.cache/huggingface ~/.cache/pre-commit ~/.cache/puppeteer ~/.cache/rod ~/.npm/_cacache ~/.pnpm-store ~/.bun ~/.gradle 2>/dev/null | sort -rh
```
7. **Library/Caches 大户**
```bash
du -d1 -h ~/Library/Caches 2>/dev/null | sort -rh | head -15
```
8. **Application Support 大户**
```bash
du -d1 -h ~/Library/Application\ Support/ 2>/dev/null | sort -rh | head -10
```
9. **Downloads 安装包 + 废纸篓**
```bash
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
```
10. **大的 .git 目录**(基于扫描根目录,仅供参考)
```bash
# 将 /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
```
11. **Docker 占用**
```bash
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 拦截顶层隐藏目录):
```bash
# ✅ 正确 — 精确子目录
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 常见可清理项**(按扫描结果选择性清理):
```bash
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 清理**(如用户选择):
```bash
docker system prune -af --volumes
```
### 第五步:验证
```bash
df -h /
```
输出清理前后对比表:
```
| 指标 | 清理前 | 清理后 |
|------|--------|--------|
| 可用空间 | XXG | XXG |
| 使用率 | XX% | XX% |
释放了约 XXG
```
## 安全规则
- **绝不删除**用户文档、照片、代码源文件
- **绝不删除** `.git` 目录(只报告大小供参考)
- **绝不删除**当前工作目录下的 `target/` 或 `node_modules/`
- 只删除缓存、编译产物、安装包等可恢复的内容
- 删除后运行 `df -h /` 报告释放了多少空间
- 删除命令使用绝对路径,缓存目录精确到子目录级别
- 代码相关扫描和删除只能使用第一步解析出的扫描根目录;不要临时编造常见代码目录
## 注意事项
- 用中文输出所有信息
- 扫描时最大化并行执行(所有扫描一步完成),减少等待时间
- 如果遇到权限问题,先用 `chmod -R u+w` 尝试,不要用 sudo
- `du` 对大目录可能很慢,给所有 Bash 调用设置 `timeout: 120000`
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · majiayu000/spellbook | 96 | MIT |
| xiaofenggan01/disk-cleaner-skills | 95 | MIT |
Identical content appears in 1 other GitHub folders. We show one copy with the highest score.
Database snapshot: 13.11.2026 · package version bb1b33e627d9 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 90free-up-disk-space
Free up disk space on the user's Mac safely with DiskSpace AI. Use when the user says their Mac or disk is full, asks what's taking up space, can't install a macOS update, wants to clean caches, Xcode DerivedData, simulators, Docker, node_modules or AI models, or asks whether a… - 100mac-storage-cleaner
Safely reclaim disk space on a Mac — the trustworthy, transparent, reversible alternative to CleanMyMac and similar tools. Use whenever the user says their Mac disk or storage is full or nearly full, gets a "startup disk almost full" / low-storage warning, asks to free up space,… - 90disk-cleanup
Audit disk usage, free disk space, clean up disposable files, and recommend ways to limit storage growth. Use for hard disk cleanup, low disk space, large caches, or finding what consumes storage. - 100cleanup
Free up disk space on this computer: list what takes space with its size, why it is safe to delete and what it costs, then delete only what the owner picks. Use when someone says "cleanup", "clean up disk", "free up space", "my disk is full", "out of space", "the Mac is full",… - 91macos-cleaner
Analyze and reclaim macOS disk space through intelligent cleanup recommendations. This skill should be used when users report disk space issues, need to clean up their Mac, or want to understand what's consuming storage. Focus on safe, interactive analysis with user confirmation… - 93c-drive-cleaner
Windows C盘清理和磁盘空间管理。当用户说C盘满了、磁盘空间不足、清理临时文件/缓存/回收站/系统日志、查找大文件、分析磁盘占用时使用。仅适用于 Windows 环境。不用于:macOS/Linux 磁盘清理、卸载软件(引导用户走系统卸载)、清理用户个人文件(只报告位置,删除决定权在用户)。