Coding

hekouwang-env-doctor-skill

Try it

会勇禾口王 · 开发环境体检器(第三把 doctor)。扫描 Mac/Linux 上被开发工具占掉的磁盘空间,把每个目录判定成「数据 / 缓存 / 残留」三类,重点识别**你已经换掉但从没卸干净的旧工具**(如还留着 nvm 却早就在用 fnm),逐条给出判定依据、官方清理命令与代价。配交互式清理选择器(空格勾选、数据类锁死勾不上、确认后才执行、支持 --dry-run),删什么由你逐项勾。触发:用户说「磁盘满了 / 硬盘不够了 / 清理缓存 / 电脑越用越满 / 开发环境体检 / 查查什么占空间 / env-doctor / 环境体检 / disk doctor / 我的 Mac 空间去哪了 / node_modules 太大 / 缓存清理 / 残留清理 / 换过 nvm 想清干净」。任何「查/清 本机磁盘被开发工具占用」的请求都应触发。

What it does

会勇禾口王 · 开发环境体检器(第三把 doctor)。扫描 Mac/Linux 上被开发工具占掉的磁盘空间,把每个目录判定成「数据 / 缓存 / 残留」三类,重点识别**你已经换掉但从没卸干净的旧工具**(如还留着 nvm 却早就在用 fnm),逐条给出判定依据、官方清理命令与代价。配交互式清理选择器(空格勾选、数据类锁死勾不上、确认后才执行、支持 --dry-run),删什么由你逐项勾。触发:用户说「磁盘满了 / 硬盘不够了 / 清理缓存 / 电脑越用越满 / 开发环境体检 / 查查什么占空间 / env-doctor / 环境体检 / disk doctor / 我的 Mac 空间去哪了 / node_modules 太大 / 缓存清理 / 残留清理 / 换过 nvm 想清干净」。任何「查/清 本机磁盘被开发工具占用」的请求都应触发。

The skill document

开发环境体检器 · env-doctor

「体检器家族」第三把:claude-md-doctor(配置)→ skill-doctor(技能)→ env-doctor(环境)。 前两把体检文件,这把体检机器。

它跟市面清理工具差在哪(先读这条,它决定了全部行为)

市面上的 Mac 清理工具回答的是「哪个目录大」。 本器回答的是「这个工具你还在用吗」。

体积能扫出来,身份只能推理出来——要判断 nvm 是不是残留,得同时看 shell 配置加载了谁、PATH 里有谁、node 实际由谁提供、目录多久没动。这是本器唯一的差异化,任何改动都不许削弱它。


