前言¶
本机磁盘被系统缓存、开发工具链和常用桌面应用慢慢占满，是日常开发里很常见的痛点。手工删目录既费时间，也容易误删还在用的数据。若在对话式 Agent 里处理，更需要一套可核对、可确认的流程，而不是一次性「全删」。
下面介绍 SkillHub 上的 WorkBuddy磁盘清理（坐标 @user_f1d11e73/zfl-workbuddy-disk-cleanup）：面向 WorkBuddy 磁盘清理与系统缓存清理，强调全量扫描、三级安全分级和「扫描 → 确认 → 清理」三步走。
这是什么¶
WorkBuddy磁盘清理 是社区来源（community）的 Agent Skill，发布者为 user_f1d11e73，在 SkillHub 分类为 it-ops-security。当前页面标注版本为 v3.11.18，标签 requires_api_key=false，安装与使用不依赖额外 API Key。
一句话定位：在 Agent 会话中引导完成本机缓存与大文件的扫描，按安全等级给出清理建议，并在用户确认后再执行清理，同时提供隔离区保护，降低误删风险。
核心功能¶
以下能力均来自 SkillHub 官方简介，未在页面单独展开的实现细节不在本文臆测。
全量扫描范围¶
Skill 声明支持多类目标的扫描，包括但不限于：
- 系统缓存
- 开发相关缓存
- 腾讯系应用缓存
- AI 工具缓存
- 微信数据
- 大文件
具体命中路径与规则由 Skill 包内说明驱动 Agent 执行；使用前应在「确认」步骤核对清单。
三级分级（G / Y / R）¶
清理建议按 G / Y / R 三级划分，用于区分相对安全、需谨慎、风险较高等档位（具体含义以 Skill 内指引为准）。Agent 应优先展示分级结果，避免把高风险项与可安全清理项混在一起一次性处理。
隔离区保护¶
简介提到 隔离区保护：对需要保留或待复核的内容，可通过隔离机制与直接删除区分开，减少误操作波及正在使用的数据。
三步流程¶
官方固定流程为：
- 扫描：发现可清理项并归类、分级。
- 确认：由用户或操作者逐项或按类确认是否清理。
- 清理：在确认后执行删除或移入隔离区等操作。
这与「让 Agent 直接删缓存」的做法不同，核心是先把结果摊开再动刀。
安装与启用¶
SkillHub 页面提供两种等价入口：用 CLI 安装，或把安装提示词交给当前 AI 按官方安装文档执行。
方式一：提示词安装（页面推荐）¶
将下面意图发给当前 Agent（页面原文）：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_f1d11e73/zfl-workbuddy-disk-cleanup`。
Agent 会按 SkillHub 安装与优先源配置 检查 skillhub CLI、选择正确的 skills 目录并完成安装。
方式二：skillhub CLI¶
先确认是否已安装 CLI：
command -v skillhub && skillhub --version
未安装时，官方文档提供完整安装（CLI + 默认 Skill）或仅 CLI：
# 完整安装（CLI + 默认 Skill，推荐）
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
# 仅安装 CLI
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安装本 Skill 时，必须用 --dir 指向当前 Agent 实际使用的 skills 目录；装到默认 ./skills/ 可能不会被识别。官方文档列出的常用路径包括：
| 环境 | skills 目录 |
|---|---|
| WorkBuddy | ~/.workbuddy/skills/ |
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
在 WorkBuddy 场景下，安装命令形态为：
skillhub install @user_f1d11e73/zfl-workbuddy-disk-cleanup --dir ~/.workbuddy/skills/
（若当前 Agent 不是 WorkBuddy，将 --dir 换成上表中对应路径。）
安装后按所用客户端要求重启或刷新 Skill 列表，再在对话中唤起「磁盘清理」「扫描缓存」等意图即可。
典型用法¶
公开页面未附带独立命令行 demo，典型用法应贴合官方三步流程，在 Agent 对话中复现：
- 说明需求，例如：「扫描本机可清理的缓存和大文件，先不要删除。」
- 查看 Agent 返回的扫描结果与 G/Y/R 分级，重点核对微信数据、开发目录、大文件等敏感项。
- 明确确认要清理的类别或条目后，再让 Agent 执行清理；对不确定项要求跳过或走隔离区。
- 清理完成后可再次发起扫描，确认空间变化与是否仍有残留项。
因 Skill 基于通用 SKILL.md 格式，具体子命令、脚本路径以安装包内 SKILL.md 为准；本文不编造未公开的脚本名或配置字段。
适用场景与注意¶
适合谁
- 使用 WorkBuddy 或已把 Skill 装到对应 skills 目录的开发者、运维同学。
- 需要在 Agent 里做「先看清单再清理」的本机磁盘维护，尤其涉及多类缓存与大文件时。
限制与注意
- 分类为
it-ops-security，操作仍可能影响本机数据；确认步骤不可省略，微信数据、开发项目缓存等务必人工过目。 - G/Y/R 是安全提示，不能替代你对业务目录的了解；红色档位应默认不清理，除非明确知悉后果。
- SkillHub 抓取资料显示：评分 100000，下载 1721，安装计数 0（页面统计，随平台更新变化）。社区 Skill，维护节奏以发布者为准。
- 未要求 API Key，但清理行为发生在本地环境，注意备份与权限（公司设备需符合内控规定）。
结尾¶
WorkBuddy磁盘清理 把「扫一遍、看清楚、再动手」固化进 Agent Skill：覆盖多类缓存与大文件，用 G/Y/R 分级和隔离区降低误删概率，适合作为本机磁盘例行整理的对话式入口。
- SkillHub 页面：https://www.skillhub.cn/skills/user_f1d11e73/zfl-workbuddy-disk-cleanup
- 资源坐标（API）：https://api.skillhub.cn/user_f1d11e73/zfl-workbuddy-disk-cleanup
- 安装说明：https://skillhub.cn/install/skillhub.md
