Перейти к содержимому

Разработка блоков с учетом ИИ

Файлы без этапа сборки — именно с ними агенты работают лучше всего.

Беззвучная запись экрана: агент для написания кода создаёт полноценный сайт WordPress с 10 пользовательскими блоками и 6 страницами по одному запросу.

Опишите блок — получите блок

ИИ-агенты для написания кода могут создавать каркас блоков, страниц и паттернов по одному запросу. Без графического интерфейса и базы данных — только файлы.

~/starter-theme

❯ Создай блок с ценами и тремя тарифами, переключателем между оплатой за месяц и за год и призывом к действию для каждого тарифа.

✓ Создано pricing/block.json

✓ Создано pricing/index.php

✓ Создано pricing/style.css

❯ Теперь создай страницу с ценами, главным экраном и разделом FAQ.

✓ Создано pages/pricing/page.json

✓ Создано pages/pricing/index.php

Файлы

blockstudio/

├── pricing/ Новое

├── block.json

├── index.php

└── style.css

pages/

├── pricing/ Новое

├── page.json

└── index.php

Всё в файлах

Блоки, страницы, шаблоны и расширения — это каталоги с конфигурацией и шаблонами JSON. Агенты читают и записывают их напрямую.

Никакой конфигурации базы данных

Не нужно переходить по панелям администратора. Каждая настройка — это ключ JSON, поэтому агент может создать библиотеку без браузера.

Предсказуемая структура

Все блоки устроены одинаково: block.json, шаблон и необязательные стили. Освойте принцип один раз.

Контекст вместо догадок

Краткий индекс документации и ее полный текст для инструментов, которым нужно всё содержимое.

Индекс, который агент читает первым

blockstudio-llm.txt один раз перечисляет каждый документ, указывая его маршрут, исходный файл, назначение, настройки, хуки, функции PHP и команды CLI. Индекс объемом около 11k токенов агент читает целиком, а затем открывает только нужную страницу.

blockstudio-llm-full.txt содержит все документы и схемы JSON в одном файле объемом около 169k токенов — для инструментов, которым нужен весь корпус. Включите ai.enableContextGeneration, и сайт будет предоставлять оба варианта.

blockstudio-llm.txt
# Blockstudio documentation index

This is the primary context file for coding assistants. It is an index, not
the documentation itself. Each entry names one document, what it is for, and
the identifiers that document owns. Read this index, then open only the
document you need.

Every document is addressable two ways: as a URL on https://blockstudio.dev,
and as a Markdown file in the Blockstudio repository. The full text of every
document and schema is also available in one file at /blockstudio-llm-full.txt
for tools that want everything at once.

Контракт для вашего проекта

В документации описан Blockstudio. AGENTS.md описывает проект, который агент собирается изменить.

Одна команда создает AGENTS.md

vendor/bin/blockstudio-agents описывает проект, в котором работает: его содержимое, функции, включаемые blockstudio.json, причины отклонения анализа и применимые команды.

Каждая строка берется из ваших файлов, настроек или выбранного профиля анализа. Повторная генерация сохраняет заметки, написанные вручную, а --check завершается ошибкой, если контракт устарел.

AGENTS.md
# Blockstudio contract for Acme

## Project

- Kind: WordPress theme `Acme`.
- Configuration: `blockstudio.json`.
- Analysis preset: `extreme-theme`.

## What this project contains

- Blocks: 1 in `blockstudio`.
- Pages: 1 in `pages`.
- Block namespaces: `acme`.
- Block templates are written in PHP.

Ошибки выявляются до коммита

Четыре готовых набора проверок, каждый включает предыдущий, и хук, запускающий их при каждом коммите.

Анализ с учетом block.json

Профили blockstudio/phpstan анализируют ваши блоки, страницы и настройки. Анализ не пройдет, если шаблон читает поле, которое не объявлено в его block.json, или выводит его без экранирования.

Шаблоны получают типизированный $a из файла block.json рядом с ними; для каждого типа поля предусмотрен конкретный тип PHP, а Db::get() возвращает записи, соответствующие структуре db.php. При ошибке в пути к настройке или имени хука выводится подсказка с ближайшим подходящим именем.

Задайте githooks.commit и запустите vendor/bin/blockstudio-githooks sync: управляемый хук pre-commit выполняет тот же анализ, поэтому сломанный блок не попадет в коммит.

