skills

此技能為 AI 驅動的全端應用程式提供了一個完整的生產級基礎。它以 Zenith 平台為模板，為架構一致性、代碼模式和開發工作流程建立了嚴格的標準。適用於希望使用 Next.js 15 (App Router)、TypeScript、FastAPI (Python) 和 Supabase 強大技術棧快速啟動專案的軟體工程師與 AI 開發者。該模板涵蓋了端到端的整合，確保前端元件與後端服務透過型別安全介面穩定通訊。

• 包含詳細服務圖表與技術棧定義的全端架構總覽。

• 預先配置的目錄結構，區分前端組件、hooks、後端路由、服務層與資料庫模型。

• 使用 Pydantic (後端) 與 TypeScript 介面 (前端) 的標準化 API 響應模式。

• Claude API 整合模式，具備結構化工具呼叫、Pydantic 模式驗證與 JSON 輸出管理。

• 完整的測試模式，包含 Playwright (E2E)、pytest (後端) 與 React Testing Library (組件測試)。

• 適用於 Google Cloud Run 與 Vercel 的部署配置。

• 在啟動新模組或全端功能時，使用此技能來強化團隊成員間的開發一致性。

• 遵循提供的目錄結構，以確保專案擴展時的可維護性。

• 在建構需要確定性 JSON 回應的 LLM 代理時，參考提供的 Claude 結構化輸出範例。

• 透過使用提供的 ApiResponse 類別處理所有內部與外部通訊，確保後端資料整合性。

• 實作建議的自定義 React hooks，以便在 Next.js 工作區中高效管理非同步狀態與資料獲取。