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 时不会改动环境;具体版本要求与命令以仓库自身配置为准,资料未提供其他平台或语言的支持说明。