用途：该技能面向现代 Web 开发中的 Medusa v2 项目，帮助开发者按官方规范编写模块化电商后端与后台定制代码。
主要能力：涵盖通用规则、Workflow 规则、数据模型规则、服务规则和后台定制规则。通用规则要求导入文件时不使用类型别名、抛错时始终使用 MedusaError、始终用 Query 取数据。Workflow 规则要求用 @medusajs/framework/workflows-sdk 定义工作流与步骤，API 路由、定时任务或订阅器中创建功能时先建工作流，数据转换用 transform，条件用 when，调用步骤不加 await，工作流函数不加 async，补偿函数输入不加类型，工作流中只用步骤。数据模型规则要求用 @medusajs/framework/utils 的 model 工具定义，变量用 camelCase，传给 model.define 的名称用 snake case，id 字段用 .primaryKey()，一个模型只能有一个 id，字段用 snake case。服务规则要求方法为 async，含数据模型的模块服务继承 MedusaService。后台定制要求请求使用 Medusa JS SDK，样式用 TailwindCSS。
铁律与反模式：始终通过官方模块系统 @medusajs/modules-sdk 扩展模块，不修改核心源码；不从 API 路由直接访问数据库，须经服务层；自定义 API 路由使用 MedusaRequest 和 MedusaResponse 类型；不在自定义表中存储敏感客户或支付数据；异步任务中通过工作流引擎注册工作流而非直接调用服务。反模式包括修改核心源码、绕过服务直查数据库、无类型路由处理器、复制支付数据、后台任务直接调用服务。
记忆协议：开始前执行 cat .claude/context/memory/learnings.md，完成后记录新发现的模式或例外。
限制：资料未提供安装命令、版本要求、收费信息或具体平台支持范围。