npkill

核心用法

NPkill 是一款专为 JavaScript 和 Next.js 开发者设计的磁盘清理工具使用指南，核心功能是识别并删除累积的 node_modules 和 .next 构建文件夹。该 skill 本身不执行任何操作，而是提供完整的 npkill CLI 工具使用文档，包含交互式清理、定向扫描、干运行预览等多种模式。

主要命令包括：基础交互模式 npkill 允许逐项浏览和选择性删除；--target .next 专门针对 Next.js 构建产物；--dry-run 模式可在实际删除前预览所有将被清理的文件夹；--delete-all --yes 则提供自动化批量删除能力（需谨慎使用）。此外还支持 --gb 以 GB 单位显示大小、、--directory 指定扫描起点等实用选项。

显著优点

该 skill 的最大优势在于安全性设计完善。文档反复强调 --dry-run 预览机制，将"先预览、后执行"作为核心使用原则。交互式模式要求用户逐项确认，有效避免误删。同时明确标注系统保护目录警告（⚠️），并提供 --exclude 排除机制，形成多层防护。

其次，场景针对性强。不同于通用清理工具，该 skill 精准聚焦 JavaScript 生态的两大空间杀手——node_modules 依赖文件夹和 Next.js 的 .next 构建产物，命令设计直接对应开发者日常痛点。体积显示支持 GB 单位，对大容量清理场景更友好。

第三，学习成本低。所有命令均为单行动 bash 指令，无需复杂配置。文档结构清晰，按"何时使用→核心命令→安全特性→最佳实践"递进，新手可快速上手。

潜在缺点与局限性

依赖外部工具是首要限制。用户需自行执行 npm install -g npkill 安装，skill 本身无法自动完成环境准备。若 npm 源不稳定或权限配置不当，可能遇到安装障碍。

功能边界有限。该 skill 纯为文档型，不包含自动化脚本或智能判断逻辑，所有决策依赖用户手动执行。对于需要定期自动清理的 CI/CD 场景，或希望一键完成多项目维护的用户，体验不够流畅。

环境兼容性存疑。文档提及"交互模式需要终端支持方向键"，在部分 IDE 集成终端、远程 SSH 会话或容器环境中，TUI 界面可能出现渲染异常。此外，npkill 对保护目录的识别基于预设规则，特殊定制环境可能存在漏判风险。

适合的目标群体

• 本地开发频繁的 JavaScript/TypeScript 开发者：长期积累多个项目 node_modules，磁盘空间紧张
• Next.js 项目维护者：需要定期清理 .next 构建缓存以解决构建异常或释放空间
• 全栈工程师/技术负责人：管理多个代码仓库，需要统一的空间治理方案
• 教学/培训场景讲师：帮助学员理解依赖管理成本，建立良好的开发环境维护习惯

不适合对删除操作有严格审计要求的生产服务器环境，以及需要完全自动化无人值守清理的流程。

使用风险

1. 误删风险：尽管有 dry-run 机制，若用户跳过预览直接执行 --delete-all --yes，可能误删正在使用的项目依赖，导致开发环境损坏
2. 工具版本差异：npkill 不同版本的行为细节可能有变化，文档未指定推荐版本，极端情况下可能出现兼容性问题
3. 性能影响：全盘扫描大型文件系统时，npkill 可能短暂占用较高 I/O 资源，影响同期进行的其他操作
4. 权限问题：清理某些目录可能需要提升权限，用户若使用 sudo 运行可能扩大潜在影响范围