前言¶

磁盘告警、备份膨胀、开发机突然变慢，常见第一步是找「谁占空间」。手工在资源管理器里翻目录，或临时拼一条 du/Get-ChildItem，往往慢、难复现，也不方便交给 Agent 做后续清理建议。

下面介绍 SkillHub 上的社区 Skill「查找系统最大文件」（坐标 @user_33bff772/file-size-top10）。它把扫描规则、参数和输出格式写进 SKILL.md，让支持 Skills 的 Agent 在 Windows 环境下按同一套流程列出指定目录下按大小排序的前 10 个文件，并附带 JSON 块便于解析。

这是什么¶

「查找系统最大文件」是社区来源（community）的 Agent Skill，版本 1.0.0，发布者为 user_33bff772，分类为 it-ops-security。SkillHub 页面显示评分为 100000，下载约 850 次；标签标明 requires_api_key=false，安装后无需额外 API Key。

包内 skill.json 的定位是：在 Windows 系统中按文件大小找出前 10 大的文件。入口脚本在元数据中声明为 run.ps1；当前安装包除 SKILL.md、skill.json 外不含独立脚本文件，具体 PowerShell 逻辑与调用方式以 SKILL.md 为准。

核心功能¶

依据 SKILL.md 与 skill.json，已核实能力如下：

1. 扫描用户指定目录下的文件，按大小降序取前 10 名。
2. 支持参数 path（目录，默认当前目录 .）、depth（目录深度，-1 表示不限制）、unit（显示单位 auto / MB / GB）。
3. 终端侧彩色表格输出，并包含扫描统计（总文件数、总大小、耗时）。
4. 在输出中嵌入 ---JSON_OUTPUT_START--- / ---JSON_OUTPUT_END--- 包裹的 JSON，字段含 scan_path、total_files、top10（含 rank、size_bytes、path、last_modified 等），便于 Agent 或 OpenClaw 类宿主解析。

说明：文档标题与 Skill 中文名中的「系统」指 Windows 文件系统场景，并非跨平台通用磁盘分析工具。

安装与启用¶

方式一：让 Agent 按官方提示安装¶

SkillHub 页面提供的安装提示为：

请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_33bff772/file-size-top10`。

Agent 读取该安装文档后，可使用 skillhub CLI 将技能装到当前客户端的 skills 目录。

方式二：skillhub CLI¶

先确认 CLI 是否可用（见 SkillHub 安装文档）。安装本 Skill 时需指定命名空间，并用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被识别：

skillhub install file-size-top10 --namespace user_33bff772 --dir ~/.cursor/skills/

常见路径（摘自官方安装文档，按你实际使用的客户端选择）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

安装完成后，按各客户端要求刷新或重启 Agent，使新 Skill 被加载。

典型用法¶

SKILL.md 中的基本调用方式为 PowerShell 脚本 run.ps1（参数与 skill.json 的 arguments 一致）：

# 扫描当前目录
./run.ps1

# 扫描指定目录
./run.ps1 -path "C:\Users"

# 限制扫描深度为 2 层
./run.ps1 -path "D:\Projects" -depth 2

# 使用 GB 单位显示
./run.ps1 -unit "GB"

启用 Skill 后，也可在自然语言中描述需求，例如「扫描 D:\Data，深度 2，列出最大的 10 个文件」，由 Agent 按 Skill 约定执行上述参数组合并解读 JSON 输出。

适用场景与注意¶

适合谁

• 在 Windows 服务器或工作站上做磁盘排查、清理前摸底。
• 希望把「找大文件」固定成 Agent 可重复执行的流程，而不是每次重写命令。

限制与注意

1. 平台：面向 Windows + PowerShell；Linux/macOS 上应使用其他工具或 Skill，不要直接套用 run.ps1 示例路径。
2. 权限与耗时：深度无限制扫描大目录可能较慢；无权限访问的路径会被跳过（脚本中对单文件错误做了静默处理）。
3. 包内容：若本地仅有 SKILL.md 而无 run.ps1 文件，需按文档中的脚本说明在目标环境准备入口脚本，或由 Agent 在会话中按文档执行等价 PowerShell。
4. 安全：扫描结果可能包含用户目录、日志、数据库文件等敏感路径，对外分享报告前请脱敏。

结尾¶

「查找系统最大文件」把 Windows 下 Top 10 大文件扫描的参数、表格输出和 JSON 结构写进 Skill，适合运维与开发在 Agent 里做可复现的磁盘摸底。官方页面与 API 入口：

• https://www.skillhub.cn/skills/user_33bff772/file-size-top10
• https://api.skillhub.cn/user_33bff772/file-size-top10