AIKraft/AI/Войти
AIKraft/Skills/payload

payload

Работает с проектами Payload: конфигурацией, коллекциями, полями, хуками, контролем доступа и API. Полезен при отладке ошибок валидации, проблем безопасности, запросов связей, транзакций и поведения хуков.

PAPayload official Разработка ★ 45.1k

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

Skill «payload» обеспечивает разработку приложений на базе Payload CMS с архитектурой Next.js и TypeScript, управляя конфигурацией, коллекциями, полями, хуками, контролем доступа и API. Он помогает решать задачи отладки ошибок валидации, проблем безопасности, запросов связей, транзакций и поведения хуков.

Когда применять

  • Настройка конфигурации коллекций, включая включение черновиков (drafts), автогенерацию слаг-полей и выбор полей для заголовка админ-панели.
  • Реализация контроля доступа (Access Control) с учетом типа безопасности (row-level security) и корректное использование параметра overrideAccess в Local API.
  • Настройка хуков (collection и field hooks) для вычисления полей, автоматической установки авторов/дат или предотвращения бесконечных циклов.
  • Выполнение сложных запросов к данным с использованием вложенных свойств, логики AND/OR, фильтрации связей и управления глубиной выборки (depth).

Как работает

  1. Инициализировать проект с помощью команды npx create-payload-app@latest и настроить базовую конфигурацию через buildConfig, указав базу данных (например, mongooseAdapter) и редактор.
  2. Определить коллекции (Collections) с полями (Fields), применяя стандарты: использовать versions: { drafts: true } для управления статусами и native slug-поле для слаг-генерации.
  3. Настроить хуки на уровне коллекции (для бизнес-логики документа) или на уровне поля (для вычисления/форматирования значений), избегая мутаций doc в afterRead.
  4. Применять контроль доступа (Access) с типизацией и корректно использовать Local API, устанавливая overrideAccess: false для пользователей и true только для системных задач.
  5. Выполнять запросы (Queries) с использованием параметров select, where, depth и sort, поддерживая вложенные свойства для связей и сложную логику AND/OR.

Примеры запросов агенту

Как настроить коллекцию 'Posts' с включенными черновиками, автогенерацией слага из заголовка и полем автора в боковой панели?
В чем разница между хуками на уровне коллекции и на уровне поля, и как правильно вычислять виртуальные поля?
Как безопасно использовать Local API для запроса данных от имени пользователя, чтобы не обойти контроль доступа ошибочным overrideAccess?

Что понадобится

  • Среда Next.js с TypeScript
  • Установленный пакет Payload и адаптер базы данных (например, @payloadcms/db-mongodb)
  • Переменные окружения (PAYLOAD_SECRET, DATABASE_URL)

Описание составлено по SKILL.md навыка, сверено 06.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «payloadcms-payload» из репозитория: # https://github.com/payloadcms/payload
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r payloadcms-payload/ ~/.claude/skills/payloadcms-payload/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.