Medusajs技能

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

在規劃、研究或實作 Medusa Admin 儀表板 UI（小工具、自訂頁面、表單、表格、資料載入、導覽）時自動載入。

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

在規劃、研究或實作 Medusa 店面功能（呼叫自訂 API 路由、SDK 整合、React Query 模式……）時自動載入。

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

在規劃、研究或實作任何 Medusa 後端功能（自訂模組、API 路由、工作流程、資料模型、模組連結等）時自動載入。

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

為 Medusa 模組生成資料庫遷移

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

在 Medusa 中執行資料庫遷移

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

當用戶要求學習 Medusa 開發時自動載入（例如：「教我如何使用 Medusa 建置」、「引導我了解 Medusa」、「我想學習 Medusa」）。…

執行 mcloud deployments 指令以列出部署、取得部署詳細資訊，以及擷取建置日誌。用於列出部署、檢查部署…

執行 mcloud environments 指令，以列出、取得、建立、刪除、重新部署或觸發雲端環境的建置。適用於管理環境生命週期等情境。

執行 mcloud logs 以擷取並串流 Cloud 環境的執行時期日誌。用於讀取後端或商店前端日誌，依時間範圍篩選、搜尋…

執行 mcloud organizations 指令以列出或取得 Cloud 組織。用於探索組織、依名稱解析組織 ID，或擷取…

Execute mcloud projects commands to list, get, or delete Cloud projects. Use when discovering projects, resolving project handles by name, or retrieving…

執行 mcloud variables 指令，列出並取得雲端環境的環境變數。用於檢查、讀取或匯出環境…

在 Medusa 中透過電子郵件和密碼建立新的管理員使用者。接受電子郵件和密碼作為命令參數來設定管理員憑證。透過 Bash 使用 -e 和 -p 標誌執行 npx medusa user 命令。回報建立成功、使用者電子郵件、錯誤以及管理員儀表板登入的後續步驟。

在 Medusa 中建立管理員使用者

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

使用模式、元件架構與後端整合打造現代電子商務商店的全面指南。涵蓋所有商店元件：導覽、產品頁面、購物車、結帳與帳戶頁面，適用於任何框架（Next.js、SvelteKit、React、Vue）。包含關鍵無障礙模式（用於購物車更新的aria-live）、行動最佳化（safe-area-inset、44px觸控目標）與SEO需求（產品結構化資料、Core Web Vitals）。提供必要的後端SDK...

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

通過 Cloud CLI (mcloud) 管理 Medusa Cloud 資源。在部署、調試部署、管理環境、環境變數或任何…時使用。