Medusajs技能

medusa-agent-skills/plugins/medusa-dev/skills/building-admin-dashboard-customizations

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

medusa-agent-skills/plugins/medusa-dev/skills/building-storefronts

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

medusa-agent-skills/plugins/medusa-dev/skills/building-with-medusa

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

medusa-agent-skills/skills/creating-agents-in-medusa

在 Medusa 專案中建置內部管理導向的 AI 代理時使用。這些代理由商家和商店營運者操作，而非顧客。涵蓋…

medusa-agent-skills/plugins/medusa-dev/skills/db-generate

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

medusa-agent-skills/plugins/medusa-dev/skills/db-migrate

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

medusa/.claude/skills/diagnosing-dependabot-alerts

診斷 Medusa 單一儲存庫中的 GitHub Dependabot / 安全警報，並找出侵入性最小的修復方式。在調查 Dependabot 警報、安全…時使用。

medusa-agent-skills/plugins/learn-medusa/skills/learning-medusa

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

medusa-agent-skills/plugins/medusa-cloud/skills/mcloud-deployments

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

medusa-agent-skills/plugins/medusa-cloud/skills/mcloud-environments

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

medusa-agent-skills/plugins/medusa-cloud/skills/mcloud-local

執行 mcloud local build 以在本機重現 Cloud build。用於偵錯建置失敗的部署時，無需推送到追蹤分支，…

medusa-agent-skills/plugins/medusa-cloud/skills/mcloud-logs

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

medusa-agent-skills/plugins/medusa-cloud/skills/mcloud-organizations

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

medusa-agent-skills/plugins/medusa-cloud/skills/mcloud-projects

執行 mcloud projects 指令以列出、取得或刪除雲端專案。在探索專案、依名稱解析專案識別碼，或擷取…時使用。

medusa-agent-skills/plugins/medusa-cloud/skills/mcloud-variables

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

medusa-agent-skills/plugins/medusa-dev/skills/new-user

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

medusa/.claude/skills/reviewing-prs

審查 Medusa 儲存庫的 GitHub pull requests。檢查 PR 範本合規性、貢獻指南、程式碼慣例、安全性、效能，以及…

medusa-agent-skills/plugins/ecommerce-storefront/skills/storefront-best-practices

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

medusa/.claude/skills/triaging-issues

為 Medusa 倉庫分類 GitHub 問題。當有 GitHub 問題被開啟或收到新留言時使用。對問題進行分類、驗證，並發出…

medusa-agent-skills/plugins/medusa-cloud/skills/using-medusa-cloud

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

medusa/.claude/skills/writing-docs

撰寫並更新Medusa文件中的MDX檔案，涵蓋book、resources、ui、user-guide和cloud專案。當需要根據…進行文件變更時使用。

medusa/.claude/skills/writing-releases

為Medusa版本撰寫符合既有風格的GitHub發布說明。當需要從提交和PR清單生成發布說明草稿時使用…

medusa/.claude/skills/writing-tsdocs

在 Medusa 程式碼庫中為 TypeScript 原始檔新增和更新 TypeDoc (TSDoc) 註解。涵蓋 HTTP 類型、API 路由、UI 元件、資料模型、服務…