Научите своего агента для написания кода создавать Blueprints для WordPress Playground – DocsWP

Новый навык blueprint agent обучает вашего агента программирования схеме Playground Blueprint, которая определяет допустимые имена свойств, типы ресурсов и последовательность шагов. Больше никаких pluginZipFile вместо pluginData. Больше никаких шагов runPHP без require '/wordpress/wp-load.php'.

Установите его один раз — и ваш агент будет с высокой вероятностью создавать корректный Blueprint JSONJSON JSON, или JavaScript Object Notation, — это минимальный, удобный для чтения формат структурирования данных. Он используется главным образом для передачи данных между сервером и веб-приложением как альтернатива XML., причём всё это — на естественном языке. Это идеально подходит для тестирования новых идей, поиска крайних случаев в ваших плагинах и тем, а также создания демонстраций ваших проектов.

Что делает навык blueprint

Навык представляет собой структурированный справочник в формате Markdown, который ваш агент программирования загружает в свой контекст. Он охватывает:

Все свойства верхнего уровня: landingPage, preferredVersions, features, steps, сокращённые формы (login, plugins, siteOptions, constants)
Все типы ресурсов: wordpress.org/plugins, wordpress.org/themes, url, git:directory, literal:directory, bundled
Справочник шагов: installPlugin, writeFile, writeFiles, runPHP, wp-cli, runSql и другие
Распространённые ошибки: таблица типичных проблем, с которой агент сверяется перед генерацией результата
Пакеты Blueprint: автономные пакеты со встроенными ресурсами

Агент читает этот справочник перед созданием любого Blueprint. Вместо того чтобы угадывать имена свойств, он следует документированной схеме.

Как установить навык

Для быстрой установки используйте npx skills CLICLI Интерфейс командной строки. Терминал (Bash) в Mac, командная строка в Windows или WP-CLI для WordPress., чтобы добавить навык blueprint в свой проект:

npx skills add wordpress/agent-skills --skill blueprint

Или установите его вручную: клонируйте репозиторий agent-skills и запустите скрипт сборки:

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 --dest=../your-wp-project --targets=claude,gemini,codex,cursor,vscode

Навык работает с Claude Code, Gemini CLI, GitHubGitHub GitHub — это веб-сайт, предлагающий размещение репозиториев git, которыми другие разработчики могут легко делиться, копировать и изменять. Публичные репозитории можно размещать бесплатно, а для частных требуется платная подписка. GitHub представил концепцию «pull request», благодаря которой изменения кода, выполненные участниками в ветках, можно просматривать и обсуждать до их объединения владельцем репозитория. https://github.com/ Copilot, Cursor и Codex.

Пять примеров

Каждый приведённый ниже пример показывает запрос, который вы даёте своему агенту, и созданный им Blueprint. Это реальные сценарии, в которых навык blueprint предотвращает распространённые ошибки.

1. Быстрая среда разработки

Запрос:

Create a Blueprint that sets up a development environment with
debug mode, the Developer plugin, and landing on the admin dashboard.

Созданный Blueprint:

{
  "$schema": "https://playground.wordpress.net/blueprint-schema.json",
  "landingPage": "/wp-admin/",
  "preferredVersions": { "php": "8.3", "wp": "latest" },
  "features": { "networking": true },
  "constants": {
    "WP_DEBUG": true,
    "WP_DEBUG_LOG": true
  },
  "login": true,
  "plugins": ["developer"],
  "steps": []
}

Обратите внимание, как агент использует сокращённую форму constants вместо шага defineWpConfigConsts, а также login: true вместо отдельного шага входа. Навык учит агентов выбирать сокращённые формы для простых случаев и явные шаги, когда важен порядок.

WordPress Admin panel showing the Developer plugin enabled via blueprint