blockstudio.json
{
  "$schema": "https://blockstudio.dev/schema/blockstudio",
  "phpstan": { "preset": "extreme-theme" },
  "githooks": { "commit": true }
}

base

Все ключи $a, которые читает шаблон, существуют в block.json; хуки, пути настроек и теги блоков настоящие.

theme

Заголовки тем, объявленные ресурсы, область действия %selector%, значения полей по умолчанию и ограничения повторителей.

extreme-theme

Максимум PHPStan, экранированный вывод, без вызова внешних команд, допустимые классы Tailwind и чистый JavaScript.

wordpress-render

Тема Extreme и предоставляемый вами зонд для проверки рендеринга WordPress в реальном времени. Он работает без командной оболочки, а ошибка рендеринга отображается как замечание.

Twig, Blade и скрипты

Twig, Blade и теги блоков проверяются по одним и тем же полям. Уровень Extreme также проверяет JavaScript и директивы Interactivity на соответствие разметке и хранилищам.

Существующие проекты

Базовая конфигурация PHPStan скрывает уже зарегистрированные замечания, пока новый код проходит полную проверку по предустановке. blockstudioScanRoots считывает библиотеки блоков за пределами корневого каталога, а поставляемые заглушки задают типы публичного API.

Инвентаризация и рендеринг из PHP

Нескольких вызовов достаточно, чтобы агент узнал, что регистрирует проект, отобразил любую его часть и проверил сохраненные данные.

Задайте вопрос проекту, получите ответ

Canvas::inventory() возвращает все страницы, блоки, шаблоны, шаблоны Site Editor, части шаблонов и примеры UI, зарегистрированные проектом, ничего не отображая.

Render::document() отображает любой из них как целый документ HTML, включая только использованные ресурсы, чтобы агент мог проверить результат вне редактора.

Canvas::documents() рендерит именно выбранные вами записи. Render::composition() и Render::content() возвращают вложенные объявления или сериализованное содержимое блока в виде HTML, а Ui::inventory() и Ui::examples() перечисляют встроенные семейства компонентов, для каждого из которых доступно одно объявление для рендеринга.

Для одного блока bs_block_fields(), bs_block_extension_fields(), bs_block_values() и bs_block_assets() возвращают его поля, значения и ресурсы без рендеринга, а bs_validate_block() проверяет сохранённые атрибуты перед их сохранением.

inspect.php
use Blockstudio\Canvas;
use Blockstudio\Render;

$project = Canvas::inventory(['blocks' => true]);

foreach ($project['inventory']['blocks'] as $block) {
  echo $block['name'] . "\n";
}

$doc = Render::document(
  ['name' => 'acme/hero', 'data' => ['heading' => 'Hello']],
  ['title' => 'Hero preview']
);

file_put_contents('hero.html', $doc['html']);

Менее половины токенов на страницу

Агенты пишут обычный HTML. При синхронизации Blockstudio преобразует его в сериализованную разметку блоков WordPress: меньше нужно генерировать и меньше шансов ошибиться.

Blockstudio

Что создают агенты

Около 135 токенов
index.php
<h1>Build Websites That Convert</h1>
<p>The all-in-one platform for creating
beautiful, high-performance landing pages.</p>

<block name="core/columns">
  <block name="core/column">
    <h3>Lightning Fast</h3>
    <p>Pages load in under one second.</p>
  </block>
  <block name="core/column">
    <h3>Easy to Use</h3>
    <p>No technical skills required.</p>
  </block>
  <block name="core/column">
    <h3>SEO Optimized</h3>
    <p>Built-in best practices from day one.</p>
  </block>
</block>

<img src="/dashboard.jpg" alt="Dashboard" />

WordPress

Что для него создаёт парсер

