Windows Disk Cleanup — Development skill for Claude Code

windows-disk-cleanup

一套面向 Windows 10 / 11 的磁盘空间清理与跨盘迁移技能（Agent Skill）。 把「先备份 → 只读体检 → 出报告 → 逐项确认 → 迁移 → 清理 → 管理员收尾」固化成可重复执行的流程， 并内置了 Windows 上最常见的一堆坑的确定性做法。

[](LICENSE) 

---

⚠️ 重要警告与免责声明（请务必先读）

**1. 清理前必须自行备份重要文件。** 本技能会执行**删除**与**移动**操作，可能造成数据**不可逆丢失**。 **因使用本技能导致的重要文件丢失，作者与分发者不承担任何责任。**

**2. 请至少备份以下内容**（详细清单见 [`references/backup-checklist.md`](references/backup-checklist.md)）： 登录凭据与账号信息（浏览器密码、Cookie、SSH 私钥、API Key）、密码管理器数据库、 聊天记录（微信 / QQ / 钉钉）、软件日志与崩溃转储、许可证与激活码、配置文件、 证书与密钥库、浏览器书签、本地邮件数据（.pst/.ost）、本地数据库、云盘未同步文件。

**3. 备份要放在另一个盘上**（另一块硬盘 / 移动硬盘 / 云端），**不要**放在正要清理的同一个盘中。

**4. 不得未经确认删除他人电脑上的数据。** 本技能强制「逐项列出 → 用户确认 → 才执行」。替他人清理时，必须由**机器所有者**确认每一行。

**5. 本技能不保证清理后系统的稳定性**。请自行判断风险，重要机器请先做完整系统备份（镜像）。

---

这是什么

一个 **Agent Skill**（遵循开放的 `SKILL.md` 规范，可用于 WorkBuddy / Claude Code 等支持 Agent Skills 的宿主）。 安装后，当你说「帮我清理 C 盘」「C 盘快满了」「把大缓存搬到 D 盘」时，Agent 会自动加载本技能并按既定流程执行。

能力

能力	说明
只读空间体检	扫描各盘容量、根级目录构成、Top N 大目录与大文件
可视化报告	生成 HTML 体检报告，分「可直接清 / 建议迁移 / 需确认」三档
跨盘迁移	用目录联接（Junction）把缓存搬到其他盘，软件仍按原路径读写
安全清理	识别临时文件、更新缓存、程序残留，逐项确认后清理
管理员收尾	自动生成需提权的 .bat，处理属主为 Administrators 的目录与 HKLM 注册表
陷阱规避	内置回收站、权限、中文路径、体积统计等 Windows 专有问题的解法

不会做什么

• 不会在未经你确认的情况下删除或移动任何文件。
• 不会主动处理你的个人数据（桌面 / 下载 / 文档 / 图片 / 视频 / 聊天记录）。
• 不会触碰系统关键目录（WinSxS、Windows\Installer、ProgramData\Package Cache 等）。

---

适用环境

• Windows 10 / 11
• PowerShell 5.1 或更高（脚本为 ASCII 编写，兼容 5.1）
• 宿主支持 Agent Skills（WorkBuddy、Claude Code 等；或手工运行脚本）

---

目录结构

windows-disk-cleanup/
├── SKILL.md                          # 技能主文件（Agent 读取）
├── README.md                         # 本文件
├── LICENSE                           # MIT
├── scripts/
│   ├── disk_survey.ps1               # 只读空间体检
│   ├── folder_size.ps1               # 单目录体积统计（替代不可靠的 du）
│   ├── migrate_folder.ps1