Agent Skills › staruhub/ClaudeSkills › c-drive-cleaner

c-drive-cleaner

GitHub

Windows C盘空间管理技能，提供安全的磁盘清理流程。支持分析占用、查找大文件、模拟及执行临时文件/缓存清理，并验证效果。严格遵循安全原则，禁止删除系统关键目录，确保操作可预览且用户确认。

skills/Geek-skills-c-drive-cleaner/SKILL.md staruhub/ClaudeSkills

Trigger Scenarios

C盘满了磁盘空间不足清理临时文件清理缓存清理回收站清理系统日志查找大文件分析磁盘占用

Install

npx skills add staruhub/ClaudeSkills --skill c-drive-cleaner -g -y

More Options

Use without installing

npx skills use staruhub/ClaudeSkills@c-drive-cleaner

指定 Agent (Claude Code)

npx skills add staruhub/ClaudeSkills --skill c-drive-cleaner -a claude-code -g -y

安装 repo 全部 skill

npx skills add staruhub/ClaudeSkills --all -g -y

预览 repo 内 skill

npx skills add staruhub/ClaudeSkills --list

SKILL.md

Frontmatter

{
    "name": "c-drive-cleaner",
    "version": "1.1.0",
    "description": "Windows C盘清理和磁盘空间管理。当用户说C盘满了、磁盘空间不足、清理临时文件\/缓存\/回收站\/系统日志、查找大文件、分析磁盘占用时使用。仅适用于 Windows 环境。不用于：macOS\/Linux 磁盘清理、卸载软件（引导用户走系统卸载）、清理用户个人文件（只报告位置，删除决定权在用户）。"
}

C盘清理大师

安全导向的 Windows 磁盘清理：分析 → 模拟 → 执行 → 验证，破坏性操作永远先预览。

验收标准（清理任务完成前自查）

实际删除前完成过一次模拟运行，并把预览结果给用户看过
--execute 前用户明确确认过（清理不经过回收站，不可恢复）
已提醒用户创建系统还原点和关闭浏览器（清缓存时）
未触碰"禁删清单"中的任何目录
清理后重跑分析,回报实际释放的空间数字,不是"应该清理了"
用户个人大文件（视频/压缩包等）只报告位置与大小，删除由用户自己决定

禁删清单（碰到即停）

C:\Windows\System32 — 核心系统文件
C:\Windows\WinSxS — Windows 组件存储（要瘦身走 DISM，不许直接删）
C:\Program Files / C:\ProgramData — 已装程序及数据
C:\Windows\Prefetch — 预读取文件，删了拖慢启动
休眠文件与虚拟内存 — 走系统设置调整，不手动删文件

工作流程

1. 分析占用

python scripts/analyze_disk.py C:\ 2 20    # 路径 深度 显示前N项

2. 查找大文件（只报告，不删）

python scripts/find_large_files.py C:\ 100 50            # 路径 最小MB 最大结果数
python scripts/find_large_files.py C:\Users 200 100 .mp4,.avi,.mkv   # 按类型过滤

常见大文件类型：视频 .mp4,.mkv,.mov；安装包 .iso,.exe,.msi；压缩包 .zip,.rar,.7z；备份 .bak,.sql。

3. 清理（默认模拟模式）

python scripts/clean_temp.py             # 模拟：只预览
python scripts/clean_temp.py --execute   # 实际执行：需二次确认

覆盖范围：%TEMP%、C:\Windows\Temp、浏览器缓存（Chrome/Edge/Firefox）、.log/.etl/.old 日志、回收站。

4. 验证

重跑 analyze_disk.py，对比前后数字回报实际效果。

已知陷阱

陷阱	具体表现	应对
无权限静默漏扫	非管理员运行，扫描结果偏小误导判断	提示以管理员身份运行；脚本会跳过无权目录并计数
浏览器缓存清理失败	浏览器进程占用文件	先关闭所有浏览器窗口再清
清完没效果	临时文件本来就不大，大头是个人文件或程序	回到大文件报告和目录排行,引导用户决策(卸载/转移)
误以为可恢复	脚本删除不经回收站	执行前明确告知不可恢复,这也是模拟先行的原因
SSD 清到贴满	追求 100% 利用率	SSD 保留 15-20% 空间维持性能;低于 20% 时才建议清理

权限与配套

部分系统文件需管理员权限（右键"以管理员身份运行"）
可配合系统自带工具：cleanmgr、存储感知、DISM 组件清理
深入的垃圾文件位置、清理命令、安全实践：references/windows_cleanup_guide.md

脚本说明

脚本	功能	安全特性
`scripts/analyze_disk.py`	目录占用排行 + 大文件列表	只读；自动跳过无权目录
`scripts/find_large_files.py`	按大小/类型查找文件	只读；显示访问时间辅助判断
`scripts/clean_temp.py`	清理临时文件/缓存/日志/回收站	默认模拟；--execute 二次确认；跳过系统关键目录