用途：在用户处理 Spree Commerce 项目时提供指导，涉及 Spree 模型、控制器以及装饰器、订阅者等定制模式。
主要能力与使用方式：先检测项目形态，因为命令执行方式不同。信号顺序为：backend/Gemfile 含 spree 且根目录有 docker-compose.yml，属 create-spree-app 项目（5.4+），用 spree <cmd>；根目录为 Rails 应用且 docker-compose.yml 含 Spree 镜像，属 spree-starter 风格，能用 CLI 时用 spree <cmd>，否则用 docker compose exec web <cmd>；根目录为 Rails 应用且有 spree gems 但无 Docker，属经典 Rails 应用，从应用根目录执行 bin/rails、bundle exec rake 等原生命令。文档给出命令映射：开发用 spree dev 或 bin/dev；控制台用 spree console 或 bin/rails console；迁移用 spree migrate 或 bin/rake spree:install:migrations && bin/rails db:migrate；升级、生成器、rake 任务、种子数据也各有对应形式。create-spree-app 项目布局中后端在 backend/，所有 Spree 专有代码位于 backend/app/。定制优先级为：设置与 Spree::Config、事件与订阅者、依赖注入 Spree.dependencies、管理扩展 API、生成器、装饰器、扩展 gem。约定：Spree 相关类放在 Spree:: 命名空间；使用 Spree.user_class / Spree.admin_user_class；使用 Spree::Current 获取请求上下文；API 使用前缀 ID；继承 Spree.base_class。
适用场景：开发、调试、迁移、升级、定制 Spree 应用。
限制：资料未提供收费、价格或平台信息；spree:upgrade 与生成器需 spree_core 5.5+，旧版需先升级 gem 包；本地文档仅在安装 @spree/docs 时存在，经典应用改用线上文档。