npm脚本Windows兼容性修复
扫描并重写 package.json 中仅适用于 Unix 的脚本指令,消除在 Windows CMD 与 PowerShell 环境下的执行报错。
功能与用途
该工具用于修复 Node.js 项目在 Windows 原生命令行中执行 npm 脚本时的跨平台兼容报错。输入为项目根目录路径或指定的 package.json 文件。系统会自动扫描内联环境变量、类 Unix 文件命令、单引号传参及通配符展开等阻断问题,生成基于 cross-env、shx 等跨平台依赖或原生 Shell 语法的改写脚本并补齐依赖。本工具硬性要求在 Windows 原生终端(CMD 或 PowerShell)中运行,不支持 WSL 与 Git Bash 等 POSIX 环境。
适用场景
- 跨平台团队脚本标准化:团队成员在 macOS 或 Linux 上编写了包含 rm -rf 等命令的脚本,导致 Windows 开发者拉取后执行报错,需转换为跨平台
- 内联环境变量传参修复:解决脚本中因 NODE_ENV=production 前缀导致 CMD 将其误判为未知命令的问题,自动采用 cross-env 包裹改写。
- 单引号与通配符展开适配:针对 Windows 终端将单引号作为字面量传递或无法自动展开测试文件通配符的缺陷,规范参数转义与路径匹配方案。
- 无额外依赖的原生改写:在不想引入额外 devDependencies 时,根据用户当前使用的 CMD 或 PowerShell 终端,直接改写为 Windows
适用人群
- 在 Windows 本地开发前端或 Node.js 项目的全栈开发者
- 需要让开源项目在多系统平稳构建的开源仓库维护者
- 遇到 rm -rf 或环境变量未识别等 npm run 报错的 Windows 程序员
使用步骤
- 在 Windows 终端中运行 `/windowsfy [项目路径或package.json文件路径]`
- 环境守卫脚本自动检测当前 Shell,拦截非原生 Windows 终端并确认交互式终端类型(CMD、PS 5.x 或 PS 7+)
- 检视按严重程度汇总的问题清单(包括原生依赖、环境变量、单引号、Unix命令等)
- 选择需要修复的问题类别以及修复模式(推荐跨平台依赖方案或 CMD/PowerShell 专用回退方案)
- 自动执行精准文本替换并在必要时安装 cross-env 或 shx 等依赖
- 脚本执行二次扫描复查,确认所有兼容性隐患已清除
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 进阶
- 版本
- main
- 最近更新
- 2026-09-24
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
依赖与权限
- 读取用户主动提供的内容