nodejs-expert 是一份面向 AI 消费的参考文档，优化目标是让 Claude 在代码执行过程中直接读取，用于快速查阅 Node.js 的常见陷阱与相关技术决策标准。据资料说明，人类可读的详细解释见 docs/architecture/HIERARCHICAL_PLANNING.md 或 docs/getting-started/ 下的相应主题（具体内容暂未提供）。
用途方面：该技能定位为执行期参考资料，帮助模型在编写或审查 Node.js/Express/NestJS 代码时避免常见错误，并在选型问题上给出判断依据。资料建议使用 Context7 获取 Express、NestJS、Fastify 的文档。
主要能力包括两部分。一是决策标准：框架选择 Express（简单 API）、NestJS（企业级/依赖注入/装饰器）、Fastify（高性能）；ORM 选择 Prisma（开发体验与类型最佳）、TypeORM（Active Record 模式）、Drizzle（类 SQL 且轻量）；校验库选择 Zod（TypeScript 优先的类型推断）、Joi（运行时 schema）、class-validator（NestJS 装饰器）；鉴权选择 JWT（无状态/微服务）与会话（单体/服务端渲染）。二是常见陷阱：forEach 不等待异步，应使用 for...of 或 Promise.all(items.map(async ...))；Express 错误处理中间件必须保留四个参数（err, req, res, next），否则会被忽略；未处理的 Promise 拒绝在 Node 15+ 会导致崩溃，需捕获或监听 process.on('unhandledRejection')；可用 asyncHandler 包装路由捕获异步错误并传给 next(err)；缺少 express.json() 中间件时 req.body 为 undefined；process.env.PORT 是字符串，比较前需 parseInt() 或 Number()；NestJS 中 @Injectable() 需在 @Module({ providers: [...] }) 注册，遗漏会导致运行时错误；大数据的可写流需处理 drain 事件以应对背压；ESM 中没有 __dirname，应使用 import.meta.dirname（Node 21+）或 fileURLToPath(import.meta.url)。
使用方式：资料未提供独立的安装命令或运行步骤，仅说明其作为 AI 执行期阅读的参考内容存在。适用场景为 Node.js 后端开发中的技术选型与代码审查。限制与收费等信息暂未提供。