⛔ 三条铁律(细则见 references/safety.md

  1. 删除只能来自用户逐项勾选(走 scripts/clean.sh)。模型自己不拼 rm 去跑;用户说「你直接帮我删」→ 引导他跑选择器。默认全不选、数据类锁死、只跑白名单命令、输入 yes 才动手。
  2. 只读扫描scripts/scan.sh 不含任何写操作。
  3. 不确定就说不确定。信号矛盾时如实标注,不为报告好看而猜。

标准流程

第 1 步 · 扫描

bash scripts/scan.sh                      # 全量(含家目录大户发现,约 30–60 秒)
bash scripts/scan.sh --quick              # 快扫(跳过发现扫描,约 20 秒)
bash scripts/scan.sh --profile ai-dev     # AI 开发机快扫(Agent 宿主目录 + 跳过大户发现)

输出六节原始数据:DISK · SIZES · MANAGERS · RUNTIME · AI_AGENTS(有 Agent 宿主时)· DISCOVER(全量才有)。

第 2 步 · 判定

对照 references/rules.md

  • 三分法(数据 / 缓存 / 残留)给每个目录定身份;
  • 四信号判定表(shell_loaded × cmd_in_path × runtime owner × last_modified)判版本管理器是活跃还是残留;
  • 同一版本被两个管理器各装一份 → 单列一条提示。

第 3 步 · 出报告

references/report.md 的四步对话流程走:先给结论 → 分三组呈现(残留→缓存→数据)→ 逐组问用户 → 确认后才生成命令块

⚠️ 别把几十行清单一次糊给用户;⚠️ 每条建议必带「是什么 / 多大 / 凭什么判 / 官方命令 / 代价」五要素。

第 4 步 · 想清理时,交给选择器

bash scripts/clean.sh --dry-run   # 先看不执行(第一次强烈建议)
bash scripts/clean.sh             # 勾选后清理

交互式勾选:空格勾选 · ↑↓移动 · a全选 · n全不选 · 回车确认 · q退出。 数据类带 🔒 锁死勾不上;确认页逐条列出将执行的命令与代价,输入 yes 才动手。


路由

要做什么读哪个
判定某个目录属于哪一类、官方清理命令是什么references/rules.md
报告怎么写、对话怎么推进references/report.md
边界在哪、什么绝对不能做references/safety.md
扫描器实现与自检scripts/scan.sh
清理选择器(唯一允许删除处)scripts/clean.sh

常见追问的标准答法

  • 「你直接帮我删吧」 → 我不替你按回车。跑 bash scripts/clean.sh 勾选,它会先把命令和代价列给你看;想先看不执行就加 --dry-run
  • 「最大的那个能删吗」 → 先看身份不看体积。最大的往往是模型权重或容器卷(数据类),恰恰最不该删。
  • 「删完会怎样」 → 每条都有「代价」栏;缓存类一律「会重下,费时间和流量」,残留类才是净赚。
  • 「为什么判它是残留」 → 报出四信号原文,让用户自己复核。

边界

  • 只覆盖开发工具占用(版本管理器 / 包管理器 / 构建缓存 / 容器 / AI 模型)。系统缓存、照片、邮件附件、微信不在范围内——那些交给系统「存储空间」界面。
  • 家目录范围内扫描,不碰系统目录、不碰其他用户。
  • 不联网、不上报任何扫描结果。

体检器家族互链

Skill何时转交
配置hekouwang-claude-md-doctor-skillAGENTS.md/CLAUDE.md 重复、路由错、缺 frontmatter
技能hekouwang-claude-skill-doctor-skillSKILL.md 结构、死链、OpenClaw 声明
环境本 skill磁盘满、版本管理器残留、AI 宿主目录膨胀

报告里若发现配置/技能问题,点名另外两把,不要在本报告里硬做文件内容审计。

Related skills

AI-powered cross-platform disk storage analyzer. Scans system/user/dev space usage, generates interactive HTML report with 3-tier cleanup tiers (立即清/确认后清/保留)...

5 installs1 stars

Mac 磁盘空间盘点与清理建议技能。当用户说「硬盘不够用」「空间不足」「磁盘快满了」「帮我清理 Mac」「扫描大文件」「哪些可以删」时触发。 自动扫描系统、用户目录、开发项目中的空间占用,生成三级清理建议(立即清 / 确认后清 / 保留),提供可直接复制执行的命令。 绝不自动删除任何文件,只出报告和命令,执行前必...

1 installs

Intelligent disk space analysis and cleanup tool with safety grading, duplicate detection, and Chinese app cache recognition.

5 installs

Windows 文件管家与系统健康诊断(mac-health 的 Windows 原生版,供 WorkBuddy 等 Windows 端工具调用)。Always use when the user says「电脑管家」「文件整理」「C盘满了」「Windows清理」「磁盘整理」「电脑诊断」「清理一下」「哪些可以删」「系统整理」「电脑卡」「运行慢」「内存不足」「Windows 卡」「开机慢」。涉及删除或迁移时先诊断和校验,执行时保留清单与回滚线索。

面向电脑小白的 Windows C 盘清理助手(经真机实战验证)。两种模式:①开荒保洁——C盘已爆满时,先只读体检、用大白话讲清每类文件是什么/删了有啥影响,等用户逐条点头才动手,且一律只搬不删、可恢复;②日常保洁——记住你的清理习惯,定期自动体检或你随时喊一声,只清安全项。绝不自行删除任何文件,任何清理动作前必须取得用户明确同意。实战已验证:微信等聊天数据走官方"更改存储位置"迁移、可重建缓存只搬 Cache/Temp 子目录、软件主程序目录绝不碰、搬前检测进程锁防"半搬走"。触发词:"C盘满了""C盘爆红""清理C盘""C盘瘦身""腾空间""定期清理C盘""电脑卡"。

1 installs

会勇禾口王的AI笔记 · Agent Skill(SKILL.md)体检器。检查一个 Claude/Agent Skill 是否 符合"按需加载的指令包,不是单文件巨石"的最佳实践——评 description 触发质量、SKILL.md 篇幅、渐进披露(references/ 拆分)、脚本外置、可移植性(无硬编码绝对路径)、安全(无硬编码 密钥、宿主元数据与多 Skill 发现冲突),给出评分卡 + 按优先级的修复建议,并可代为重构。触发:用户说「检查我的 skill / SKILL.md 体检 / 这个 skill 规范吗 / claude-skill-doctor / audit skill / lint SKILL.md / 我的 skill 太长了 / skill 拆分 / 看看我的 skill 合不合规 / skill 对齐官方规范」。 任何"评估/审查/优化某个 Agent Skill 质量或结构"的请求都应触发。

2 installs