contract-first
Координирует работу фронтенда/бэкенда через единый проверяемый контракт (OpenAPI, AsyncAPI, Protocol Buffers, JSON Schema) с генерацией типов. Применяется, когда нужно параллельно развивать API без расхождений в данных и несовпадений с мок-данными.
Что делает навык
Навык обеспечивает координацию работы фронтенда, бэкенда или микросервисов через единый проверяемый контракт (OpenAPI, AsyncAPI, Protocol Buffers, JSON Schema). Потребители описывают необходимые данные, провайдеры реализуют эту структуру, а обе стороны верифицируют изменения по одному артефакту до интеграции.
Когда применять
- Параллельная разработка фронтенда и бэкенда.
- Обмен полезной нагрузкой, событиями или командами между двумя и более сервисами.
- Регулярные расхождения в именах полей, обязательности (nullability), перечислениях или структуре ошибок.
- Необходимость нескольких вызовов потребителем из-за того, что провайдер экспортирует модели хранения вместо задач-oriented ответов.
- Изменения провайдера могут сломать потребителей, поддерживаемых другим человеком или агентом.
Как работает
- Определить контракт как единый проверяемый артефакт (OpenAPI, AsyncAPI, Protocol Buffers, JSON Schema).
- Потребители формулируют, какие данные им нужны, исходя из контракта.
- Провайдеры реализуют структуру данных в соответствии с контрактом.
- Обе стороны верифицируют изменения против одного и того же артефакта до интеграции.
- Генерировать типы на основе контракта для обеспечения согласованности.
Примеры запросов агенту
Описание составлено по SKILL.md навыка, сверено 06.10.2026.
Как подключить
SKILL.md к навыкам ассистентаНавык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.