存储分析器（Storage Analyzer）
一键扫描 Mac/Windows 整机磁盘，三级分类给清理决策，网页上可一键移废纸篓。
技能明确要求全程只读，删除操作仅展示命令或通过本地服务执行，且有严格白名单和二次确认。但是，具体执行依赖 agent 对 SKILL.md 的遵循，存在被绕过风险；删除功能涉及本地文件系统，对用户确认和权限控制依赖描述而非实际测试。因此不能给满分，扣除7分，因为仍缺少实际验证和潜在的授权流程复杂性。
文档提供了清晰的执行流程，脚本为纯标准库，但依赖系统命令和路径，静态审查无法验证其实际可用性。macOS 声称已测试，Windows 明确未测试。因此核心路径可能正常，但错误处理和边界情况未充分验证，若出现异常可能诊断困难。扣除2分，因未达到可充分依赖的程度。
技能明确针对存储分析场景，触发词丰富，并区分了 RAM 与存储，边界清晰。但环境适配方面，主要面向 macOS 和 Windows，对国内网络和系统环境适应良好，但依赖本地工具，不存在外网依赖。然而，仍可能存在未覆盖的场景或用户预期偏差，因此扣除3分，因为不能完全保证所有环境下的适用性。
文档结构良好，包含依赖、平台状态和常见问题，但缺少明确的版本号和变更日志，维护责任仅由作者个人承担，未提供更新路径。此外，部分细节如安装依赖说明不完整。因此扣除3分，因为治理和更新信息不完整。
技能声称能生成报告和提供清理建议，价值明显，但静态审查无法验证实际输出质量和用户操作便利性。虽然逻辑清晰，但实际效果依赖 agent 的分析能力，可能存在偏差。扣除8分，因无法直接验证其有效性。
仓库中有 macOS 和 Windows 的扫描代码，但没有任何测试文件或 CI 工作流来验证其正确性。README 声称部分已实测，但无第三方证据。因此仅能确认代码存在，无法验证其实际运行结果。扣除7分，因为缺乏可验证的客观证据。
- 删除功能依赖本地服务，其安全性未经过独立测试，使用前请仔细审查白名单和权限设置。
- Windows 平台代码未实测，首次使用需谨慎，清理前备份重要数据。
- 技能依赖 agent 对指令的遵循，若 agent 不严格遵守只读原则，可能造成数据丢失。
这个 Skill 能做什么，适合哪些场景？
这是一个面向 Agent 的存储分析技能：用一句自然语言触发，扫描 macOS 或 Windows 整机磁盘，找出占用空间的大户，并把每一项分成 🟢可自动清理 / 🟡需人工判断 / 🔴谨慎清理 三个级别，给出可执行的处置方案。最后生成一份排版精美、可折叠、命令一键复制的交互式 HTML 报告，可在网页上直接点击移除（移废纸篓或直接删除，均有二次确认）。扫描全程只读，绝不擅自删除文件；所有删除操作必须由用户在网页上确认后执行。
运行 Python 脚本（scan.py）扫描系统，自动识别 macOS 或 Windows；使用 du 或 os.scandir 统计各目录大小，输出 JSON 数据。Agent 基于数据做分析分级：识别 Top 5 占用大户、追查神秘大目录（如 UUID 命名的 Container）、判断每个大项属于哪一级清理建议。然后生成一份分析 JSON（schema 见 build_report.py），由 server.py 启动本地服务（127.0.0.1 + 随机端口 + token）打开交互式 HTML 报告，支持在网页上点击按钮执行「移废纸篓」或「直接删除」（通过 osascript 或 SHFileOperationW）。也可用 build_report.py 生成静态 HTML 文件（无删除按钮）。
- 用户说“我的 C 盘满了”，让 Agent 扫描磁盘并给出清理建议。
- 用户想知道“什么东西占了我 200GB 空间”，得到一份带路径和处置方案的三色清单。
- 用户想清理 Mac 上的缓存和临时文件，但不确定哪些能安全删除。
- 用户发现某个神秘的大文件夹（如 97GB 的 UUID Container），想确认它是什么并决定是否清理。
- 用户希望生成一份可分享的磁盘分析报告，保存为 HTML 文件。
这个 Skill 有哪些优点和局限？
- 全程只读扫描，绝不擅自删除文件，安全性有保障
- 三色分级清晰，每一项都有具体路径和处置建议
- 交互式 HTML 报告，命令一键复制，敲击即可执行
- 支持 macOS 和 Windows（macOS 完整实测）
- 纯 Python 标准库，零第三方依赖
- Agent 驱动，能识别神秘目录并给出个性化说明
- Windows 支持尚未在真实环境实测，可能存在未知问题
- 扫描较慢，大磁盘可能需要几分钟
- 清理命令需要在终端手动运行，或依赖网页按钮（需要开启服务）
- 报告生成需要本地 Python 环境（Windows 需手动安装）
如何安装这个 Skill？
在 Claude Code、Codex 等支持 Agent Skills 的工具里，直接说：
帮我安装这个 skill：https://github.com/KKKKhazix/khazix-skills/tree/main/storage-analyzer
Agent 会自动 clone 到对应目录。如果你的 Agent 不支持 Skill，把 storage-analyzer 目录下的 SKILL.md 全文下载下来，当项目规则文件或直接贴进对话。
如何使用这个 Skill？
安装后，在对话里用自然语言触发，例如：
帮我看看存储
C 盘满了
清理一下磁盘
看下电脑空间
storage analysis
Agent 会运行扫描脚本（可能需要几十秒到几分钟），生成分析，并自动打开浏览器展示交互式报告。在报告里，🟢 项可一键移废纸篓或直接删除，🟡 项可打开所在文件夹或移废纸篓（需二次确认），🔴 项只提供打开文件夹的按钮。本地服务运行在 127.0.0.1 的随机端口，使用 token 保护。