ворд-пресс.рф
AI-промпт

Промпт: создать AGENTS.md с правилами проекта WordPress

Готовое задание ИИ на анализ репозитория и создание рабочих правил для coding agent без секретов и ложных требований.

Готовый промпт

Ты — технический архитектор WordPress-проекта. Создай или обнови файл AGENTS.md в корне репозитория, опираясь ТОЛЬКО на реальные файлы и подтверждённые ограничения.

ВХОД: [путь к репозиторию или список файлов], [описание цели], [доступные команды проверки], [запрещённые операции].

ШАГИ:
1. Просмотри composer.json, package.json, конфигурацию сборки, основные точки входа PHP, плагины/mu-plugins, тему, CI и README.
2. Отдели факты от предположений. Версии WP/PHP, команды сборки и тестов не выдумывай. Если данных нет, пометь NEEDS CONFIRMATION.
3. Составь краткий AGENTS.md: структура проекта; как локально запустить; команды проверок; стиль кода; работа с данными; правила безопасности; требования к PR; запреты.
4. Запиши обязательные ограничения: не редактировать WordPress core; не менять чужие плагины; не хранить секреты; не запускать миграцию production без подтверждения; проверять capability/nonce, sanitize/escape; не объявлять тест успешным без исполнения.
5. Если есть несовместимые подкаталоги, предложи локальные инструкции, не создавая лишних файлов.
6. Проверь, что указанные команды реально существуют; выполненные проверки отчитай отдельно.

ВЫХОД: готовый AGENTS.md, список фактов-источников, неизвестных параметров и проверок. Минимизируй длину: агент должен быстро читать файл перед правками.

AGENTS.md — удобный способ передать coding agent правила репозитория: что можно менять, чем проверять код и какие операции запрещены. Это не универсальная гарантия соблюдения правил, а документ контекста, качество которого зависит от точности исходных данных.

Когда нужен

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

Что требуется от пользователя

Предоставьте структуру проекта, реальные команды тестов, версии WP/PHP и запретные изменения. Не вставляйте доступы к серверу, токены или содержимое .env. Если команды неизвестны, промпт должен требовать пометки «нужно уточнить», а не подставлять шаблон.

Как оценить AGENTS.md

  • Все упомянутые пути и инструменты существуют.
  • Команды проверки можно запустить в безопасном окружении.
  • Для публикации и миграций предусмотрено отдельное подтверждение.
  • Нет необоснованного утверждения о совместимости, автотестах и защите данных.
  • Документ не раскрывает секреты и не дублирует весь README.

Дополнительно

После создания AGENTS.md стоит проверить несколько небольших pull request: соблюдает ли агент структуру файлов, запускает ли тесты, не меняет ли WordPress core. Для полноценной разработки плагина есть проектный промпт для Codex.

Источник: https://developer.wordpress.org/plugins/plugin-basics/

Материал был полезен?

Помогите нам сделать материалы точнее и понятнее.