SuperAPI AI 工具集

nodejs-backend

编程与开发

查看项目

更新于 10-15 22:17

技能介绍

用途:为 Node.js 后端开发提供一套工程规范与参考,覆盖分层架构、TypeScript 用法、校验、错误处理、安全、可观测性、日志、指标和部署。

主要能力:给出目录分层约定(routes、middleware、services、repositories、config、types),要求路由不含业务逻辑、服务不引入 Request/Response、仓储不抛 HTTP 错误,依赖只向内指向 routes -> services -> repositories。TypeScript 方面建议用 import type、优先 interface、用 unknown 替代 any、以 z.infer 作为类型与 schema 的单一来源、减少 as 断言、为导出函数加显式返回类型。工作规则要求校验请求与第三方数据、保持响应序列化与错误信封显式、保留调用方可见契约与授权、限制并发并设置超时、避免阻塞生产请求路径、验证资源身份后再解析或缓存、演练遥测与失败路径。

使用方式:实现前先查与版本匹配的官方文档(如 Express 5、Fastify 5、Node.js 22+ 内置 API),优先使用 Context7 的 query-docs,否则用可用的网络工具查阅官方文档。按主题阅读对应参考文件:api-boundaries.md(框架选择、输入校验、API 契约、错误)、async-and-production.md(并发、网络、启动、缓存、生命周期清理、遥测)、observability-tracing.md(span 类型、HTTP 状态到 span 状态规则、采样位置、指标基数、遥测数据治理)。验证要求 tsc --noEmit 零错误、npm test 零失败、新代码无 TypeScript 绕过。

适用场景:编写或审查 Node.js 后端服务、API 边界、异步与生产环境行为、可观测性相关代码时。

限制:资料未提供具体安装命令、收费方式、平台支持与效果数据;脚本或原型可用单文件,但需评估是否会增长。新增抽象前需确认其在 3 处以上出现,否则内联。