用途：在 Mac 上安全回收磁盘空间，做法是先测量、只删除可证明会重新生成的缓存，风险较高的项目移入废纸篓以便恢复，昂贵操作前先询问，并记录每次操作。
主要能力：脚本位于 scripts/，完整分级清单与命令见 references/cache-catalog.md。分为安全层（纯缓存，可直接删除）、询问层（Docker 镜像、ML 模型、模拟器、Xcode Archives、模块存储等，需用户选择）、永不删除层（iOS 备份、照片图库、邮件/信息数据、~/.ssh、~/.aws、钥匙串、Time Machine 快照等）。
使用方式：先运行 survey.sh 只读盘点（D="${CLAUDE_PLUGIN_ROOT:+$CLAUDE_PLUGIN_ROOT/skills/mac-storage-cleaner}"; D="${D:-$HOME/.claude/skills/mac-storage-cleaner}"；bash "$D/scripts/survey.sh"）；再运行 clean-safe.sh 清理安全层；用 find-extras.sh 扫描卸载残留、大于 500MB 文件、旧安装包与旧下载；用 trash-items.sh 将选定项移入废纸篓。Docker 用 docker system prune -a，模拟器仅 xcrun simctl delete unavailable 安全。
限制：不硬删除用户数据，不 sudo 进入 /System、/Library/Caches、/private/var/folders 或 SIP 保护区域；消息应用媒体属用户数据，应引导用户用应用内清理；混合目录如 ~/.cargo、~/.m2、~/.gradle 只清缓存子目录；若废纸篓失败需在系统设置中授予自动化权限；APFS 可清除空间可能延迟释放。每次破坏性操作记录到 ~/Library/Logs/mac-storage-cleaner/operations.log。