关于 saleor-storefront
saleor-storefront 是面向 Saleor 电商平台店铺开发的通用指南，适用于使用不同框架的开发者。内容涵盖 GraphQL API、商品变体、结账和多渠道库存规则。
主要功能
- 01Saleor GraphQL API 数据模型与权限
- 02商品及变体查询模式
- 03结账生命周期与支付排错
- 04多渠道库存及可购买性规则
- 05附代码示例的规则文件
适用场景
- 01查询商品、分类或合集数据
- 02实现商品详情页和变体选择
- 03开发结账与支付流程
- 04排查商品不可购买或权限错误
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/saleor-storefront确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
AGENTS.mdREADME.mdreferences/saleor-key-directories.mdrules/api-data-model.mdapi-graphql-patterns.mdapi-investigation.mdapi-permissions.mdchannels-purchasability.mdcheckout-lifecycle.mdproducts-variants.md详细介绍
Saleor Storefront
在 Saleor 电商平台上构建店面的通用指南。涵盖 Saleor GraphQL API 数据模型、权限系统、结账生命周期、渠道架构以及商品/变体模式。与框架无关——无论使用 Next.js、Remix、Nuxt 还是自定义方案，这些规则都适用。
适用场景
在以下情况下参考这些指南：
- 查询 Saleor GraphQL API 中的商品、类别或集合
- 构建带有变体选择功能的商品详情页
- 实现结账和支付流程
- 使用多渠道和多币种配置
- 调试“商品无法购买”或权限错误
- 使用 Saleor 3.23+ 库存可用性模式（
useLegacyShippingZoneStockAvailability） - 通过源代码调查 Saleor API 的行为
规则类别
| 优先级 | 类别 | 影响 | 前缀 |
|---|---|---|---|
| 1 | API | 严重 | api- |
| 2 | 商品 | 高 | products- |
| 3 | 结账 | 高 | checkout- |
| 4 | 渠道 | 中 | channels- |
快速参考
1. API（严重）
api-data-model— 可空字段、定价结构、店面自动过滤api-permissions— 令牌类型、权限错误、双层查询模式api-graphql-patterns— 按渠道限定范围的查询、变体属性、过滤、代码生成api-investigation— 如何通过类型和源代码调查 Saleor API 的行为
2. 商品（高）
products-variants— 变体模型、选择属性与非选择属性、定价、用户体验模式
3. 结账（高）
checkout-lifecycle— 会话生命周期、常见错误、支付问题调试
4. 渠道（中）
channels-purchasability— 库存可用性模式（旧版与直接模式，3.23+）、可购买性与可配送性、履约三角、适配模式的检查清单、按渠道限定范围的查询、库存 Webhook
使用方法
阅读各条规则文件，了解详细说明和代码示例：
rules/api-data-model.md
rules/products-variants.md
每个规则文件都包含：
- 简要说明规则为何重要
- 代码示例（正确和错误的模式）
- 应避免的反模式
完整编译文档
如需查看包含所有展开规则的完整指南：AGENTS.md
评论
支持 Markdown