SuperAPI AI 工具集

nodejs-best-practices

编程与开发

查看项目

更新于 10-16 06:48

技能介绍

用途:该技能用于在 Node.js 开发中做架构与工程决策,包括框架选择、异步模式设计、安全与部署实践。它强调传授决策原则而非固定代码模板,遇到不明确处应先询问用户偏好,并依据具体上下文选择方案。

主要能力:提供 2025 年框架选型决策树(边缘/无服务器选 Hono,高性能 API 选 Fastify,企业/团队熟悉选 NestJS,遗留/生态最大选 Express,全栈配前端选 Next.js API Routes 或 tRPC);运行时考量(Node.js 22+ 的 --experimental-strip-types 可直接运行 .ts,ESM 与 CommonJS 取舍,Node.js/Bun/Deno 适用场景);分层架构(控制器/路由、服务、仓储三层及其可测试性与灵活性);集中式错误处理与状态码选择(400/401/403/404/409/422/500);异步模式(async/await、Promise.all、allSettled、race 的适用场景,I/O 与 CPU 密集任务区分,避免阻塞事件循环);校验原则(在边界校验,Zod/Valibot/ArkType/Yup 选型);安全清单(输入校验、参数化查询、bcrypt/argon2、JWT 校验、限流、Helmet、HTTPS、CORS、环境变量密钥、依赖审计);测试策略(单元用 node:test 或 Vitest,集成用 Supertest,E2E 用 Playwright,Node.js 22+ 可用 node --test src/**/*.test.ts);反模式与决策清单。

使用方式:在需要做 Node.js 架构决策、选框架、设计异步模式或应用安全与部署实践时启用。按决策清单逐项确认:是否询问用户技术栈偏好、是否针对当前上下文选框架、是否考虑部署目标、是否规划错误处理、是否识别校验点、是否考虑安全需求。

适用场景:新项目技术选型、既有项目架构调整、异步与错误处理设计、安全加固、测试策略制定。

限制:仅适用于与上述范围明确匹配的任务;输出不能替代针对具体环境的验证、测试或专家评审;若缺少必要输入、权限、安全边界或成功标准,应停止并请求澄清。具体收费、价格与平台信息暂未提供。