Около 310 токенов
post_content
<!-- wp:heading {"level":1} -->
<h1 class="wp-block-heading">Build Websites That Convert</h1>
<!-- /wp:heading -->
<!-- wp:paragraph -->
<p>The all-in-one platform for creating
beautiful, high-performance landing pages.</p>
<!-- /wp:paragraph -->
<!-- wp:columns -->
<div class="wp-block-columns">
  <!-- wp:column -->
  <div class="wp-block-column">
    <!-- wp:heading {"level":3} -->
    <h3 class="wp-block-heading">Lightning Fast</h3>
    <!-- /wp:heading -->
    <!-- wp:paragraph -->
    <p>Pages load in under one second.</p>
    <!-- /wp:paragraph -->
  </div>
  <!-- /wp:column -->
  <!-- wp:column -->
  <div class="wp-block-column">
    <!-- wp:heading {"level":3} -->
    <h3 class="wp-block-heading">Easy to Use</h3>
    <!-- /wp:heading -->
    <!-- wp:paragraph -->
    <p>No technical skills required.</p>
    <!-- /wp:paragraph -->
  </div>
  <!-- /wp:column -->
  <!-- wp:column -->
  <div class="wp-block-column">
    <!-- wp:heading {"level":3} -->
    <h3 class="wp-block-heading">SEO Optimized</h3>
    <!-- /wp:heading -->
    <!-- wp:paragraph -->
    <p>Built-in best practices from day one.</p>
    <!-- /wp:paragraph -->
  </div>
  <!-- /wp:column -->
</div>
<!-- /wp:columns -->
<!-- wp:image {"alt":"Dashboard","url":"/dashboard.jpg"} -->
<figure class="wp-block-image"><img src="/dashboard.jpg" alt="Dashboard"/></figure>
<!-- /wp:image -->

Измерено на двух панелях выше: 540 символов HTML против 1,233 символов разметки блока, которую для него создаёт стандартный парсер; разделили на четыре — обычную оценку количества символов на токен. Для удобства чтения в разметку добавлены переносы строк.

Меньше текста для генерации

Агенты пишут HTML без разделителей блоков, сгенерированных классов и обертки разметки.

Меньше шансов ошибиться

Парсер гарантирует корректный вывод блоков из более простого исходного текста.

Быстрее и дешевле

Меньше токенов в ответе — быстрее ответы и ниже расходы на модели.

Работает со всеми инструментами программирования с ИИ

Любой агент, который умеет читать и записывать файлы, сразу работает с Blockstudio.

Claude Code
Codex CLI
Gemini CLI
Cursor
Windsurf
Amp

Создано для работы с ИИ

Блоки, страницы, шаблоны, настройки — всё хранится в файлах, которые агент может читать, записывать и изменять.

Два файла на блок

Конфигурация JSON и шаблон — это весь блок. Небольшой объем делает надежной генерацию с первой попытки.

27 типов полей

Текст, файлы, повторители, цвета, даты и многое другое задаются в JSON. Списки выбора заполняются записями, терминами и пользователями.

Проверка схемы JSON

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

Автоматическая регистрация

Поместите файлы в каталог, и блоки зарегистрируются автоматически — список конфигураций не нужен.

Обзор холста

Все управляемые страницы или все блоки со значениями по умолчанию в одном масштабируемом представлении.

Интерактивный холст

В режиме Live изменённые монтажные области обновляются через Server-Sent Events примерно через секунду после сохранения. Нажмите на метку, чтобы перейти к нужной монтажной области.

Встроено в Tailwind

TailwindPHP компилирует классы, используемые каждой страницей, без настройки Node.

Element Grabber

Скопируйте путь к шаблону элемента и его разметку, чтобы сразу дать агенту нужный контекст.

HTML в блоки

Страницы и шаблоны — это обычные файлы, которые становятся встроенными блоками WordPress.

Дымовой тест рендеринга

Команда wp bs blocks render рендерит каждый блок так же, как на странице, и завершает работу с кодом 1, если шаблон выдаёт уведомление, предупреждение или ошибку.

Проверка сохранённого содержимого

Команда wp bs blocks validate проверяет сохранённые поля записей, а pages sync предупреждает об атрибутах, которые блок сохраняет, но никогда не выводит.

Проверка из терминала

Просматривайте настройки, пользовательские поля и ресурсы с помощью wp bs, а также компилируйте фрагмент кода или файл командами wp bs tailwind compile и wp bs scss compile.

Plus

Официальный набор расширений

Премиум-шаблоны сайтов, системные инструкции для ИИ и закрытое сообщество Discord. Разовая покупка, обновления навсегда.

  • 500+ шаблонов сайтов
  • Системные инструкции для ИИ
  • Пожизненные обновления
  • Закрытое сообщество Discord