⚠️

重要前提

安装AI Skills的关键前提是：必须科学上网，且开启TUN模式，这一点至关重要，直接决定安装能否顺利完成，在此郑重提醒三遍：科学上网，科学上网，科学上网。查看完整安装教程 →

Fastify 最佳实践指南：生产级 Node.js 应用开发规则与模式

fastify-best-practise by thecodepace/fastify-skills

47 周安装量

2 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/thecodepace/fastify-skills --skill fastify-best-practise

Node.js 编程最佳实践 API

🇨🇳中文介绍

Fastify 最佳实践

一套精心整理的规则和模式，用于构建生产就绪的 Fastify 应用程序。每条规则都包含错误和正确的示例及解释。

工作原理

智能体识别用户正在使用 Fastify 或询问 Fastify 模式
根据主题（路由、验证、封装等）加载相关的规则文件
智能体在生成或审查代码时应用规则中的最佳实践

规则

规则按主题组织在 rules/ 目录中。每条规则都遵循一致的格式，包含影响评级、错误/正确示例以及官方文档的引用。

规则	文件	影响	描述
配置	configuration.md	高	环境配置、日志记录器设置、安全选项和优雅关闭
创建服务器	create-server.md	低-中	使用 `buildServer()` 工厂函数实现可重用、可测试的服务器设置

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

FlyClaw：零登录航班聚合查询工具，Python实现多源航班信息与价格搜索

4,000,000 周安装

SoulTrace 人格评估 API - 基于五色心理模型的贝叶斯自适应测试

93,500 周安装

Lark CLI IM 即时消息管理工具：机器人/用户身份操作聊天、消息、文件下载

48,700 周安装

lark-cli 共享规则：飞书资源操作指南与权限配置详解

48,600 周安装

新项目设置 : create-server.md, configuration.md, autoload.md, encapsulation.md, typescript-integration.md
添加路由 : route-best-practices.md, autoload.md, schema-validation-zod.md
添加共享服务 : create-plugin.md, autoload.md, encapsulation.md
配置/环境 : configuration.md
错误处理 : error-handling.md
身份验证/中间件 : authentication.md, hooks-lifecycle.md, encapsulation.md
自定义装饰器 : decorators.md, typescript-integration.md
日志记录 : logging.md
请求体解析/文件上传 : content-type-parser.md
编写测试 : testing.md, create-server.md

src/
  plugins/          # 自动加载 — 共享插件 (使用 fastify-plugin)
    db.ts
    auth.ts
    config.ts
  routes/           # 自动加载 — 封装的路由插件 (不使用 fastify-plugin)
    _hooks.ts       # 全局路由钩子 (使用 autoHooks: true)
    users/
      index.ts      # → /users
      _hooks.ts     # 仅适用于 /users 作用域的钩子
      schema.ts
    posts/
      index.ts      # → /posts
      schema.ts
  server.ts         # 包含自动加载注册的 buildServer()
  app.ts            # 入口点 — 调用 buildServer() 和 listen()
test/
  routes/
    users.test.ts
    posts.test.ts
  helpers.ts        # createTestServer() 辅助函数

🇺🇸English

Fastify Best Practices

A curated set of rules and patterns for building production-ready Fastify applications. Each rule includes incorrect and correct examples with explanations.

How It Works

The agent identifies that the user is working with Fastify or asking about Fastify patterns
The relevant rule file is loaded based on the topic (routes, validation, encapsulation, etc.)
The agent applies the best practices from the rule when generating or reviewing code

Rules

The rules are organized by topic in the rules/ directory. Each rule follows a consistent format with impact rating, incorrect/correct examples, and references to official docs.

Rule	File	Impact	Description
Configuration	configuration.md	HIGH	Environment config, logger setup, security options, and graceful shutdown
Create Server	create-server.md	LOW-MEDIUM	Use a `buildServer()` factory function for reusable, testable server setup
Create Plugin	create-plugin.md	LOW-MEDIUM	Encapsulate reusable functionality in plugins with `fastify-plugin`
Autoload	autoload.md	HIGH	Automatically load plugins and routes from the filesystem with `@fastify/autoload`
Route Best Practices	route-best-practices.md	MEDIUM	Organize routes with plugins/prefixes, use async handlers, full route options
Schema Validation (Zod)	schema-validation-zod.md	HIGH	Type-safe validation with Zod + `fastify-type-provider-zod`
Encapsulation	encapsulation.md	HIGH	Proper scope isolation and when to use `fastify-plugin`
Error Handling	error-handling.md	HIGH	Custom error handlers, `@fastify/error`, 404 handling, structured responses
Hooks & Lifecycle	hooks-lifecycle.md	MEDIUM	All request/reply and application hooks: onRequest, preParsing, preValidation, preHandler, preSerialization, onError, onSend, onResponse, onTimeout, onRequestAbort, onReady, onListen, onClose, onRoute, onRegister
Logging	logging.md	HIGH	Built-in Pino logger, request correlation, redaction, child loggers
Authentication	authentication.md	HIGH	JWT auth with `@fastify/jwt`, multi-strategy with `@fastify/auth`
Testing	testing.md	HIGH	Test with `inject()`, buildServer pattern, vitest/node:test
TypeScript	typescript-integration.md	MEDIUM	Type providers, module augmentation, typed decorators
Decorators	decorators.md	MEDIUM	Extend the Fastify instance, request, and reply with `decorate` / `decorateRequest` / `decorateReply`
Content Type Parser	content-type-parser.md	HIGH	Custom content type parsers, body limits, multipart uploads, catch-all and regex matching

Usage

When generating Fastify code, read the relevant rule file(s) for the topic and apply the patterns shown. For a new project, all rules are relevant. For specific tasks, load only what's needed:

New project setup : create-server.md, configuration.md, autoload.md, encapsulation.md, typescript-integration.md
Adding routes : route-best-practices.md, autoload.md, schema-validation-zod.md
Adding shared services : create-plugin.md, autoload.md,

Recommended Project Structure

Using @fastify/autoload, plugins and routes are loaded automatically from their directories:

src/
  plugins/          # Autoloaded — shared plugins (use fastify-plugin)
    db.ts
    auth.ts
    config.ts
  routes/           # Autoloaded — encapsulated route plugins (NO fastify-plugin)
    _hooks.ts       # Global route hooks (with autoHooks: true)
    users/
      index.ts      # → /users
      _hooks.ts     # Hooks for /users scope only
      schema.ts
    posts/
      index.ts      # → /posts
      schema.ts
  server.ts         # buildServer() with autoload registration
  app.ts            # Entry point — calls buildServer() and listen()
test/
  routes/
    users.test.ts
    posts.test.ts
  helpers.ts        # createTestServer() helper

Present Results to User

When applying these best practices, mention which rule(s) you followed:

Applied Fastify best practices:

Route organization : Routes grouped by resource with prefixes

Zod validation : Request/response schemas with type inference

Encapsulation : Shared plugins use fastify-plugin, routes stay scoped

Error handling : Custom error handler with @fastify/error

Reference

Weekly Installs

Repository

thecodepace/fas…y-skills

GitHub Stars

First Seen

Feb 19, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

github-copilot45

cursor44

gemini-cli44

amp44

codex44

kimi-cli44