# contract-testing-builder

Скилл contract-testing-builder внедряет контрактное тестирование API через Pact, OpenAPI и JSON Schema, чтобы изменения на бэкенде не ломали клиентские сервисы.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 266 установок · ★ 64 у репозитория
- Автор: patricio0312rev
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/patricio0312rev/skills/tree/HEAD/testing/contract-testing-builder/SKILL.md
- Обновлён: 2026-01-12
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/contract-testing-builder

## Что делает

Скилл помогает выстроить проверку контрактов между потребителем и поставщиком API. В примерах он опирается на библиотеку `@pact-foundation/pact` — класс `PactV3` на стороне клиента и `Verifier` со стейт-хендлерами на стороне сервера. Это позволяет тестировать сетевые вызовы на локальном мок-сервере без поднятия полного интеграционного контура.

Внутри также заложены шаблоны проверки схем через OpenAPI 3.0 с пакетом `express-openapi-validator` и валидация данных библиотекой `Ajv` с плагином `ajv-formats`. Все примеры ориентированы на Node.js и TypeScript: если эти зависимости не установлены в репозитории, сгенерированные тесты просто не запустятся.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add patricio0312rev/skills --skill contract-testing-builder -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/contract-testing-builder/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/contract-testing-builder/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add patricio0312rev/skills --skill contract-testing-builder -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/contract-testing-builder/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add patricio0312rev/skills --skill contract-testing-builder -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/contract-testing-builder/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install patricio0312rev/skills testing/contract-testing-builder/SKILL.md
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/contract-testing-builder/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add patricio0312rev/skills --skill contract-testing-builder -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/patricio0312rev/skills --path testing/contract-testing-builder
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/contract-testing-builder/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add patricio0312rev/skills --skill contract-testing-builder -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/patricio0312rev/skills/tree/HEAD/testing/contract-testing-builder/SKILL.md

## Когда брать
- Зафиксировать требования клиента к эндпоинтам через PactV3
- Проверить совместимость ответов сервера с файлом контракта через Verifier
- Валидировать запросы и ответы Express-приложения по схеме OpenAPI 3.0
- Протестировать JSON-структуры данных с помощью Ajv

## Примеры запросов агенту
- Напиши контрактный тест для GET /api/users/123 с использованием PactV3
- Сгенерируй спецификацию OpenAPI 3.0 для эндпоинта пользователей и добавь express-openapi-validator
- Создай тест провайдера с верификацией контрактов и очисткой базы данных

## Похожие
- [api-contract-testing](https://affpapa.org/nevibecode/skills/secondsky-api-contract-testing.md) — скилл · 498 установок
- [qe-contract-testing](https://affpapa.org/nevibecode/skills/qe-contract-testing.md) — скилл · 115 установок
- [contract-testing](https://affpapa.org/nevibecode/skills/contract-testing.md) — скилл · 1400 установок
- [swagger-contract-testing](https://affpapa.org/nevibecode/plugins/swagger-contract-testing.md) — плагин · ★ 7 у репозитория
- [swagger-contract-testing-openapi-parser](https://affpapa.org/nevibecode/plugins/swagger-contract-testing-openapi-parser.md) — плагин · ★ 7 у репозитория
- [api-testing-patterns](https://affpapa.org/nevibecode/skills/api-testing-patterns.md) — скилл · 618 установок

Из того же набора: [patricio0312rev/skills](https://affpapa.org/nevibecode/by/patricio0312rev/skills.md) — 148 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
