SuperAPI AI 工具集

repo-healthcheck-node

编程与开发

查看项目

更新于 10-15 20:14

技能介绍

用途:验证 Node.js/TypeScript 仓库的开发环境是否正确搭建,并给出清晰的通过/失败汇总。

主要能力:按优先级读取 AGENTS.md、CLAUDE.md(若存在)、.nvmrc 或 .node-version、package.json 的 engines 字段,获取期望的 Node.js 版本、pnpm 版本、安装命令(默认 pnpm install)和构建命令(默认 pnpm build)。随后依次执行四项检查:Node.js 版本(node --version)、pnpm 版本(pnpm --version)、依赖安装、构建。版本比较采用前缀匹配,例如期望 24 可匹配任意 24.x.y。

使用方式:默认仅报告,不修改环境;传入 --fix 时尝试自动修复,例如依赖缺失时运行 pnpm install,Node.js 版本不符时运行 nvm install,pnpm 缺失或版本不符时运行 npm install -g pnpm@latest。若 Node.js 或 pnpm 这两项关键检查失败,会跳过依赖安装与构建检查并说明原因。输出包含汇总表,失败时附上可复制的修复命令和命令输出的末尾若干行。

适用场景:本地或 CI 中快速确认仓库工具链与依赖是否就绪,排查构建失败前的环境问题。

限制:未找到期望版本时仅作信息性报告,不判定失败;--fix 仅在显式传入时生效;具体仓库的版本与命令以仓库配置为准,资料未提供其他平台或收费信息。