saleor-configurator について
Saleor Configuratorは、YAMLでSaleorストアの設定を定義し、CLIで宣言的にデプロイするためのスキルガイドです。設定スキーマ、エンティティ識別、デプロイ、差分、環境間の移行を扱います。
主な機能
- 01YAML設定の作成を案内
- 02エンティティ識別方式を説明
- 03CLIコマンドとオプションを記載
- 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 Configurator
Saleor Configurator の使用ガイドです。YAML で Saleor ストア全体の設定を定義し、宣言的にデプロイできる「コードとしてのコマース」CLI です。
適用する場面
- Saleor ストアの
config.ymlを作成または編集するとき deploy、introspect、diffコマンドを実行するとき- エンティティごとに使用する識別子(
slugとname)を把握するとき - ローカル設定とリモートの状態の不一致をデバッグするとき
- デプロイを自動化する CI/CD パイプラインを設定するとき
- 環境間でストア設定を移行するとき
優先度別ルールカテゴリ
| 優先度 | カテゴリ | 影響 | プレフィックス |
|---|---|---|---|
| 1 | 設定スキーマ | CRITICAL | config- |
| 2 | エンティティの識別 | CRITICAL | identity- |
| 3 | CLI ワークフロー | HIGH | cli- |
| 4 | デプロイ | HIGH | deploy- |
| 5 | 差分と同期 | MEDIUM | diff- |
クイックリファレンス
1. 設定スキーマ(CRITICAL)
config-schema— YAML の構造、すべてのトップレベルキー、エンティティの例
2. エンティティの識別(CRITICAL)
identity-strategies— スラッグベース、名前ベース、シングルトンの違いと、各エンティティで使用する方式
3. CLI ワークフロー(HIGH)
cli-commands— すべてのコマンド、フラグ、環境変数、認証情報の設定、非対話モード
4. デプロイ(HIGH)
deploy-pipeline— ステージの順序、依存関係グラフ、選択的デプロイ、失敗時の処理
5. 差分と同期(MEDIUM)
diff-behavior— 差分で変更を検出する方法、作成・更新・削除のトリガー
使用方法
詳しい説明と例については、個別のルールファイルをお読みください。
rules/config-schema.md
rules/identity-strategies.md
rules/cli-commands.md
rules/deploy-pipeline.md
rules/diff-behavior.md
コンパイル済みドキュメント全文
すべてのルールを展開した完全なガイドについては、AGENTS.md をご覧ください。
コメント
Markdown 対応