building-storefronts

在處理電子商務店面、線上商店、購物網站時，一律使用此技能。適用於任何店面元件，包括結帳頁面、購物車……

透過 Cloud CLI（mcloud）管理 Medusa Cloud 資源。用於部署、除錯部署、管理環境、環境變數或任何…

使用管理員SDK和Medusa UI元件為Medusa管理後台自訂UI擴充功能。進行任何管理員UI工作（規劃、實作、探索）時，請優先載入此技能；MCP伺服器僅提供API參考，不包含設計模式或資料載入策略。關鍵：所有API請求務必使用Medusa JS SDK（絕不使用一般fetch）；將顯示查詢與模態查詢分離，並在變更後使顯示資料失效。在現有頁面上實作小工具或建立自訂UI路由；...

以SDK為優先的前端整合方式，適用於Medusa商店前端，採用React Query模式並遵循關鍵API呼叫規則。所有API請求必須使用Medusa JS SDK，絕不能使用一般的fetch()，因為它缺少必要的標頭（商店路由需要可發布的API金鑰，管理路由需要驗證資訊）。傳遞純JavaScript物件給SDK方法，切勿對主體參數使用JSON.stringify()，因為SDK會自動處理序列化。使用useQuery處理GET請求，使用useMutation處理POST/DELETE請求...

Medusa後端架構、工作流程及關鍵實作規則的全面指南。涵蓋六大規則類別（架構、型別安全、商業邏輯放置、匯入、資料存取、檔案組織），包含具體的反模式與強制檢查。嚴格執行分層分離：模組 → 工作流程 → API路由 → 前端，所有變更操作必須透過工作流程，且僅允許GET/POST/DELETE HTTP方法。包含關鍵資料處理規則：價格按原樣儲存...

以單一指令為 Medusa 模組生成資料庫遷移檔案。封裝 npx medusa db:generate CLI 指令，為指定的 Medusa 模組建立遷移檔案。接受模組名稱作為參數，並回報遷移檔案位置、錯誤及後續步驟。自動建議在生成後執行 npx medusa db:migrate 以套用遷移。

執行待處理的 Medusa 資料庫遷移並回報結果。透過 Bash 執行 npx medusa db:migrate 以將所有待處理的遷移套用至 Medusa 資料庫。回報遷移結果，包括已套用的遷移數量、遇到的任何錯誤以及成功確認。專為使用標準 npm/npx 設定的 Medusa 專案設計。

互動式逐步Medusa開發訓練營，在建立品牌功能的同時學習架構模式。三個漸進式課程（總計2-3小時），涵蓋模組、工作流程、API路由、模組連結、工作流程鉤子及管理後台UI自訂。每個主要元件完成後設有檢查點驗證，測試概念理解、程式碼品質與功能正確性後才繼續進行。將錯誤視為教學機會，透過診斷問題與根本原因分析共同除錯...