Medusajs 스킬

Medusa Admin 대시보드용 맞춤 UI 확장 기능으로, Admin SDK와 Medusa UI 컴포넌트를 사용합니다. 모든 관리자 UI 작업(계획, 구현, 탐색) 시 이 스킬을 먼저 로드하세요. MCP 서버는 API 참조만 제공하며, 디자인 패턴이나 데이터 로딩 전략은 제공하지 않습니다. 중요: 모든 API 요청에는 Medusa JS SDK를 사용하고(일반 fetch 사용 금지), 표시 쿼리와 모달 쿼리를 분리하며, 변형 후에는 표시 데이터를 무효화하세요. 기존 페이지에 위젯을 구현하거나 맞춤 UI 라우트를 생성하세요.

Medusa Admin 대시보드 UI(위젯, 사용자 정의 페이지, 양식, 테이블, 데이터 로딩, 내비게이션)를 계획, 연구 또는 구현할 때 자동으로 로드됩니다.

SDK 기반의 Medusa 스토어프론트 통합으로, React Query 패턴과 중요한 API 호출 규칙을 포함합니다. 모든 API 요청에는 항상 Medusa JS SDK를 사용해야 하며, 일반 fetch()는 사용하지 않습니다. fetch()는 필수 헤더(스토어 라우트의 publishable API 키, 관리자 라우트의 인증)가 누락되기 때문입니다. SDK 메서드에는 일반 JavaScript 객체를 전달하며, 본문 매개변수에 JSON.stringify()를 사용하지 않습니다. SDK가 자동으로 직렬화를 처리합니다. GET 요청에는 useQuery를, POST/DELETE 요청에는 useMutation을 사용합니다.

계획, 연구 또는 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에서 데이터베이스 마이그레이션 실행

대화형 단계별 메두사 개발 부트캠프로, 브랜드 기능을 구축하면서 아키텍처 패턴을 학습합니다. 모듈, 워크플로우, API 라우트, 모듈 링크, 워크플로우 훅, 관리자 UI 커스터마이징을 다루는 3개의 점진적 레슨(총 2~3시간)으로 구성됩니다. 각 주요 구성 요소 이후 체크포인트 검증을 통해 개념 이해도, 코드 품질, 기능성을 확인한 후 진행합니다. 오류를 교육 기회로 활용하며, 진단 질문과 근본 원인 분석을 통해 함께 디버깅합니다...

사용자가 Medusa 개발을 배우고 싶다고 요청할 때 자동으로 로드됩니다 (예: "Medusa로 빌드하는 방법을 가르쳐줘", "Medusa를 통해 나를 안내해줘", "Medusa를 배우고 싶어").…

mcloud deployments 명령을 실행하여 배포 목록을 조회하고, 배포 세부 정보를 검색하며, 빌드 로그를 가져옵니다. 배포 목록을 확인하거나, 배포 상태를 점검할 때 사용합니다.

mcloud environments 명령을 실행하여 Cloud 환경을 나열, 조회, 생성, 삭제, 재배포 또는 빌드를 트리거합니다. 환경 수명 주기를 관리할 때 사용합니다.

mcloud logs를 실행하여 Cloud 환경의 런타임 로그를 가져오고 스트리밍합니다. 백엔드 또는 스토어프론트 로그를 읽을 때, 시간 범위로 필터링하거나 검색할 때 사용합니다.

mcloud organizations 명령을 실행하여 Cloud 조직을 나열하거나 가져옵니다. 조직을 검색하거나, 이름으로 조직 ID를 확인하거나, 검색할 때 사용합니다.

mcloud projects 명령을 실행하여 Cloud 프로젝트를 나열, 조회 또는 삭제합니다. 프로젝트를 검색하거나 이름으로 프로젝트 핸들을 확인하거나 검색할 때 사용합니다.

mcloud variables 명령어를 실행하여 Cloud 환경의 환경 변수를 나열하고 가져옵니다. 환경을 검사하거나 읽거나 내보낼 때 사용합니다.

Medusa에서 이메일과 비밀번호로 새 관리자 사용자를 생성합니다. 명령 인수로 이메일과 비밀번호를 받아 관리자 자격 증명을 설정합니다. Bash를 통해 -e 및 -p 플래그와 함께 npx medusa user 명령을 실행합니다. 생성 성공, 사용자 이메일, 오류 및 관리자 대시보드 로그인을 위한 다음 단계를 보고합니다.

Medusa에서 관리자 사용자를 생성합니다.

전자상거래 스토어프론트, 온라인 스토어, 쇼핑 사이트 작업 시 항상 이 스킬을 사용하세요. 체크아웃 페이지, 장바구니 등 모든 스토어프론트 구성 요소에 사용하십시오.

모던 이커머스 스토어프론트 구축을 위한 포괄적인 가이드로, 패턴, 컴포넌트 아키텍처, 백엔드 통합을 다룹니다. 모든 스토어프론트 컴포넌트(네비게이션, 상품 페이지, 장바구니, 결제, 계정 페이지)를 포함하며, 모든 프레임워크(Next.js, SvelteKit, React, Vue)에서 사용 가능합니다. 필수 접근성 패턴(장바구니 업데이트를 위한 aria-live), 모바일 최적화(safe-area-inset, 44px 터치 타겟), SEO 요구사항(Product 스키마, Core Web Vitals)을 다룹니다. 필수 백엔드 SDK를 제공합니다.

Medusa Cloud 리소스를 Cloud CLI(mcloud)를 통해 관리합니다. 배포, 디버깅, 환경 관리, 환경 변수 관리 등에 사용합니다.

Medusa Cloud 리소스를 Cloud CLI(mcloud)를 통해 관리합니다. 배포, 디버깅, 환경 관리, 환경 변수 관리 등에 사용합니다.