用途:快速搭建并验证 Node.js/TypeScript 开发环境及其工具链。
主要能力:按清单检查 Node.js 18+ 与 npm 9+,识别使用的包管理器(npm/yarn/pnpm),安装依赖,核对 package.json 脚本,配置 ESLint、Prettier、TypeScript(如适用)、Jest/Vitest 测试与 Husky + lint-staged Git 钩子,并验证构建、执行质量检查与测试运行。
常用命令示例:npm install <package>、npm install -D <package>、npm run dev、npm run build、npm test、npm run lint、npm run format;Yarn 对应为 yarn add <package>、yarn add -D <package>、yarn remove <package>、yarn upgrade、yarn audit。
问题处理:报错 npm: command not found 时先安装 Node(macOS 可 brew install node,或使用 nvm);报错 Cannot find module 时删除 node_modules 与 package-lock.json 后重新 npm install;权限报错需调整全局 npm 权限;TypeScript 在 node_modules 中报错可在 tsconfig.json 开启 skipLibCheck;ESLint 与 Prettier 冲突可安装 eslint-config-prettier 并在 extends 末尾加入 prettier。
实践建议:使用 nvm 管理 Node 版本、提交 package-lock.json 锁定依赖、用 --save-dev 区分开发依赖、开启 TypeScript 严格模式、统一 ESLint 与 Prettier 配置、用 Husky 自动化检查、追求 90% 以上覆盖率并定期执行 npm audit。
适用场景:新建或接手 Node.js/TypeScript 项目时的环境初始化与质量工具配置。该技能也可能被 quality-check、run-tests 等技能调用。
限制:以上为技能说明中列出的流程,具体版本要求与命令适用性以实际项目为准;其余细节暂未提供。