mcpField
M
mac-software-storage-cleanup

mac-software-storage-cleanup

github.com/yangsonhung生产力1868 次安装12 周前更新
代码仓库

关于 mac-software-storage-cleanup

用于审计 macOS 已安装软件和存储占用，并提供分级清理建议的 Skill。它将应用数据与低风险清理分开处理，只有确认后才执行清理。

主要功能

  1. 01盘点应用和存储占用项
  2. 02按大小排列较大项目
  3. 03区分低风险与中风险目标
  4. 04清理后核验释放空间

适用场景

  1. 01查找占用较大的应用和缓存目录
  2. 02清理前检查模拟器数据
  3. 03比较确认清理前后的存储占用

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/yangsonhung/awesome-agent-skills --skill mac-software-storage-cleanup

安装后在 Claude Code 中输入/mac-software-storage-cleanup确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

scripts/
cleanup_priority1.sh
list_priority2_candidates.sh
report_sizes.sh

详细介绍

Mac 软件存储清理

概述

审查 macOS 上已安装的软件和存储使用情况，提供按优先级排序的清理建议，并且只在获得确认后执行低风险清理。此技能会分别处理应用清单、缓存清理、模拟器数据和中风险应用数据，确保破坏性操作明确，并尽可能可撤销。

使用场景

在以下情况下使用此技能：

  • 用户希望检查安装在 /Applications、~/Applications 下的软件、Homebrew Formula 或 Homebrew Cask
  • 用户希望按大小查看应用和常见缓存位置的存储使用情况排名
  • 用户希望清理 ~/Library/Caches 和 ~/Library/Developer/CoreSimulator 等低风险路径
  • 用户希望获得空间回收建议，并明确区分低风险和中风险清理

不要使用

在以下情况下不要使用此技能：

  • 用户希望卸载某个特定应用，而不是进行存储管理
  • 用户要求直接删除应用数据，但未明确确认
  • 环境不是 macOS，或目标路径不适用

说明

  1. 首先运行 scripts/report_sizes.sh，盘点安装来源和主要存储占用项。
  2. 按优先级对清理候选项分类：
    • 优先级 1：缓存和模拟器数据，通常风险较低。
    • 优先级 2：应用数据目录，仅报告，默认绝不删除。
    • 优先级 3：收益较低的小型缓存或日志。
  3. 报告必须显示各类别的总量、数量以及占用最大的 Top N 项。
  4. 若要检查优先级 2 的候选项，请运行 scripts/list_priority2_candidates.sh [target_dir] [TopN]。
  5. 只有在用户明确确认后，才能运行 scripts/cleanup_priority1.sh 或执行同等的低风险清理操作。
  6. 清理后重新计算用量，并显示 清理前 -> 清理后 -> 回收量 摘要。

工作流

Inventory install sources and storage usage
  -> identify high-value cleanup targets
  -> present prioritized recommendations
  -> wait for user confirmation
  -> run low-risk cleanup
  -> verify reclaimed space

运行命令

bash scripts/report_sizes.sh
bash scripts/list_priority2_candidates.sh ~/Library/Application\\ Support 20
bash scripts/cleanup_priority1.sh

输出要求

  • 显示每种路径类别的数量和总大小
  • 列出占用最大的 Top N 项，方便用户快速决策
  • 每项清理操作都必须包含清理前后的对比
  • 未经用户明确批准，不要删除优先级 2 目录

限制

  • 不要使用有破坏性的 git 命令
  • 不要删除未经确认的应用数据
  • 如果脚本失败，请改用只读检查或范围最小的安全清理

评论

支持 Markdown