Как перестать спорить с нейросетями о правилах разработки в WordPress

04 May, 2026

Знакомая история: просишь Claude или Cursor набросать структуру нового блока для WordPress, а в ответ получаешь код десятилетней давности. Нейросеть уверенно предлагает использовать jQuery там, где давно нужен React, или «забывает» про регистрацию стилей в block.json. Это происходит потому, что базовые модели обучались на огромном массиве данных, включая легаси-код и устаревшие туториалы из 2015 года.

Команда разработчиков WordPress решила эту проблему изящно. Они создали репозиторий agent-skills — это набор инструкций и скриптов, которые буквально «обучают» вашего ИИ-ассистента актуальным стандартам разработки прямо в процессе работы.

Что это за проект

По сути, это официальный справочник навыков для ИИ. Если раньше нам приходилось копировать куски документации в промпт, то теперь можно один раз подключить нужный «скилл». Это пачка Markdown-файлов с четкими чек-листами и правилами, которые Claude, Cursor или Copilot подхватывают автоматически.

Проект закрывает дыру между тем, что нейросеть «думает» о WordPress, и тем, как движок работает в версии 6.7+.

На что способны эти навыки

Разработчики разбили знания на логические модули. Можно не тащить всё сразу, а выбрать только то, что нужно для конкретной задачи.

  • Разработка блоков. Это, пожалуй, самая полезная часть. Скилл wp-block-development заставляет ассистента следовать современной структуре: правильно описывать атрибуты, обрабатывать депрекации (чтобы не ловить «Invalid block» в редакторе) и использовать серверный рендеринг там, где это уместно.
  • Работа с темами. Если вы переходите на Block Themes, навык wp-block-themes подскажет ИИ, как работать с theme.json, паттернами и вариациями стилей. Больше никаких попыток нейросети создать классический header.php в блочной теме.
  • Интерактивность и API. Сюда включили инструкции по Interactivity API (те самые data-wp-* директивы) и правильную настройку REST API. Ассистент начинает понимать разницу между простым Capability и сложной проверкой прав в контексте REST.
  • Инструментарий и статанализ. Есть даже навыки для работы с WP-CLI и настройки PHPStan специально под специфику WordPress.

Интересно, что сами эти инструкции изначально генерировались с помощью GPT-5.2 Codex на основе официальной документации Gutenberg, а затем вручную правились контрибьюторами ядра.

Как это работает технически

Каждый навык в репозитории — это не просто текст. Структура выглядит так:

  1. SKILL.md — основная инструкция: когда использовать, какой алгоритм действий выбрать и как проверить результат.
  2. references/ — глубокое погружение в детали, например, спецификация block.json.
  3. scripts/ — небольшие JS-хелперы, которые ассистент может запустить для валидации или сканирования проекта.

Когда вы просите Claude Code или Cursor что-то сделать, они первым делом лезут в папку со скиллами, видят там правила игры и начинают выдавать код, который не стыдно отправить на код-ревью.

Как быстро подключить к работе

У проекта есть удобный скрипт для установки. Если вы пользуетесь Claude Code, можно поставить всё глобально:

git clone https://github.com/WordPress/agent-skills.git
cd agent-skills
node shared/scripts/skillpack-build.mjs --clean
node shared/scripts/skillpack-install.mjs --global

Для Cursor или VS Code Copilot лучше устанавливать навыки прямо в репозиторий проекта. Скрипт сам создаст нужные папки (.cursor/skills/ или .github/skills/) и разложит файлы:

node shared/scripts/skillpack-install.mjs --dest=../my-wp-plugin --targets=cursor,vscode

Если не хочется возиться с консолью, можно просто вручную скопировать папку нужного навыка из skills/ в инструкции вашего ИИ-ассистента.

Чего не стоит ждать

Проект пока в версии v1. Это значит, что нейросеть всё еще может ошибаться, даже со скиллами. Инструкции помогают направить «мысль» ИИ в нужное русло, но не заменяют понимание архитектуры.

Кроме того, база знаний в основном заточена под современный стек Gutenberg. Если вы поддерживаете старый проект на классических темах и Advanced Custom Fields без блоков, профита будет меньше.

Если вы ежедневно используете ИИ для написания кода под WordPress, этот репозиторий — маст-хэв. Он экономит время на бесконечные правки галлюцинаций нейросети и помогает держать код в едином стиле с ядром системы.

Особенно полезно будет командам: можно закинуть эти скиллы в репозиторий проекта, и у всех разработчиков (и их ИИ-помощников) будет общая база правил. Попробовать точно стоит, тем более что установка занимает пару минут.