SuperAPI AI 工具集

nodejs-best-practices

编程与开发

查看项目

更新于 10-16 01:34

技能介绍

用途:该技能是 Nearform 维护的 Node.js 与 Fastify 应用综合指南,适用于编写、审查或重构 Node.js/Fastify 代码时参考,覆盖新建 API 与路由、数据库操作、性能与安全审查、响应时间优化、错误处理与日志、监控与可观测性搭建等场景。

主要能力:包含 48 条规则,分 8 类并按影响优先级排序。性能与安全(CRITICAL,perf-)涵盖事件循环阻塞、安全响应头、输入校验、流式传输、内存泄漏、压缩;API 设计与数据库(CRITICAL,api-)涵盖 REST 设计、分页、连接池、查询优化、N+1 问题、事务;错误处理与日志(HIGH,error-)涵盖集中式错误中间件、Pino 结构化日志、异步错误、敏感数据、未处理拒绝、请求日志;Fastify 优化(MEDIUM-HIGH,fastify-)涵盖 JSON Schema 校验、钩子、插件、装饰器、序列化、内容类型;异步模式(MEDIUM,async-)涵盖并行化、错误处理、背压、限流、队列、超时;缓存与状态(MEDIUM,cache-)涵盖 LRU、Redis、HTTP 缓存头、失效、stale-while-revalidate、数据库缓存;代码组织(LOW-MEDIUM,code-)涵盖模块结构、依赖注入、配置管理、环境变量、测试、TypeScript;监控与诊断(LOW,monitor-)涵盖健康检查、指标、APM、内存、CPU、分布式追踪。

使用方式:按需阅读各规则文件,如 rules/perf-block-event-loop.md、rules/api-n-plus-one.md、rules/_sections.md;每条规则含原因说明、错误代码示例、正确代码示例及补充参考。完整展开版见 AGENTS.md。

限制:资料未提供安装命令、收费方式、平台支持与效果数据。