shopify-functions — скилл для Codex: функции Shopify и установка
Скилл для Codex и ChatGPT, который помогает писать бэкенд-логику Shopify Functions: от скидок до валидации корзины. Перед выдачей кода он ищет примеры в документации и прогоняет проверку.
npx skills add openai/plugins --skill shopify-functions -a codexЧто делает 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 внутри папки функции.
Какие задачи решает
- выбрать подходящий API Shopify Functions под задачу
- написать цель для скидки на позиции корзины
- собрать входной GraphQL-запрос с нужными полями
- проверить код функции до возврата пользователю
- переписать устаревший Order Discount на актуальный Discount
Примеры запросов агенту
- Сделай функцию скидки на позиции корзины на Rust
- Напиши валидацию корзины и чекаута на TypeScript
- Сгенерируй функцию переименования способов оплаты
Как установить shopify-functions
1Через Skills CLI (Vercel)
npx skills add openai/plugins --skill shopify-functions -a codex2Вручную: положить файлы
.agents/skills/shopify-functions/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add openai/plugins --skill shopify-functions -a claude-code2Вручную: положить файлы
~/.claude/skills/shopify-functions/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/shopify-functions/
Вручную: положить файлы
.cursor/skills/shopify-functions/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install openai/plugins shopify-functions2Вручную: положить файлы
.github/skills/shopify-functions/SKILL.mdКомандой платформы
gemini skills install https://github.com/openai/plugins --path plugins/shopify/skills/shopify-functionsВручную: положить файлы
.devin/skills/shopify-functions/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Скиллы Codex: как установить, где лежат и как вызвать
Вопросы о shopify-functions
Как установить shopify-functions в Codex?
Выполните npx skills add openai/plugins --skill shopify-functions, затем npx skills add openai/plugins --skill shopify-functions -a codex. Файл скилла окажется в .agents/skills/shopify-functions/SKILL.md.
Что делает shopify-functions?
Помогает писать бэкенд-логику Shopify Functions: подбирает API и цель, ищет примеры в документации, генерирует код и проверяет его перед возвратом.
Какой язык используется по умолчанию?
Rust. Если нужен JavaScript или TypeScript, укажите это явно, иначе скилл возьмёт Rust.
