Windows 磁盘分诊器

项目是什么

18trees-windows-disk-triage 是一个 Windows 磁盘空间分诊 skill，适用于 Claude Code、Codex，以及任何能执行 shell 命令的 AI 工具。

C 盘满了，常见做法有两条：让 AI 给一串 Remove-Item -Recurse -Force，或者装一个一键清理工具。两条路的问题相同——删完你不知道删了什么，也不知道下次它会不会手滑。

这个 skill 走第三条路：先只读扫描，按四级风险分级，逐项由你拍板，然后才执行。它的输出是一份清单，不是一个执行按钮。

具体结构

项目分四层。

规则源。 skills/windows-disk-triage/ 是唯一真相。SKILL.md 写分诊流程、四级分级标准、实战经验和红线；references/safe-cleanup-checklist.md 是核心资产——40+ 条路径按类别分组，每条标注典型占用、说明和删除影响，其中占用值是经验区间，不是统计值。

打包与分发。 scripts/build-dist.sh 把规则和清单拼成 dist/windows-disk-triage.md 单文件版，零外部引用，可以当作一份 C 盘清理参考清单直接查阅。分发有三条路：Claude Code 走插件市场，Codex 复制 skill 目录，能跑命令但不支持 skill 机制的工具（Cursor、Windsurf、自建 agent）则把单文件版整份作为指令。dist/ 是生成物，规则只维护在 skills/。

分诊运行时。 扫描全部只读，从顶级目录逐层下钻，避免一上来就全盘递归。结果按四级分档：零风险、需决策、须迁移或系统操作、禁止触碰。需要管理员权限的系统目录，skill 把命令输出给用户手动执行——它不尝试提权。

落点。 命令作用在 Windows 10 / 11 的 C 盘上。examples/ 放了两份示例——只读扫描的原始输出和整理后的分诊报告，报告到「告诉我你要执行哪几项」为止，一个文件都没删。

优秀设计

每一项都回答「删了会怎样」。 清单里删除影响是硬性要求：写「无」，或写具体代价，不确定就写未验证。新增路径不带删除影响不会被合并。

红线单独列，任何情况下不碰。 凭证、登录态、聊天数据库、系统目录写死在清单里；pagefile.sys 只迁移不删，hiberfil.sys 用 powercfg 关，WinSxS 只允许用 DISM 收拾。

不尝试提权。 Start-Process -Verb RunAs 会被安全策略拦截，所以系统目录的命令交给用户手动以管理员身份运行。删什么、由谁删的决定权留在人手里。

迁移前先校验。 迁移类操作必须比对源与目标的文件数和字节数是否一致，校验通过才提示删源。

规则只维护一处。 单文件版由脚本生成，改完规则重跑脚本即可；一致性由脚本保证，不靠手抄。

解决了什么问题

• C 盘满了不必先装一个清理工具：先拿到一份分级清单，每一项都写明删除影响。
• 清单可以脱离 AI 单独使用，单文件版零外部引用，直接当参考清单查阅。
• 系统目录、休眠文件、虚拟内存这类高代价项有明确做法（迁移、powercfg /h off、DISM），而不是简单删掉。
• 提权被明确排除，用户始终是删除动作的执行者。
• 即使交在 AI 手里，它也只扫描、分档、列清单，不替用户做删除决定。