fastify-best-practices

fastify-best-practices 技能概览

这个技能是用来做什么的

fastify-best-practices 是一个实用的 Fastify 指导技能，适合用来构建和排查基于 TypeScript 或 JavaScript 的 Node.js 后端、API 和服务。当你需要围绕 Backend Development 处理 fastify-best-practices 时，它尤其有用，比如选择合适的 plugin 模式、连接 routes、校验 payload、处理 auth，或避免那些会拖慢交付的常见 Fastify 误区。

适合谁使用

如果你正在新建一个 Fastify 应用、重构已有项目，或者想让生产服务更安全、更易维护，就可以使用这个 fastify-best-practices 技能。它适合希望获得比泛泛提示更具体建议的后端开发者，这些建议会真正体现 Fastify 的生命周期、encapsulation 模型和 plugin 生态。

它的区别在哪里

它的价值不只是“用 Fastify”，而是会直接指向那些最常卡住落地的部分：route 结构、基于 schema 的校验、serialization、logging、CORS、error handling、数据库、WebSockets 和部署。它也会帮助处理 TypeScript 集成，包括 strip types，让建议更贴近真实 Fastify 代码的组织方式。

如何使用 fastify-best-practices 技能

安装 fastify-best-practices

按照 repo 里给出的安装路径执行，然后结合 skill 文件和配套规则来使用：
npx skills add mcollina/skills --skill fastify-best-practices

想要顺利完成 fastify-best-practices install，请先确认 skills/fastify 文件夹已经存在，并在跳进泛化 prompt 之前先阅读 SKILL.md。

把你的目标转成有效 prompt

想把 fastify-best-practices 用好，关键是先给出具体任务，而不是一句“帮我看 Fastify”。请包含：

• 应用类型：REST API、webhook receiver、auth service、proxy、real-time app
• 语言：TypeScript 或 JavaScript
• 当前技术栈：数据库、auth provider、部署目标、test runner
• 约束：性能、可维护性、安全性或迁移

示例：“请评审我的 Fastify TypeScript API 设计，重点看 auth、validation 和 error handling；我在用 @fastify/jwt、Postgres，并且希望 plugin 边界可以随规模扩展。”

先读对文件

先从 SKILL.md 开始，然后查看 rules/plugins.md、rules/routes.md、rules/schemas.md、rules/error-handling.md 和 rules/configuration.md。接着再打开和你的问题对应的规则文件，比如 rules/authentication.md、rules/database.md、rules/logging.md 或 rules/deployment.md。

能提升输出质量的工作流

建议分三轮使用这个 skill：先描述系统，再要求推荐结构，最后按选定的规则文件做 review。如果你是在改现有代码，请提供相关的 route、plugin 或 config 文件，不要直接整仓库一股脑贴上来。这个 skill 最适合在你的 prompt 里明确写出你要解决的 Fastify 具体问题。

fastify-best-practices 技能 FAQ

这比普通 Fastify prompt 更好吗？

通常是更好的，因为 fastify-best-practices 的指导材料是围绕具体后端问题组织的，而不是笼统的“最佳实践”建议。这样在你需要决定 plugin、schema、hook 或生产环境配置时，能减少反复猜测。

初学者能用吗？

可以，只要你已经了解基础的 Node.js 和 HTTP。对 Fastify 新手来说，它很友好，因为它会指向具体文件和具体场景；但它不能替代先学好 JavaScript、TypeScript 或异步服务基础知识。

什么时候不该用它？

如果你的任务和 Fastify 无关，或者你只需要一个很小的一次性代码片段，就不必特意用 fastify-best-practices。当你想要的是不带任何 Fastify 假设的框架无关架构建议时，它也不是很合适。

它如何适配 Fastify 生态？

当你使用 Fastify plugins 以及 @fastify/* 生态来处理 auth、CORS、Postgres 和相关 server 问题时，它会非常契合。如果你的应用建立在另一个框架之上，或者依赖隐藏的 middleware 模式，这个 skill 可能会把你推向 Fastify 原生结构，而这未必符合你的技术栈。

如何改进 fastify-best-practices 技能

给技能补上决策上下文

最大的提升来自说明你在优化什么：启动速度、请求吞吐、可维护性、安全性还是可测试性。对 fastify-best-practices 来说，这些目标会直接影响 schema 策略、logging 级别、plugin 边界和部署形态的建议。

只提供最小且相关的代码片段

请求 review 时，请附上出问题的那一个 route、plugin 或 config 文件，而不是整个应用。像“修复我在 server.ts 里的 register 顺序，并解释为什么 encapsulation 被破坏了”这样的窄问题，通常比“分析我的 repo”能得到更好的输出。

指明你要看的规则领域

这个 repo 按主题拆成了多个文件，所以你的 prompt 应该直接指向最相关的领域：auth、config、databases、serialization、hooks、performance 或 testing。对 fastify-best-practices 尤其如此，因为这样能帮助助手调用正确的规则逻辑，而不是只给出泛泛的后端建议。

围绕具体目标迭代

拿到第一版答案后，一次只要求改进一个点：更严格的 schema validation、更清晰的 plugin 拆分、更安全的 auth 流程，或者更适合生产的 logging。如果输出还是太抽象，就要求它改成与你的 route 结构和部署约束直接对应的版本，这样下一轮结果才能直接落地。