building-with-medusa

building-with-medusa 技能是 Medusa 生态系统中工程师的必备开发辅助工具。它规范了构建可扩展、类型安全且易于维护的后端功能所需的严格架构要求与编码标准。通过强制执行严格的分层策略——确保业务逻辑与 HTTP 接口及数据访问解耦——此技能可帮助开发人员避免诸如绕过层级、不当数据建模或次优的跨模块通信等常见问题。

• 支持使用内置回滚功能快速实现自定义模块、数据模型和复杂的工作流。

• 提供关于 API 路由结构、中间件集成及基于 Zod 的请求验证的即时指导。

• 利用 query.graph 和 query.index 促进高效的数据获取模式，以维持模块隔离性。

• 包含关键技术限制，例如 Medusa 价格处理惯例以及针对状态变更操作强制使用工作流的规定。

• 内置全面的参考文件检索机制，涵盖身份验证、模块链接及查询设置。

• 在规划、研究或编写任何后端组件（包括模块、工作流、API 路由或数据模型）时，请务必加载此技能。

• 在实现前，请务必将相关参考文件（例如 custom-modules.md, workflows.md）作为前置条件加载，以确保符合最新的 SDK 要求。

• 使用此技能来验证对 Medusa 必要架构层级（模块 → 工作流 → API 路由 → 前端）的遵循情况。

• 此技能可作为类型安全的防护栏，确保开发人员正确使用 AuthenticatedMedusaRequest 与 Zod schema 导出。

• 遵循指定的代码组织优先级类别，从架构完整性到文件层级的惯例进行管理。