前言¶

磁盤告警、備份膨脹、開發機突然變慢，常見第一步是找「誰佔空間」。手工在資源管理器裏翻目錄，或臨時拼一條 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