路由處理程式 AI代理Skills

Agent Skills

路由處理程式 AI代理Skills

路由處理程式 AI代理技能是一款專為Next.js App Router設計的高階API端點智能生成代理，將Web標準Request/Response API與Next.js 15擴展功能深度整合，支援從Webhook接收到邊緣計算API的端到端自動化建置。使用者只需輸入如「生成處理Stripe Webhook、Resend郵件通知與OpenAI聊天完成事件的綜合API路由，包含CORS、速率限制與錯誤追蹤」，代理即自動建立app/api/v1/route.ts，整合NextRequest擴展、Zod驗證、Redis快取與Sentry監控，將傳統API開發週期從數小時壓縮至數分鐘，確保TypeScript安全同時符合生產級安全規範與效能要求。這項技能涵蓋78種企業級路由模式，完美適配Vercel Edge Runtime、Cloudflare Workers與自託管環境，特別針對Serverless架構提供零配置部署與全球分發優化。

 

核心功能架構

技能建構七層智能路由生成引擎，第一層HTTP方法解析器自動識別GET、POST、PUT、DELETE、PATCH、HEAD、OPTIONS七種方法並生成對應處理函數，內建405 Method Not Allowed自動回應；第二層請求驗證器整合Zod Schema、TypeBox與Valibot，支援Query、Body、Headers、Cookies全面驗證與類型推斷；第三層認證閘道支援NextAuth v5、Clerk、Auth0與自訂Bearer Token，自動生成middleware驗證層；第四層快取策略引擎根據請求特徵配置revalidate、stale-while-revalidate與Edge Cache規則；第五層錯誤處理器統一注入Sentry、LogRocket與自訂錯誤邊界，返回標準化JSON Response；第六層效能監控嵌入Prometheus指標、OpenTelemetry追蹤與Datadog APM；第七層部署優化生成Edge Runtime相容配置與Bundle Analyzer報告。

動態路由支援params與searchParams Promise解析，嵌套路由自動生成路徑層次結構。CORS預設啟用支援自訂Origin白名單與Credentials模式。

 

運作原理與技術細節

技能執行十二階段路由建置流程，第一階段意圖解析利用AST分析API需求，提取端點路徑、HTTP方法、資料合約與業務邏輯；第二階段檔案結構生成透過虛擬檔案系統建立app/api/v1/[resource]/route.ts與相關Schema檔案；第三階段類型定義合成生成TypeScript介面包含Request/Response DTO與錯誤聯合類型。

第四階段驗證邏輯注入自動生成z.infer<typeof schema>類型守衛與錯誤訊息國際化；第五階段業務邏輯編譯整合Prisma、Drizzle或自訂ORM，支援事務、樂觀更新與軟刪除；第六階段快取層建立根據TTL策略配置Redis、Upstash或Vercel KV；第七階段安全檢查掃描SQL注入、XSS、CSRF與速率限制漏洞；第八階段監控整合嵌入結構化日誌與效能指標；第九階段測試生成Vitest模擬器、MSW攔截器與E2E場景；第十階段文件產生OpenAPI/Swagger規格與Postman Collection；第十一階段部署配置優化Edge Runtime與Node.js雙模式；第十二階段CI/CD整合GitHub Actions與Vercel Preview部署。

知識庫內嵌Next.js Route Handler官方文件、Web API標準與Vercel Edge最佳實踐，支援即時範例參考與配置驗證。

 

實際應用案例

Stripe Webhook中心，「建立處理payment_intent、invoice與subscription全生命週期事件」，技能生成app/api/stripe/webhooks/route.ts，整合Event驗證、Idempotency Key與非同步佇列，事件處理延遲降至28毫秒。Resend郵件API，「開發支援模板變數、追蹤像素與退信處理的郵件服務端點」，自動生成Zod Schema、SES整合與快取頭像，交付率提升至99.7%。

OpenAI聊天完成，「建置支援Streaming SSE、Conversation History與Moderation的聊天API」，合成app/api/chat/route.ts，整合Rate Limiting與Token計費，QPS提升340%。GraphQL代理，「建立Hasura與Apollo相容的GraphQL端點支援Subscription」，生成認證Middleware、查詢快取與WebSocket升級，響應時間降至67毫秒。

企業資料匯入，「開發CSV/JSON批量上傳API支援背景處理與進度回報」，整合BullMQ佇列與SSE通知，單次匯入10萬筆資料僅需41秒。

 

安裝與配置指南

將路由處理程式技能部署至skills/nextjs-expert/route-handlers目錄，驗證環境建立app/api/test/route.ts並輸入「生成CRUD API範例」，確認七種HTTP方法完整實作與TypeScript檢查通過。

進階設定自訂Schema庫、快取提供者與監控端點，支援PlanetScale連接池、Upstash Redis與Sentry DSN一鍵配置。整合ESLint nextjs插件與Prettier，總部署時間約75秒。VS Code整合提供Route Handler智能提示與Request日誌檢視。

 

進階優化策略

邊緣計算優化生成Vercel Edge與Cloudflare Workers相容版本，支援WASM模組與0ms冷啟動。Streaming Response整合Server Sent Events與ReadableStream，實現即時資料推送。Middleware鏈路支援條件性快取無效化與A/B測試路由。

速率限制實現Token Bucket與Sliding Window演算法，支援IP、User ID與API Key多維度限制。WebSocket升級自動處理101 Switching Protocols與後續Frame解析。監控儀表板生成Grafana Dashboard與即時警示。

國際化支援自動注入Accept-Language解析與i18n回應頭部。

 

效能指標與競爭優勢

API響應中位數78毫秒，95百分位142毫秒，錯誤率穩定0.03%。快取命中率92%，Edge分發覆蓋率98%。Bundle size平均14KB，Edge Runtime啟動時間7毫秒。

相較Express/NestJS，內建Next.js原生優化避免雙重抽象層，部署成本下降67%。與tRPC對比，提供REST/GraphQL雙協議同時保持類型安全。開發者生產力提升9.2倍，API維護成本下降54%。

 

未來發展方向

下一代融合Next.js 16 Partial Prerendering與AI原生Route Generation，實現從OpenAPI規格自動生成完整端點。v6.0推出自適應協議協商器，動態切換REST、GraphQL與gRPC。

隨著Serverless API向Agentic Gateway演進，此技能將升級為智慧API協作者，實現從業務需求直達全球分發的自主API生命週期管理，讓開發團隊專注核心邏輯而非基礎設施複雜性，為現代Web服務注入工業級智慧與極速交付能力。

• Agent Skills來源: github
• 連結: https://github.com/davepoon/buildwithclaude#plugins~nextjs-expert~skills~route-handlers

立即試用Agent Skills