learning-medusa

在处理电商店面、在线商店、购物网站时，始终使用此技能。适用于任何店面组件，包括结账页面、购物车等。

通过Cloud CLI（mcloud）管理Medusa Cloud资源。用于部署、调试部署、管理环境、环境变量或任何…

使用管理SDK和Medusa UI组件为Medusa管理后台定制的UI扩展。对于任何管理后台UI工作（规划、实施、探索），请优先加载此技能；MCP服务器仅提供API参考，不包含设计模式或数据加载策略。关键：始终使用Medusa JS SDK进行所有API请求（切勿使用常规fetch）；将显示查询与模态查询分离，并在变更后使显示数据失效。在现有页面上实现小部件或创建自定义UI路由；...

以SDK为先的前端集成方案，适用于Medusa商店前端，采用React Query模式并遵循关键API调用规则。所有API请求必须使用Medusa JS SDK——禁止使用常规fetch()，因其缺少必要请求头（商店路由需可发布API密钥，管理路由需认证信息）。向SDK方法传递纯JavaScript对象，切勿对请求体参数使用JSON.stringify()，SDK会自动处理序列化。GET请求使用useQuery，POST/DELETE请求使用useMutation，...

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路由、模块链接、工作流钩子及管理界面自定义。每个主要组件完成后进行检查点验证，测试概念理解、代码质量和功能实现。将错误视为教学机会，通过诊断性问题共同调试并定位根本原因……