route-handlers

route-handlers 技能是為在 Next.js App Router 框架下工作的開發人員所提供的專家級助手。它旨在簡化使用 Web Request 與 Response API 創建、配置與維護伺服器端 API 端點的流程。透過提供上下文相關的模板與最佳實踐，確保您定義在 route.ts 檔案中的 API 路由既穩健、高效，又能正確處理各種伺服器端需求。

• 完整支援包括 GET、POST、PUT、PATCH、DELETE、HEAD 與 OPTIONS 在內的標準 HTTP 方法，以定義清晰的端點行為。

• 內建處理多種請求負載的功能，例如 JSON 解析、表單資料提取與原始文字處理。

• 針對複雜 URL 的動態路由參數管理，允許透過路徑區段進行高效的變數提取與資料庫查詢。

• 進階回應處理功能，包括自定義 JSON 回應、HTTP 標頭注入、Cookie 管理與狀態碼設定。

• 高效能串流傳輸能力，支援標準文字串流以及使用 ReadableStream 的複雜 AI/LLM 整合模式。

• 整合 CORS 配置安全性模式，提供 OPTIONS 方法的樣板以管理跨來源流量。

• 智慧化快取控制，提供關於透過 force-dynamic 等路由區段配置來啟用或停用資料快取的明確指導。

• 非常適合在 Next.js 框架上進行開發的後端工程師、全端工程師與 API 架構師。

• 當您需要生成新的 API 路由、重構端點邏輯、實作中介軟體式邏輯或處理複雜的伺服器端資料串流時使用。

• 用戶預期將獲得符合最新 Next.js 13+ App Router 規範且可直接用於生產環境的程式碼片段。

• 請注意，此技能需要開發者具備非同步 JavaScript 與 Web Fetch API 標準的基礎知識，因為它大量依賴於原生的 Request 與 Response 物件。