# shopify-functions

Скилл для Codex и ChatGPT, который помогает писать бэкенд-логику Shopify Functions: от скидок до валидации корзины. Перед выдачей кода он ищет примеры в документации и прогоняет проверку.

- скилл · `type=skill` · Codex, ChatGPT · 1 установка · ★ 7604
- Автор: Shopify · официальный репозиторий OpenAI
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/openai/plugins/tree/HEAD/plugins/shopify/skills/shopify-functions/SKILL.md
- Обновлён: 2026-10-08
- HTML: https://affpapa.org/nevibecode/skills/shopify-functions

## Что делает

Скилл закрывает десять API Shopify Functions: Discount, Cart and Checkout Validation, Cart Transform, Delivery Customization, Payment Customization, Fulfillment Constraints, Order Routing Location Rule и генераторы пунктов выдачи. Под каждый API он подбирает цель, например `cart.lines.discounts.generate.run` для скидок на позиции корзины.

Работа идёт по жёсткому порядку. Сначала агент вызывает `scripts/search_docs.mjs "<query>"`, потом пишет код, затем запускает `scripts/validate.mjs` с флагами `--model`, `--client-name`, `--client-version`, `--artifact-id` и `--revision`. Если проверка не прошла, поиск повторяется по типу ошибки, и так до трёх раз. Код возвращается только после успешной валидации.

Функции Shopify чистые: без сети, файловой системы, генератора случайных чисел и текущего времени. Все данные приходят через входной GraphQL-запрос, поля пишутся в camelCase, а для UNION-типов нужен `__typename`. Язык по умолчанию — Rust, для JS и TypeScript нужен явный выбор. Скилл требует Node.js, а сборка и запуск идут через `shopify app function build` и `shopify app function run` внутри папки функции.

## Установка

### Codex (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add openai/plugins --skill shopify-functions -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/shopify-functions/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Claude Code

1. **Через Skills CLI (Vercel)**
```bash
npx skills add openai/plugins --skill shopify-functions -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/shopify-functions/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/shopify-functions/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/skills/shopify-functions/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install openai/plugins shopify-functions
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/shopify-functions/SKILL.md`

### Gemini CLI

**Командой платформы**
```bash
gemini skills install https://github.com/openai/plugins --path plugins/shopify/skills/shopify-functions
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/shopify-functions/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/openai/plugins/tree/HEAD/plugins/shopify/skills/shopify-functions/SKILL.md

## Когда брать
- выбрать подходящий API Shopify Functions под задачу
- написать цель для скидки на позиции корзины
- собрать входной GraphQL-запрос с нужными полями
- проверить код функции до возврата пользователю
- переписать устаревший Order Discount на актуальный Discount

## Примеры запросов агенту
- Сделай функцию скидки на позиции корзины на Rust
- Напиши валидацию корзины и чекаута на TypeScript
- Сгенерируй функцию переименования способов оплаты

## Похожие
- [shopify-setup](https://affpapa.org/nevibecode/skills/shopify-setup.md) — скилл · 1200 установок
- [shopify](https://affpapa.org/nevibecode/skills/mrgoonie-shopify.md) — скилл · 450 установок
- [shopify-expert](https://affpapa.org/nevibecode/skills/shopify-expert.md) — скилл · 5000 установок
- [shopify-development](https://affpapa.org/nevibecode/skills/shopify-development.md) — скилл · 1900 установок
- [shopify-products](https://affpapa.org/nevibecode/skills/shopify-products.md) — скилл · 1400 установок
- [shopify-apps](https://affpapa.org/nevibecode/skills/sickn33-shopify-apps.md) — скилл · 1000 установок

Из того же набора: [openai/plugins](https://affpapa.org/nevibecode/by/openai/plugins.md) — 420 карточек

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md