route-handlers

此技能為使用 Next.js App Router 的開發人員提供了一個強大的框架，能高效地實作伺服器端 API 邏輯。它簡化了路由處理程序 (Route Handlers) 的建立過程，確保符合標準的 Web Request 與 Response API 慣例。無論您是在建置簡單的 REST API、執行複雜的資料串流，還是管理標頭與 Cookie，此工具都能作為您在以前端為主的專案中進行後端開發的專家助手。

• 完整支援 HTTP 方法，包括 GET、POST、PUT、PATCH、DELETE、HEAD 與 OPTIONS。

• 自動化處理 app 目錄結構內的 route.ts 檔案慣例。

• 具備處理動態 URL 參數、查詢字串解析以及複雜請求主體 (JSON, FormData, Text) 的能力。

• 進階回應處理功能，例如設定自訂標頭、Cookie 管理以及實作安全的重新導向。

• 內建串流回應支援，包含標準文字串流以及使用 ReadableStreams 的複雜 AI/LLM 整合模式。

• 整合 CORS 設定範本，確保端點間的跨來源通訊安全性。

• 自動化快取策略管理，包含預設的靜態行為以及使用動態強制 (dynamic force) 或標頭的選擇性退出機制。

• 使用此技能來初始化新的 API 路由，或將舊有的 API 模式重構為現代化的 App Router 架構。

• 非常適合開發人員在 Next.js 中處理授權邏輯、資料庫整合或第三方服務掛鉤 (例如 AI 模型串流)。

• 輸入要求包含您想要的 HTTP 端點路徑、目標功能 (例如身份驗證檢查) 以及預期的 HTTP 方法。

• 輸出為簡潔、符合生產環境標準的 TypeScript 程式碼，遵循 Next.js 最佳實務，減少樣板代碼並確保請求內容的型別安全。

• 請注意，路由處理程序是在伺服器上執行的；請確保所有的資料庫互動或敏感邏輯皆包含在適當的環境變數或伺服器端公用程式函式中。