关于 saleor-configurator
Saleor Configurator 是一项技能指南,介绍如何用 YAML 定义 Saleor 商店配置,并通过命令行以声明式方式部署。内容涵盖配置结构、实体标识、部署、差异比较和环境迁移。
主要功能
- 01指导编写 YAML 配置
- 02说明实体标识策略
- 03介绍命令行命令和选项
- 04说明部署顺序与故障处理
- 05解释差异比较和同步行为
适用场景
- 01编写或编辑商店的 `config.yml`
- 02排查与远程状态的差异
- 03设置自动化部署流水线
- 04在不同环境间迁移配置
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ saleor/ agent-skills --skill saleor-configurator安装后在 Claude Code 中输入/saleor-configurator确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
AGENTS.mdREADME.mdrules/cli-commands.mdconfig-schema.mddeploy-pipeline.mddiff-behavior.mdidentity-strategies.md详细介绍
Saleor 配置工具
Saleor Configurator 使用指南——这是一款“代码即商务”的命令行工具,可让你在 YAML 中定义整个 Saleor 商店配置,并以声明式方式部署。
适用场景
- 为 Saleor 商店编写或编辑
config.yml - 运行
deploy、introspect或diff命令 - 了解每种实体应使用哪个标识符(
slug还是name) - 排查本地配置与远程状态不一致的问题
- 设置 CI/CD 流水线以自动部署
- 在不同环境之间迁移商店配置
规则类别及优先级
| 优先级 | 类别 | 影响 | 前缀 |
|---|---|---|---|
| 1 | 配置架构 | 严重 | config- |
| 2 | 实体标识 | 严重 | identity- |
| 3 | 命令行工作流 | 高 | cli- |
| 4 | 部署 | 高 | deploy- |
| 5 | 差异与同步 | 中 | diff- |
快速参考
1. 配置架构(严重)
config-schema— YAML 结构、所有顶级键、实体示例
2. 实体标识(严重)
identity-strategies— 基于 slug、基于名称和单例的策略;各实体使用哪种策略
3. 命令行工作流(高)
cli-commands— 所有命令、标志、环境变量、凭据设置、非交互模式
4. 部署(高)
deploy-pipeline— 阶段顺序、依赖关系图、选择性部署、失败处理
5. 差异与同步(中)
diff-behavior— diff 如何检测变更,以及哪些操作会触发创建、更新或删除
使用方法
阅读各规则文件,了解详细说明和示例:
rules/config-schema.md
rules/identity-strategies.md
rules/cli-commands.md
rules/deploy-pipeline.md
rules/diff-behavior.md
完整合并文档
如需查看包含所有展开规则的完整指南:AGENTS.md
评论
支持 Markdown