⏳ This skill is pending AI review.
Scores will appear once the review pipeline completes.
clean-c-drive
小白安全清理C盘(Windows)。当用户想清理C盘、磁盘空间不足、系统盘快满了、想安全释放空间时使用。WizTree扫描→模式库+知识库两层分析→清理方案经用户批复→备份后执行→观察期收尾。安全第一,不确定的一律不动。
Choose how to use this skill
You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.
1. Native installer
This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.
Do not guess an installer command or replace an existing version without reviewing the diff.
2. Complete package recommended
Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.
No complete ProSkills package is published for this listing yet.3. Prompt-only
Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.
Need only the instruction file?
Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.
No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.
// RATINGS
// README
Claude 磁盘清理器
⚠️ 免责声明(请先读我):本技能与文档由 AI(Claude Fable 5)自行编写完成,项目实控人未做人工审查(我也不一定全部看得懂)。请使用者仔细阅读本文档和程序源码,充分理解后再使用,以减少使用风险。
🧹 人机协作磁盘清理工具
利用 WizTree 快速扫描 + AI 智能分析,高效清理磁盘空间。
为什么做这个?
C 盘爆满,却不敢清理?
大部分电脑使用者都有这样的困扰:
- C 盘用了一两年后越来越满,但不敢轻易清理
- 不知道哪些文件能删、哪些不能删,怕删错导致系统崩溃
- 找收费软件清理,或者网上找人帮忙(几十到一两百不等)
根本原因是:
- 我们普通人不是电脑专家,不知道哪些能清理、哪些不能清理
- 不知道哪些文件占用空间大
解决思路:
- 如果能快速找出占用大的文件
- 再让专业的人来判断能不能清理
- 这个问题就解决了!
这就是这个工具的做法:
WizTree 快速扫描(3-5秒)
↓
导出磁盘占用数据
↓
AI 专业分析:哪些占用大、哪些能清理
↓
(为了安全,初级版本暂时)避开系统文件,列出可清理目录
↓
用户确认后,执行清理
现在,普通用户也能安全、简单地自行清理 C 盘了。
核心理念
安全 · 简单 · 给权限就全自动
| 特点 | 说明 |
|---|---|
| 🔒 安全 | 只清理缓存/临时文件,永不删除系统文件和用户数据 |
| 🛡️ 可回滚 | 清理前自动备份,出问题一键恢复 |
| ✨ 简单 | 一条命令 /clean-c-drive 搞定一切 |
| 🤖 智能 | 给管理员权限 = 扫描/执行全自动(清理方案仍需你确认);不给权限 = AI 分析 + 人工执行 |
┌─────────────────────────────────────────────────┐
│ 给管理员权限 → AI 全自动:扫描→分析→清理 │
│ 不给权限 → AI 分析 + 人工执行清理脚本 │
└─────────────────────────────────────────────────┘
关于 Agent Skills
什么是 Agent Skills?
Agent Skill 是一种 极简巧妙的AI Agent架构设计理念,通过模块化、可复用的"技能"封装来扩展 AI通用模型的能力。本质上,它是将复杂的业务逻辑、操作流程、专业知识打包成标准化的 Markdown 指令和脚本,让用户通过简单命令(如 /clean-c-drive)触发完整的自动化工作流。
Agent Skills 代表了 AI 应用架构从"大而全的通用模型"向"精而专的模块化能力"演进的重要趋势。它通过渐进式披露解决了上下文窗口的限制,通过文件系统标准化实现了知识的可发现与可组合,最终让 AI Agent 从"能做"进化到"擅长做",从"工具"升级为"专家"。
总体说来,从MCP、claude code cli、Agent Skills到最新发布的claude cowork来看,Anthropic司在最大化销售自家token的水平上,是专业的,是值得关注和学习的。
核心设计理念
1. 渐进式信息加载
- 启动时仅加载技能元数据(几百 tokens)
- 匹配任务时才加载完整指令(几千 tokens)
- 执行时按需加载脚本和资源
- 结果:相比传统方案,上下文消耗降低 95%+,大幅降低成本
2. 模块化与可组合
- 每个 Skill 是独立的目录结构(SKILL.md + 脚本 + 资源)
- 技能之间互不干扰,可独立验证
- 支持多个技能组合解决复杂问题
- 易于在团队、项目间共享和复用
3. 文件系统即知识网络
- 文件结构本身就构成了知识图谱
- AI Agent 可自主发现可用技能
- 理解技能间的依赖关系
核心优势
| 维度 | 优势 |
|---|---|
| 效率 | 上下文消耗减少 95%,API 成本大幅下降 |
| 易用 | 只需 Markdown + 简单脚本,无需部署服务器 |
| 分发 | 纯文本文件,可像分享文档一样传播 |
| 自文档化 | SKILL.md 就是完整文档和实现逻辑 |
| 可移植 | 基于文件系统,可在不同平台间无缝迁移 |
| 知识容量 | 通过外部文件和脚本,可携带超过上下文限制的知识 |
| 智能适应 | 借助 AI 推理,能灵活处理预期之外的情况 |
在本项目中的应用
这个清理工具正是 Agent Skill 设计理念的实践:
用户执行 /clean-c-drive
↓
AI Agent 加载 Skill 指令和脚本
↓
根据权限自动调整工作流(全自动 或 半自动)
↓
调用 WizTree 扫描、AI 分析、执行清理
通过 Agent Skill,一个原本需要多个脚本、复杂参数、人工配置的任务,现在用户只需一条命令。
更多信息: 详见 Agent Skills 官方文档
特性
- ⚡ 极速扫描:使用 WizTree 的 MFT 扫描技术,秒级完成
- 🤖 AI 分析:智能识别可清理目录,按优先级分类
- 🎯 优先级分类:高/中/低三级清理建议
- 🔒 安全清理:永不删除系统文件和用户数据
- 🤝 人机协作:两种模式满足不同用户需求
两种模式
模式一:普通权限 CLI
👤 人类:扫描 + 导出数据
🤖 AI:分析 + 生成清理脚本
👤 人类:执行清理脚本
适合:注重安全的用户
模式二:管理员权限 CLI(推荐)
👤 人类:只需说"帮我清理C盘"
🤖 AI:自动扫描 + 分析 → 你确认方案 → 自动清理
适合:追求效率的用户
快速开始
前置要求
- WizTree - 免费磁盘空间分析器
- Claude Code CLI - Anthropic 的 CLI 工具
- Python 3.x
推荐使用 Opus 模型 本技能涉及文件系统操作和复杂的分析任务,建议使用 Claude Opus 模型以获得最佳效果。 在 Claude Code 中使用
/model opus切换模型。
安装
-
克隆仓库:
git clone https://github.com/iziqing/-disk-cleaner.git cd -disk-cleaner -
将 WizTree 放入
WizTree/目录(或修改配置中的路径) -
安装为 Agent Skill(v1.1 起为标准 SKILL.md 结构):
# 用户级安装(推荐,所有项目可用) mkdir -p ~/.claude/skills/clean-c-drive cp -r SKILL.md scan.py analyze.py backup.py references ~/.claude/skills/clean-c-drive/ # 或项目级:复制到 你的项目/.claude/skills/clean-c-drive/
使用方法
管理员权限模式(推荐):
# 以管理员身份打开终端
claude
# 输入命令:
/clean-c-drive
普通权限模式:
- 以管理员身份运行 WizTree,扫描并导出 CSV
- 保存到
skills/clean-c-drive/data/ - 在 Claude Code 中运行
/clean-c-drive
清理内容
高优先级(安全清理)
| 类别 | 说明 |
|---|---|
| Windows 更新缓存 | SoftwareDistribution\Download |
| 内核崩溃转储 | LiveKernelReports / Minidump(实测单文件可达 4.7GB) |
| Chrome 端侧AI模型 | OptGuideOnDeviceModel(约4GB,删后建议禁用对应 flag 防重下) |
| NVIDIA 更新缓存 | ota-artifacts |
| pip/npm/yarn 缓存 | 包管理器缓存 |
| 临时文件 | Temp 目录 |
中优先级(谨慎清理)
| 类别 | 说明 |
|---|---|
| 应用缓存 | 各种应用程序缓存 |
| 日志文件 | 应用程序日志 |
| GPU 缓存 | 着色器缓存 |
低优先级(需确认)
| 类别 | 说明 |
|---|---|
| Gradle 缓存 | 构建缓存 |
| Cargo 缓存 | Rust 包缓存 |
| Go Modules | Go 包缓存 |
| Playwright 浏览器 | 测试浏览器内核,可一键重下 |
| 浏览器 IndexedDB | 网页应用离线数据/登录状态(v1.1 起从"高"降级:删后网站掉登录甚至丢数据) |
安全红线(永不清理)
系统还原点、Windows\Installer、Package Cache / InstallerCache(删了软件无法修复/卸载)、驱动库 DriverStore、用户文档/桌面/图片、微信QQ数据(Tencent Files / xwechat_files)、.ssh 等凭据目录。完整清单见 references/knowledge.md。
💡 清理完成后建议保留备份 7 天观察期——有些问题(如某应用下次启动才报错)当场看不出来。
工作原理
┌─────────────────────────────────────────────────────────────┐
│ 工作流程 │
├─────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ WizTree │───▶│ AI Agent │───▶│ 执行清理 │ │
│ │ 快速扫描 │ │ 智能分析 │ │ │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ │
│ │ │ │ │
│ ▼ ▼ ▼ │
│ MFT 扫描 智能模式识别 安全删除 │
│ (秒级完成) 优先级分类 确认后执行 │
│ │
└─────────────────────────────────────────────────────────────┘
配置
自定义清理规则
编辑 analyze.py:
CLEANABLE_PATTERNS = {
"high": {
"patterns": [
{"pattern": "你的模式", "name": "描述", "safe": True},
]
}
}
WizTree 路径
v1.1 起 scan.py 自动探测:环境变量 WIZTREE_PATH → 技能目录 WizTree\ → Program Files → PATH。也可直接指定:
$env:WIZTREE_PATH = "你的路径\WizTree64.exe"
贡献
欢迎提交 Pull Request!
许可证
MIT License - 详见 LICENSE
致谢
- WizTree - 世界上最快的磁盘空间分析器
- Claude Code - AI 驱动的 CLI 工具
免责声明
⚠️ 使用风险自负。 请在确认删除前仔细查看清理报告。作者不对任何数据丢失负责。
// HOW IT'S BUILT
// FILES
2 files shipped with this skill. Inline text is the catalog copy. The upstream link is the source repository.
SKILL.md6.5 KBupstream ↗
--- name: clean-c-drive description: 小白安全清理C盘(Windows)。当用户想清理C盘、磁盘空间不足、系统盘快满了、想安全释放空间时使用。WizTree扫描→模式库+知识库两层分析→清理方案经用户批复→备份后执行→观察期收尾。安全第一,不确定的一律不动。 --- # /clean-c-drive Skill 利用 WizTree 的快速扫描能力和 AI 的智能分析能力,安全清理 C 盘垃圾文件。 **安全铁律(任何情况下不可违背):** 1. 不确定用途的文件一律不动;用户说"不认识"的软件 → 列入红线并向用户询问。 2. **任何权限模式下,清理方案都必须经用户确认后才执行**——管理员权限只是免去手动跑脚本,不免审查(模式库认不出"用户常用但长得像垃圾"的东西)。 3. 清理前必须备份(backup.py),备份失败则中止清理。 4. 分析与出方案时必须对照 `references/knowledge.md`(安全红线清单 / 分层惯犯表 / 执行守则)。 ## 工作流程 ### 阶段 1: 检查权限和扫描数据 1. **检查管理员权限**: ```bash powershell -Command "([Security.Principal.WindowsPrincipal] [Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)" ``` 2. **如果有管理员权限(返回 True)**: - 检查技能目录 `data/` 下是否有 24 小时内的扫描文件 - 没有则自动扫描(WizTree 路径自动探测:环境变量 `WIZTREE_PATH` → 技能目录 `WizTree\` → Program Files → PATH): ```bash python "<技能目录>/scan.py" C: ``` 3. **如果没有管理员权限(返回 False)**: - `data/` 有现成数据就用;没有则提示用户: ``` 当前没有管理员权限,无法自动扫描。 请选择: 1. 以管理员权限重新启动 Claude Code(推荐,扫描/执行全自动) 2. 手动以管理员身份运行 WizTree,导出数据到 data 目录后再次运行此命令 (导出时"文件"和"文件夹"都要勾选;CSV 别存C盘) ``` ### 阶段 2: 分析扫描数据 ```bash python "<技能目录>/analyze.py" "<csv_file>" --min-size 50 ``` **两层分析,缺一不可:** - **模式库快筛**(analyze.py 自动完成):识别已知缓存/垃圾目录,按 高🔴/中🟡/低🟢 分级,红线目录已自动排除; - **知识库逐案研判**(AI 来做):模式库实测只能覆盖约 1/3 的可清理空间,剩下的大头——单个巨型转储、Chrome 端侧AI模型、软件多重安装、废弃应用数据、DISM 等系统官方机制可回收的空间——需要对照 `references/knowledge.md` 对目录/大文件排行逐案判断。 - 预估要保守:WinSxS 与 System32 之间大量硬链接,目录合计大于实际占用是正常现象。 ### 阶段 3: 生成清理方案(必须等用户批复) 向用户展示: 1. **磁盘概况**:总容量、已用、可用 2. **可清理项分级列表**:每项写清 路径 / 大小 / 是什么 / 删了会怎样 / 清理方式,**逐条编号**方便逐条批复 3. **红线清单**:明确列出本次绝不碰的内容 4. 询问用户选择清理级别或逐条批复。**未批复 = 不执行;沉默 ≠ 同意。** ### 阶段 4: 备份待清理目录 **在执行任何清理操作之前,必须先备份!** 1. 检查备份驱动器(自动选非C盘剩余空间最大的,最少需要 5GB): ```bash python "<技能目录>/backup.py" drive ``` 2. 创建备份(小于1GB直接复制,大于等于1GB压缩;生成 manifest.json): ```bash python "<技能目录>/backup.py" create --paths "路径1" "路径2" --priority high ``` 注意:robocopy 备份会保留隐藏/系统属性,核对备份目录时要用 `Get-ChildItem -Force`。 3. 备份失败(空间不足等)→ **中止清理**,提示用户处理。 ### 阶段 5: 执行清理 - **有管理员权限**:按批复方案执行,显示进度和逐项释放量 - **无管理员权限**:生成 `clean_<level>.ps1` 到技能目录,提示用户以管理员身份运行 - 执行前检查进程(生成的脚本已内置警告):浏览器 / VS Code / java(Gradle 守护进程)运行中会导致对应缓存清理不完整 - 生成的脚本已自动处理:清空目录时保留目录本身、排除 `claude*`(Claude Code 会话自身临时文件)、支持单文件目标 ### 阶段 6: 验证和确认 清理完成后,询问用户系统是否正常: ``` 清理已完成!请检查系统是否正常运行。 1. 系统正常 → 建议保留备份观察 7 天再删(有些问题当场看不出来,比如某应用下次启动才报错) 2. 出现问题 → 一键回滚,恢复备份 3. 稍后决定 → 保留备份,等待验证 ``` - 回滚:`python "<技能目录>/backup.py" restore --id <backup_id>` - 观察期满确认删除:`python "<技能目录>/backup.py" delete --id <backup_id>` ### 阶段 7: 清理临时文件 清理任务完成后,询问用户是否删除扫描数据和生成的清理脚本: ```bash python "<技能目录>/scan.py" --cleanup ``` 将清理 `data/*.csv` 和 `clean_*.ps1`。 ## 核心脚本 | 脚本 | 职责 | 常用命令 | |---|---|---| | `scan.py` | WizTree 自动扫描(路径自动探测;默认导出文件行) | `python scan.py C:`、`--latest`、`--cleanup`、`--folders-only` | | `analyze.py` | 流式解析 CSV(兼容 GUI/CLI 导出与中英文列名)、模式库分级、生成清理脚本 | `python analyze.py "<csv>" --min-size 50`、`--json`、`--output clean.ps1 --priority high` | | `backup.py` | 备份/回滚(manifest.json 清单化) | `drive` / `create` / `list` / `restore` / `delete` | ## 可清理目录与安全红线 完整定义见两处(修改时保持同步): - `analyze.py` 的 `CLEANABLE_PATTERNS`(模式库)与 `EXCLUDE_PATTERNS`(安全红线) - `references/knowledge.md`(完整知识库:红线表 / Tier分层惯犯表 / 惯犯定位正则 / 执行守则) ## WizTree 命令行参考 ```bash WizTree64.exe <drive> /export="<path>" /admin=1 /exportfolders=1 /exportfiles=1 /sortby=2 /exportdrivecapacity=1 /exportmaxdepth=0 ``` **为什么默认导出文件行(/exportfiles=1):** 实测最大的清理收益常来自单个巨型文件——4.7GB 内核转储、4GB Chrome 端侧AI模型、GB 级半成品下载——只导出文件夹时它们全部隐身。CSV 会变大(可能几百MB),analyze.py 流式解析不受影响;确需小体积用 `--folders-only`。README.mdupstream ↗
Contents are not inlined in the catalog. Open the upstream file.
Plain-text copy, no login: /skill-bundles/iziqing-disk-cleaner.md