AIKraft/Skills/contract-first

contract-first

Координирует работу фронтенда/бэкенда через единый проверяемый контракт (OpenAPI, AsyncAPI, Protocol Buffers, JSON Schema) с генерацией типов. Применяется, когда нужно параллельно развивать API без расхождений в данных и несовпадений с мок-данными.

affaan-m official Разработка ★ 273k

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

Навык обеспечивает координацию работы фронтенда, бэкенда или микросервисов через единый проверяемый контракт (OpenAPI, AsyncAPI, Protocol Buffers, JSON Schema). Потребители описывают необходимые данные, провайдеры реализуют эту структуру, а обе стороны верифицируют изменения по одному артефакту до интеграции.

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

  • Параллельная разработка фронтенда и бэкенда.
  • Обмен полезной нагрузкой, событиями или командами между двумя и более сервисами.
  • Регулярные расхождения в именах полей, обязательности (nullability), перечислениях или структуре ошибок.
  • Необходимость нескольких вызовов потребителем из-за того, что провайдер экспортирует модели хранения вместо задач-oriented ответов.
  • Изменения провайдера могут сломать потребителей, поддерживаемых другим человеком или агентом.

Как работает

  1. Определить контракт как единый проверяемый артефакт (OpenAPI, AsyncAPI, Protocol Buffers, JSON Schema).
  2. Потребители формулируют, какие данные им нужны, исходя из контракта.
  3. Провайдеры реализуют структуру данных в соответствии с контрактом.
  4. Обе стороны верифицируют изменения против одного и того же артефакта до интеграции.
  5. Генерировать типы на основе контракта для обеспечения согласованности.

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

Настраивай работу фронтенда и бэкенда через единый OpenAPI контракт, чтобы мы могли разрабатывать параллельно.
Используй contract-first подход для обмена событиями между сервисами, так как у нас часто дрейфуют поля и nullability.
Сгенерируй типы из контракта, чтобы мок-данные совпадали с продакшн-ответами.

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

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

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

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