fastify-best-practices

fastify-best-practices 技能總覽

這個技能適合做什麼

fastify-best-practices 是一套實用的 Fastify 指引技能，適合用來建置與除錯使用 TypeScript 或 JavaScript 的 Node.js 後端、API 與服務。當你需要 fastify-best-practices 來處理後端開發時，特別是要選對 plugin 模式、串接路由、驗證 payload、處理 auth，或避免那些會拖慢交付的常見 Fastify 錯誤時，這個技能最有用。

誰應該使用它

如果你正在建立新的 Fastify 應用、重構既有專案，或想讓正式環境服務更安全、更容易維護，就適合使用這個 fastify-best-practices 技能。它特別適合想要超越泛用提示、而且需要符合 Fastify 生命週期、封裝模型與 plugin 生態系的後端開發者。

它的差異化在哪裡

它的價值不只是「使用 Fastify」而已；它會把你導向那些最常卡住導入的關鍵環節：路由結構、以 schema 為核心的驗證、序列化、logging、CORS、錯誤處理、資料庫、WebSockets，以及部署。它也能協助 TypeScript 整合，包括 strip types，讓建議更貼近真實 Fastify 程式碼的組織方式。

如何使用 fastify-best-practices 技能

安裝 fastify-best-practices

使用 repo 中顯示的安裝路徑，然後從技能檔與支援規則開始：
npx skills add mcollina/skills --skill fastify-best-practices

在執行 fastify-best-practices install 時，先確認 skills/fastify 資料夾存在，並在丟進一般提示詞之前先閱讀 SKILL.md。

把你的目標轉成有用的提示詞

有效使用 fastify-best-practices 的關鍵在於先描述具體工作，而不是只說「幫我處理 Fastify」。請包含：

• app 類型：REST API、webhook 接收端、auth 服務、proxy、即時應用
• 語言：TypeScript 或 JavaScript
• 目前技術棧：資料庫、auth provider、部署目標、測試執行器
• 約束：效能、可維護性、安全性或遷移

範例：「請檢視我的 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。

能提升輸出品質的工作流程

把這個技能分成三個階段使用：先描述系統，再請它建議結構，最後要求它依你選定的規則檔進行審查。如果你是在修改既有程式碼，請提供相關的 route、plugin 或 config 檔案，不要整個 repo 一次貼上。當你的提示詞明確指出你要解決的 Fastify 議題時，這個技能表現最好。

fastify-best-practices 技能 FAQ

這比一般的 Fastify 提示詞更好嗎？

通常是的，因為 fastify-best-practices 的指引內容是圍繞具體後端議題來組織，而不是泛泛的「最佳實務」建議。當你需要針對 plugin、schema、hook 或正式環境設定做決策時，這能大幅減少猜測。

初學者也適合嗎？

適合，只要你已經懂基本的 Node.js 和 HTTP。它對 Fastify 初學者算友善，因為會指向特定檔案與情境，但它不能取代先學會 JavaScript、TypeScript 或非同步伺服器基礎。

什麼情況下不該用它？

如果你的任務跟 Fastify 無關，或者你只需要一小段一次性的片段，就不必特地用 fastify-best-practices。當你想要的是不帶任何 Fastify 假設、完全框架無關的架構建議時，它也不算合適。

它如何融入 Fastify 生態系？

當你使用 Fastify plugins 與 @fastify/* 生態系來處理 auth、CORS、Postgres 以及相關伺服器議題時，這個技能會很合拍。如果你的應用是建立在其他框架或隱性 middleware 模式上，它可能會把你推向 Fastify 原生結構，而那不一定符合你的技術棧。

如何改進 fastify-best-practices 技能

提供決策脈絡

最大的改善來自於先說清楚你在優化什麼：啟動速度、請求吞吐量、可維護性、安全性，還是可測試性。對 fastify-best-practices 來說，這些目標會直接影響 schema 策略、logging 等級、plugin 邊界與部署形態的建議。

分享最小且相關的程式碼片段

在要求審查時，請貼出出問題的那個 route、plugin 或 config 檔案，不要整個 app 都貼上。像是「請修正我在 server.ts 裡的 register 順序，並解釋為什麼封裝會失效」這種窄化提示，通常會比「分析我的 repo」產生更好的結果。

指明你要看的規則範圍

repo 已經拆成主題檔案，所以你的提示詞應該直接點出相關領域：auth、config、database、serialization、hooks、效能或測試。這對 fastify-best-practices 的使用特別有幫助，因為它能引導助理讀到正確的規則邏輯，而不是只給你泛用的後端建議。

用具體目標持續迭代

拿到第一版答案後，一次只要求一項改進：更嚴格的 schema 驗證、更清楚的 plugin 分離、更安全的 auth 流程，或可直接上線的 logging。如果輸出看起來太抽象，請它改成完全符合你的 route 形狀與部署限制的版本，這樣下一輪就能直接執行。