2. ПлагинПлагин Плагин — это программное обеспечение, содержащее набор функций, которые можно добавить на веб-сайт WordPress. Плагины могут расширять функциональность или добавлять новые возможности вашим сайтам WordPress. Плагины WordPress написаны на языке PHP и бесшовно интегрируются с WordPress. Они могут быть бесплатными в каталоге плагинов WordPress.org https://wordpress.org/plugins/ или платными, предлагаемыми сторонними разработчиками. из ветки GitHub

Запрос:

Write a Blueprint that installs my plugin from the feature/checkout-v2
branch on GitHub and activates it.

Созданный Blueprint:

{
  "$schema": "https://playground.wordpress.net/blueprint-schema.json",
  "landingPage": "/wp-admin/plugins.php",
  "preferredVersions": { "php": "8.3", "wp": "latest" },
  "steps": [
    { "step": "login" },
    {
      "step": "installPlugin",
      "pluginData": {
        "resource": "git:directory",
        "url": "https://github.com/your-org/your-plugin",
        "ref": "feature/checkout-v2",
        "refType": "branch",
        "path": "/"
      },
      "options": { "activate": true }
    }
  ]
}

Без этого навыка агенты часто пропускают refType, из-за чего git:directory не работает с именами веток. Таблица распространённых ошибок в навыке явно отмечает это: «Пропуск refType при использовании ref с веткой или тегом — обязательно; без него работает только HEAD».

3. Магазин WooCommerce с демонстрационными товарами

Запрос:

Create a Blueprint for a WooCommerce store with 5 sample products
across 2 categories, running on PHP 8.2.

Созданный Blueprint:

{
  "$schema": "https://playground.wordpress.net/blueprint-schema.json",
  "landingPage": "/shop/",
  "preferredVersions": { "php": "8.2", "wp": "latest" },
  "features": { "networking": true },
  "steps": [
    { "step": "login" },
    {
      "step": "installPlugin",
      "pluginData": { "resource": "wordpress.org/plugins", "slug": "woocommerce" },
      "options": { "activate": true }
    },
    {
      "step": "runPHP",
      "code": "<?php\nrequire '/wordpress/wp-load.php';\n\n// Create categories\n$cat_clothing = wp_insert_term('Clothing', 'product_cat');\n$cat_accessories = wp_insert_term('Accessories', 'product_cat');\n\n$products = [\n  ['T-Shirt', 29.99, $cat_clothing['term_id']],\n  ['Hoodie', 59.99, $cat_clothing['term_id']],\n  ['Jeans', 49.99, $cat_clothing['term_id']],\n  ['Watch', 89.99, $cat_accessories['term_id']],\n  ['Backpack', 39.99, $cat_accessories['term_id']]\n];\n\nforeach ($products as [$title, $price, $cat_id]) {\n  $post_id = wp_insert_post([\n    'post_title' => $title,\n    'post_type' => 'product',\n    'post_status' => 'publish'\n  ]);\n  update_post_meta($post_id, '_regular_price', $price);\n  update_post_meta($post_id, '_price', $price);\n  wp_set_object_terms($post_id, [$cat_id], 'product_cat');\n}\n"
    }
  ]
}

Навык гарантирует, что агент добавляет require '/wordpress/wp-load.php' в начало каждого шага runPHP. Без этой строки все функции WordPress завершаются без вывода ошибок — это частая ошибка агентов, не использующих справочник навыка.

WordPress Playground Loading a store with 5 products in a woo store.

4. Встроенный mu-плагин для пользовательской логики

Запрос:

Write a Blueprint that disables the admin bar and adds a custom
dashboard widget showing the server's PHP version.

Созданный Blueprint:

{
  "$schema": "https://playground.wordpress.net/blueprint-schema.json",
  "landingPage": "/wp-admin/",
  "preferredVersions": { "php": "8.3", "wp": "latest" },
  "steps": [
    { "step": "login" },
    {
      "step": "writeFile",
      "path": "/wordpress/wp-content/mu-plugins/custom-dashboard.php",
      "data": "<?php\nadd_filter('show_admin_bar', '__return_false');\n\nadd_action('wp_dashboard_setup', function() {\n  wp_add_dashboard_widget(\n    'php_version_widget',\n    'PHP Version',\n    function() {\n      echo '<p>Running PHP ' . phpversion() . '</p>';\n    }\n  );\n});"
    }
  ]
}

