如何为 Claude Code 或 Cursor 安装 Spree Agent Skills 以按官方约定开发【免费下载链接】spreeOpen Source eCommerce Platform for B2B, Marketplace, and Enterprise. REST API, TypeScript SDK, and production-ready Next.js storefront. Self-host it. Own your stack. No vendor lock-in. Zero platform fees.项目地址: https://gitcode.com/GitHub_Trending/sp/spree如果你正在用 Claude Code 或 Cursor 修改一个 Spree Commerce 项目会希望 agent 在写代码时遵循 Spree 的官方约定Spree命名空间、模型前缀 ID、service object、v3 REST API 的请求/响应结构而不是凭训练数据自由发挥。Spree 为此提供了 agent-skills 技能集合一组按需求加载的 Markdown 指令封装了 Spree 的约定、定制决策树subscriber vs decorator vs 依赖注入 vs generator、spree:model/spree:api_resource生成器、TypeScript SDK 用法和升级流程。安装分两条互斥路径skills CLInpx skills addClaude Code 和 Cursor 通用和 Claude Code 插件额外提供斜杠命令与安全钩子仅 Claude Code。本文按先判断走哪条路径再安装、再验证的顺序说明。准备条件一个 Spree 项目目录可以是create-spree-app脚手架出的项目Docker backend/下的 Rails 应用也可以是经典 Rails 应用Spree 5.4 之前创建的项目常见形态无 Docker。技能在执行命令前会自动识别项目形态create-spree-app项目的命令走 Spree CLIspree migrate、spree console等经典 Rails 应用则回退到应用根目录下的原生命令bin/rails、bundle exec rake。已配置好的 agent 工具Claude Code 或 Cursor。skills CLI 会自动检测你配置了哪些 agent 工具并把技能文件复制到对应工具的原生位置。Node.js安装命令通过npx执行。Spree 官方文档中 create-spree-app 快速开始 将 Node.js 20新项目脚手架另需 Docker列为前置要求。可选的预检先查看可用的技能在正式安装前可以先看看仓库里有哪些技能而不实际安装npx skills add spree/agent-skills --list主路径用 skills CLI 安装Claude Code 与 Cursor 通用在你的项目目录中执行npx skills add spree/agent-skills这条路径安装的是25 个技能 spree-expert子代理。技能覆盖定制决策树、v3 Store Admin API、spree:model/spree:api_resource生成器、TypeScript SDK、升级流程以及目录、结账、支付、促销、定价、配送、i18n、测试、安全、性能、部署等主题。spree-expert是一个 Claude Code 子代理用于多步调查任务升级审计、结账流程调试、API 面规划它在自己的上下文窗口里做调研并返回一份聚焦的报告避免占满主会话的上下文。只安装部分技能时用--skill指定子集npx skills add spree/agent-skills --skill spree-api-v3备选路径Claude Code 插件获得斜杠命令与安全钩子仅 Claude Code如果你用 Claude Code且需要官方的诊断命令和安全钩子改用插件安装方式。在 Claude Code 会话内执行/plugin marketplace add spree/agent-skills /plugin install spreespree插件提供 skills CLI 的全部内容另外还包括/spree:doctor诊断本地开发栈容器、环境变量、迁移、任务队列并给出处置建议/spree:audit-upgrade [version]对照你的代码库运行只读的升级就绪审计2 个安全钩子拦截破坏性数据库命令db:drop、DROP TABLE spree_*、批量删除、向 main 强制推送并在编辑引入硬编码密钥Stripe 生产密钥、AWS 密钥、API token时发出警告。可用SPREE_HOOKS_DISABLE1关闭钩子。两条路径只能选其一。文档明确说明插件安装和npx skills add安装同时使用会让技能互相冲突。Cursor 没有插件路径只能走 skills CLI。验证安装是否生效文件落位skills CLI 会自动检测你配置了哪些 agent 工具并把技能文件复制到每个工具的原生位置安装输出即反映检测结果。功能性验证文档给出的示例场景技能根据你当前的任务自动激活无需手动调用。例如让 agent add a Brand model with an API 会拉入 resource-generator 技能why is this promotion not applying 会拉入促销技能。如果你观察不到与任务对应的技能内容被加载说明对应工具未被检测到或安装路径用错了。插件路径的验证安装插件后在会话中运行/spree:doctor它会输出对本地开发栈的诊断结果。更新技能npx skills update插件安装则通过 Claude Code 的插件系统更新/plugin→ check for updates。Spree 每次发布新版本会附带对应的技能更新——升级 Spree 时记得同步更新技能保证指导内容与已安装版本匹配。限制与下一步同一项目里 skills CLI 与 Claude Code 插件只能保留其一否则技能冲突。安全钩子仅存在于插件路径走 skills CLI 的 Claude Code 用户没有这两个斜杠命令。安装技能后agent 获得的是怎么做才算 Spree 方式的指导层。如果还希望 agent 能检索最新发布的文档Spree 另外提供了 Docs MCP Server对 MCP 客户端暴露全文搜索和按页读取两个工具无需鉴权create-spree-app脚手架的项目则已自动安装spree/docs本地文档包并在生成的AGENTS.md/CLAUDE.md中指向了它见 LLM-Ready Docs。三者互补多数团队同时使用。【免费下载链接】spreeOpen Source eCommerce Platform for B2B, Marketplace, and Enterprise. REST API, TypeScript SDK, and production-ready Next.js storefront. Self-host it. Own your stack. No vendor lock-in. Zero platform fees.项目地址: https://gitcode.com/GitHub_Trending/sp/spree创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考