SuperAPI AI 工具集

nodejs-best-practices

编程与开发

查看项目

更新于 10-16 09:29

技能介绍

用途:该技能用于在 Node.js 开发中做架构决策,包括框架选择、异步模式设计、安全与部署实践。它强调传授决策原则而非固定代码模板,遇到不明确需求时应先询问用户偏好,并根据具体上下文选择方案,避免每次默认同一套解法。

主要能力:提供 2025 年框架选型决策树,如边缘/无服务器场景考虑 Hono、高性能 API 考虑 Fastify、企业团队熟悉度考虑 NestJS、遗留与生态最大考虑 Express、全栈配合前端考虑 Next.js API Routes 或 tRPC;比较冷启动、生态、TypeScript 支持与学习曲线。运行时方面涉及 Node.js 22+ 的 --experimental-strip-types、ESM 与 CommonJS 取舍,以及 Node.js、Bun、Deno 的适用场景。架构上给出控制器/路由、服务、仓储三层职责划分及何时简化。错误处理涵盖自定义错误类、顶层中间件捕获、状态码选择(400/401/403/404/409/422/500)与日志策略。异步模式区分 async/await、Promise.all、Promise.allSettled、Promise.race,并提醒 CPU 密集任务应使用 worker 线程或卸载。校验强调在边界处校验,并列出 Zod、Valibot、ArkType、Yup 的适用场景。安全清单包括输入校验、参数化查询、bcrypt/argon2、JWT 校验、限流、Helmet、HTTPS、CORS、环境变量密钥与依赖审计。测试部分介绍单元、集成、E2E 及 Node.js 22+ 的 node --test。

使用方式:作为决策参考,在实现前依次确认技术栈偏好、当前上下文框架、部署目标、错误处理策略、校验点与安全需求。

适用场景:Node.js 架构设计、框架选型、异步与安全实践评审。

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