Агент использует writeFile для создания mu-плагина, который загружается автоматически без активации. Навык явно документирует этот шаблон и предупреждает агентов не добавлять require wp-load.php в код mu-плагина (эта строка нужна только в шагах runPHP).

5. Пакет Blueprint с пользовательским плагином

Запрос:

Create a Blueprint bundle that installs a custom analytics plugin
from a local zip file.

Структура созданного пакета:

analytics-bundle/
├── blueprint.json
└── analytics-plugin.zip

blueprint.json:

{
  "$schema": "https://playground.wordpress.net/blueprint-schema.json",
  "landingPage": "/wp-admin/plugins.php",
  "preferredVersions": { "php": "8.3", "wp": "latest" },
  "steps": [
    { "step": "login" },
    {
      "step": "installPlugin",
      "pluginData": {
        "resource": "bundled",
        "path": "/analytics-plugin.zip"
      },
      "options": { "activate": true }
    }
  ]
}

Запуск локально:

npx @wp-playground/cli server --blueprint=./analytics-bundle/ --blueprint-may-read-adjacent-files

Флаг --blueprint-may-read-adjacent-files необходим для пакетов-каталогов. Без него любая ссылка на ресурс bundled завершается ошибкой «Файл не найден». Навык документирует эту особенность, поэтому агенты автоматически добавляют флаг.

Как навык blueprint сочетается с другими инструментами

Навык blueprint работает вместе с двумя другими инструментами Playground для ИИ-агентов:

Инструмент	Что он делает	Когда использовать
Навык Blueprint	Создаёт корректный JSON Blueprint	Когда нужен файл Blueprint для обмена, контроля версий или CI
Навык wp-playground	Запускает команды CLI, управляет серверами, отлаживает экземпляры	Когда нужен работающий экземпляр Playground с интерактивным взаимодействием
MCP-сервер	Подключает агентов напрямую к Playground в браузере	Когда нужны выполнение PHPPHP PHP (рекурсивная аббревиатура от PHP: Hypertext Preprocessor) — широко распространённый скриптовый язык общего назначения с открытым исходным кодом, особенно подходящий для веб-разработки и встраиваемый в HTML. https://www.php.net/manual/en/index.php в реальном времени и работа с файлами

Используйте навык blueprint, когда вам нужна переносимая и воспроизводимая конфигурация. Используйте навык wp-playground, когда нужен работающий сервер. Сочетайте их: создайте Blueprint с помощью навыка blueprint, а затем запустите его с помощью команд CLI навыка wp-playground.

Протестируйте свои Blueprint

Встроенный URLURL Конкретный веб-адрес веб-сайта или веб-страницы в интернете, например URL сайта www.wordpress.org (быстрый тест)

Минифицируйте JSON Blueprint и добавьте его в URL Playground:

https://playground.wordpress.net/#{"preferredVersions":{"php":"8.3","wp":"latest"},"steps":[{"step":"login"}]}

Локальный CLI (полный тест)

# Start a server with your Blueprint
npx @wp-playground/cli server --blueprint=./blueprint.json

# Headless validation (runs and exits)
npx @wp-playground/cli run-blueprint --blueprint=./blueprint.json

Начните работу

Установите навык blueprint в свой проект:

npx skills add wordpress/agent-skills --skill blueprint

Затем попросите своего агента написать Blueprint. Опишите, что вам нужно: плагины, темы, контент, конфигурация — и агент создаст корректный JSON, который запустится с первой попытки.

Расскажите о своих проектах в канале #playground в Making WordPress Slack или создайте issue на GitHub.

#agent-skills, #ai