关于 macos-disk-cleanup
macOS Disk Cleanup 是用于测量 macOS 磁盘占用并清理可回收文件的引导式技能。它将可重建内容与需逐项批准的数据分开处理，并检查清理后的空间变化。
主要功能
- 01测量磁盘和目录占用
- 02按风险分类待删内容
- 03执行安全清理命令
- 04敏感数据删除前征求批准
- 05比较清理前后的占用
适用场景
- 01查找 Mac 上的大型目录
- 02清理可重建的开发缓存
- 03删除前审查应用数据
- 04检查清理结果和快照
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/macos-disk-cleanup确认已加载。
附带文件agents/openai.yamlreferences/paths.md
详细介绍
macOS 磁盘清理
先测量，再删除；优先处理安全收益。任何保存本地独有状态的内容都应标记为先确认——必须先获得用户明确同意，因为这些内容无法重新下载。
流程
- 测量顶层目录和主目录的用量。
- 深入检查占用最大的用户所有目录。
- 将每个候选项归类为快速清理或先确认，并分别列出这两组。
- 执行快速清理；每次删除先确认的项目前都要征求同意。
- 重新测量并报告变化量。
完成标准：所有占用超过约 1G 的项目都已归类；每项先确认的删除都获得了单独批准；并使用清理前后的 df -h / 说明本次实际释放了多少空间。
测量
# 1. Top-level
du -sh /System /Users /private /Applications /Library 2>/dev/null | sort -rh
# 2. Home breakdown
du -sh ~/Library ~/Code ~/Downloads 2>/dev/null | sort -rh
# 3. Library breakdown
du -sh ~/Library/Application\ Support/* ~/Library/Caches/* ~/Library/Group\ Containers/* 2>/dev/null | sort -rh | head -20
根据用户的情况重点检查：
| 用户类型 | 优先检查 | 典型收益 |
|---|---|---|
| 开发者 | Homebrew、uv/npm/pip、DerivedData、模拟器 | 10–20G |
| AI/ML 用户 | Ollama 未使用的模型、HuggingFace、LM Studio | 5–15G |
| 重度 Chrome 用户 | OptGuideOnDeviceModel、GoogleUpdater | ~5G |
快速清理
此处的内容都可按需重新构建或下载——无需询问即可清理。
| 命令 | 释放空间 | 备注 |
|---|---|---|
brew cleanup --prune=all | 2–10G | 缓存的安装程序 |
uv cache clean --force | 1–10G | uv 软件包缓存 |
npm cache clean --force | 500M–2G | npm 缓存 |
pip3 cache purge | 100–500M | pip 缓存 |
pre-commit clean | 200–500M | pre-commit 环境 |
rm -rf ~/Library/Developer/Xcode/DerivedData | 500M–5G | 可按需重新构建 |
xcrun simctl delete unavailable | 1–10G | 未使用的 iOS 模拟器 |
路径目录
有关各路径的判定——Chrome、AI 模型缓存、开发工具缓存，以及需先确认的应用数据——在建议删除上述快速清理项以外的任何内容之前，请先阅读 references/paths.md。
清理后
由于 APFS 本地快照仍占用已释放的块，df -h / 的结果会有延迟。检查 tmutil listlocalsnapshots /，并告知用户这些快照会在约 24 小时内自动精简——底层的数字已经正确，因此接下来应该等待，而不是再次清理。
评论
支持 Markdown