api-spec-analyzer

API Specification Analyzer 是一款專為 caremaster-tenant-frontend 專案開發人員設計的工程工具。它透過解析原始的 OpenAPI 文件並將其轉換為實際可用的程式碼，進而縮短開發週期。此技能適用於需要加速 API 整合、確保嚴格型別安全，以及維護前端服務與後端 RESTful 端點之間一致性的軟體工程師、前端開發人員及全端開發者。

主要功能與特性包含：

• 利用專用的 MCP 工具智慧地提取與更新專案的 OpenAPI 規格文件。
• 自動產生強大的 TypeScript 介面，涵蓋複雜的巢狀物件、列舉約束及必要欄位驗證。
• 為常見架構模式提供生產級的程式碼支架，包括 Fetch API 服務、TanStack Query 鉤子以及最佳化的查詢鍵管理。
• 系統化分析 HTTP 方法、路徑參數、查詢字串以及請求與回應主體結構。
• 結構化記錄安全性需求，包含 Bearer Token 驗證、輸入驗證策略，以及針對 400、401、404 及 500 等標準 HTTP 狀態碼的錯誤處理。

實務應用建議：

• 當您需要實作涉及後端通訊的新功能、將 Mock 資料替換為真實 API 呼叫，或是偵錯型別不匹配時，請啟用此技能。
• 分析器對端點名稱極為敏感；若您提及 /api/users 等路徑，它會自動搜尋相關規格細節。
• 它能提供符合 API 契約的測試建議，協助您編寫涵蓋成功與失敗情境的單元測試（例如：重複 Email 衝突、未經授權的存取）。
• 請確保已啟動必要的 MCP 伺服器連線，此技能依賴租戶管理入口網站 API 工具來獲取即時文件更新。
• 輸出結果為清晰的 Markdown 格式，方便您直接將產生的型別複製到 TypeScript 原始檔中，確保前端程式碼能與不斷演進的後端 API 契約完美同步。