building-with-medusa

building-with-medusa 技能是 Medusa 生態系統中工程師的必備開發輔助工具。它規範了建構可擴展、類型安全且易於維護的後端功能所需的嚴格架構要求與編碼標準。透過強制執行嚴格的分層策略——確保業務邏輯與 HTTP 介面及資料存取解耦——此技能可協助開發人員避免諸如繞過層級、不當資料建模或次優的跨模組通訊等常見問題。

• 支援使用內建回滾功能快速實作自定義模組、資料模型和複雜的工作流。

• 提供關於 API 路由結構、中介軟體整合及基於 Zod 的請求驗證的即時指導。

• 利用 query.graph 和 query.index 促進高效的資料擷取模式，以維持模組隔離性。

• 包含關鍵技術限制，例如 Medusa 價格處理慣例以及針對狀態變更操作強制使用工作流的規定。

• 內建全面的參考文件檢索機制，涵蓋身份驗證、模組連結及查詢設定。

• 在規劃、研究或編寫任何後端組件（包括模組、工作流、API 路由或資料模型）時，請務必載入此技能。

• 在實作前，請務必將相關參考文件（例如 custom-modules.md, workflows.md）作為前置條件載入，以確保符合最新的 SDK 要求。

• 使用此技能來驗證對 Medusa 必要架構層級（模組 → 工作流 → API 路由 → 前端）的遵循情況。

• 此技能可作為類型安全的防護欄，確保開發人員正確使用 AuthenticatedMedusaRequest 與 Zod schema 匯出。

• 遵循指定的程式碼組織優先級類別，從架構完整性到檔案層級的慣例進行管理。