К основному содержанию
скилл CX Codex

contract-testing · proffesor-for-testing — скилл для Claude Code: что делает и как установить

Скилл contract-testing помогает настроить контрактное тестирование API и микросервисов с помощью Pact и предотвратить поломки при деплое.

MIT 130 установок ★ 533 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add proffesor-for-testing/agentic-qe --skill contract-testing -a claude-code
Открыть на GitHub

Что делает contract-testing

Скилл внедряет подход consumer-driven contracts для распределённых систем. Агент описывает ожидания потребителей API, генерирует тесты взаимодействия через Pact или JSON Schema, сверяет схемы и блокирует несовместимые изменения.

Под капотом задействованы специализированные роли: qe-api-contract-validator для сверки контрактов между версиями и qe-test-generator для создания тестов провайдера. Изменения сопоставляются с семантическим версионированием: удаление или переименование полей помечается как мажорный релиз.

Без настроенного адреса Pact Broker генератор создаст тесты, которые тихо пропустят этап верификации.

Какие задачи решает

  • найти несовместимые изменения в контрактах OpenAPI
  • написать тесты взаимодействия на базе Pact
  • проверить обратную совместимость API перед релизом
  • настроить проверку can-i-deploy в CI/CD

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

  • Сравни openapi-v1.yaml и openapi-v2.yaml на несовместимые изменения и подскажи версию SemVer.
  • Напиши Pact-тест для потребителя сервиса заказов OrderService.
  • Настрой шаг верификации контрактов провайдера для пайплайна GitHub Actions.

Как установить contract-testing

1Через Skills CLI (Vercel)

npx skills add proffesor-for-testing/agentic-qe --skill contract-testing -a claude-code

2Вручную: положить файлы

~/.claude/skills/contract-testing/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/contract-testing/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о contract-testing

Как установить contract-testing в Claude Code?

Выполните в терминале команду npx skills add proffesor-for-testing/agentic-qe --skill contract-testing -a claude-code.

Что делает скилл contract-testing?

Он помогает выстраивать контрактное тестирование микросервисов, выявлять ломающие изменения в API и генерировать тесты провайдера и потребителя на базе Pact.

Что требуется настроить для корректной верификации тестов?

Обязательно укажите URL для Pact Broker до запуска тестов. Без этого сгенерированные тесты пропустят верификацию без явных сообщений об ошибке.

Исходный текст

SKILL.md · MIT
---
name: contract-testing
description: "Consumer-driven contract testing for microservices using Pact, schema validation, API versioning, and backward compatibility testing. Use when testing API contracts or coordinating distributed teams."
category: testing-methodologies
priority: high
tokenEstimate: 900
agents: [qe-api-contract-validator, qe-test-generator, qe-security-scanner]
implementation_status: optimized
optimization_version: 1.0
last_optimized: 2025-12-02
dependencies: []
quick_reference_card: true
tags: [contract, pact, consumer-driven, api, microservices, schema-validation]
trust_tier: 3
validation:
  schema_path: schemas/output.json
  validator_path: scripts/validate-config.json
  eval_path: evals/contract-testing.yaml
---

# Contract Testing

<default_to_action>
When testing API contracts or microservices:
1. DEFINE consumer expectations (what consumers actually need)
2. VERIFY provider fulfills contracts (Pact verification)
3. DETECT breaking changes before deployment (CI/CD integration)
4. VERSION APIs semantically (breaking = major bump)
5. MAINTAIN backward compatibility for supported versions

**Quick Contract Testing Steps:**
- Consumer: Define expected request/response pairs
- Provider: Verify against all consumer contracts
- CI/CD: Block deploys that break contracts
- Versioning: Document supported versions and deprecation

**Critical Success Factors:**
- Consumers own the contract (they define what they need)
- Provider must pass all consumer contracts before deploy
- Breaking changes require coordination, not surprise
</default_to_action>

## Quick Reference Card

### When to Use
- Microservices communication
- Third-party API integrations
- Distributed team coordination
- Preventing breaking changes

### Consumer-Driven Contract Flow
```
Consumer → Defines Expectations → Contract
                    ↓
Provider → Verifies Contract → Pass/Fail
                    ↓
CI/CD → Blocks Breaking Changes
```

### Breaking vs Non-Breaking Changes
| Change Type | Breaking? | Semver |
|-------------|-----------|--------|
| Remove field | ✅ Yes | Major |
| Rename field | ✅ Yes | Major |
| Change type | ✅ Yes | Major |
| Add optional field | ❌ No | Minor |
| Add new endpoint | ❌ No | Minor |
| Bug fix | ❌ No | Patch |

### Tools
| Tool | Best For |
|------|----------|
| **Pact** | Consumer-driven contracts |
| **OpenAPI/Swagger** | API-first design |
| **JSON Schema** | Schema validation |
| **GraphQL** | Schema-first contracts |

---

## Consumer Contract (Pact)

```javascript
// Consumer defines what it needs
const { Pact } = require('@pact-foundation/pact');

describe('Order API Consumer', () => {
  const provider = new Pact({
    consumer: 'CheckoutUI',
    provider: 'OrderService'
  });

  beforeAll(() => provider.setup());
  afterAll(() => provider.finalize());

  it('creates an order', async () => {
    await provider.addInteraction({
      state: 'products exist',
      uponReceiving: 'a create order request',
      withRequest: {
        method: 'POST',
        path: '/orders',
        body: { productId: 'abc', quantity: 2 }
      },
      willRespondWith: {
        status: 201,
        body: {
          orderId: like('order-123'),  // Any string matching pattern
          total: like(19.99)           // Any number
        }
      }
    });

    const response = await orderClient.create({ productId: 'abc', quantity: 2 });
    expect(response.orderId).toBeDefined();
  });
});
```

---

## Provider Verification

```javascript
// Provider verifies it fulfills all consumer contracts
const { Verifier } = require('@pact-foundation/pact');

describe('Order Service Provider', () => {
  it('fulfills all consumer contracts', async () => {
    await new Verifier({
      provider: 'OrderService',
      providerBaseUrl: 'http://localhost:3000',
      pactUrls: ['./pacts/checkoutui-orderservice.json'],
      stateHandlers: {
        'products exist': async () => {
          await db.products.create({ id: 'abc', price: 9.99 });
        }
      }
    }).verifyProvider();
  });
});
```

---

## Breaking Change Detection

```typescript
// Agent detects breaking changes
await Task("Contract Validation", {
  currentContract: 'openapi-v2.yaml',
  previousContract: 'openapi-v1.yaml',
  detectBreaking: true,
  calculateSemver: true,
  generateMigrationGuide: true
}, "qe-api-contract-validator");

// Output:
// Breaking changes found: 2
// - Removed field: order.discount
// - Type change: order.total (number → string)
// Recommended version: 3.0.0 (major bump)
```

---

## CI/CD Integration

```yaml
name: Contract Tests
on: [push]

jobs:
  consumer-tests:
    steps:
      - run: npm run test:contract
      - name: Publish Pacts
        run: npx pact-broker publish ./pacts --broker-base-url $PACT_BROKER

  provider-verification:
    needs: consumer-tests
    steps:
      - name: Verify Provider
        run: npm run verify:contracts
      - name: Can I Deploy?
        run: npx pact-broker can-i-deploy --pacticipant OrderService --version $VERSION
```

---

## Agent Coordination Hints

### Memory Namespace
```
aqe/contract-testing/
├── contracts/*           - Current contracts
├── breaking-changes/*    - Detected breaking changes
├── versioning/*          - Version compatibility matrix
└── verification-results/* - Provider verification history
```

### Fleet Coordination
```typescript
const contractFleet = await FleetManager.coordinate({
  strategy: 'contract-testing',
  agents: [
    'qe-api-contract-validator',  // Validation, breaking detection
    'qe-test-generator',          // Generate contract tests
    'qe-security-scanner'         // API security
  ],
  topology: 'sequential'
});
```

---

## Agent CLI & Advanced Patterns

For v3 agent-specific commands (`aqe contract ...`), GraphQL contracts, event contracts, and Pact Broker integration, see [references/agent-commands.md](references/agent-commands.md).

## Related Skills
- [api-testing-patterns](../api-testing-patterns/) - API testing strategies
- [shift-left-testing](../shift-left-testing/) - Early contract validation
- [cicd-pipeline-qe-orchestrator](../cicd-pipeline-qe-orchestrator/) - Pipeline integration

---

## Remember

**Consumers own the contract.** They define what they need; providers must fulfill it. Breaking changes require major version bumps and coordination. CI/CD blocks deploys that break contracts. Use Pact for consumer-driven, OpenAPI for API-first.

**With Agents:** Agents validate contracts, detect breaking changes with semver recommendations, and generate migration guides. Use agents to maintain contract compliance at scale.

## Gotchas

- Pact broker URL must be configured before running — agent will generate tests that silently skip verification without it
- Consumer tests pass locally but fail in CI when provider states aren't set up — always verify both sides
- Adding a required field to a response is a BREAKING change even though provider tests pass — consumer didn't expect it
- Agent may generate contracts from API docs instead of actual consumer usage — contracts must reflect real consumer needs
- GraphQL contract testing requires schema stitching awareness — fragments may reference types from other services

© proffesor-for-testing · MIT · proffesor-for-testing/agentic-qe

Похожие скиллы

Все скиллы по теме «Тесты и QA» →

Сначала — contract-testing от других авторов.

contract-testing kindlmann Скилл contract-testing для Claude Code помогает настроить контрактные тесты Pact между потребителем и провайдером API. Он включается по запросам о Pact, проверке провайдера или can-i-deploy. CX Codex +1 1 400установок api-contract-testing aj-geddes Скилл api-contract-testing настраивает проверку контрактов API между сервисами без запуска полных интеграционных тестов. Помогает избежать несовместимых правок в CI. CX Codex +1 934установок contract-testing-builder patricio0312rev Скилл contract-testing-builder внедряет контрактное тестирование API через Pact, OpenAPI и JSON Schema, чтобы изменения на бэкенде не ломали клиентские сервисы. CX Codex +1 266установок swagger-contract-testing pactflow Плагин swagger-contract-testing для Claude Code собирает скиллы и агентов для контрактного тестирования в PactFlow: от Pact-тестов до проверок can-i-deploy. ★ 7звёзд репо swagger-contract-testing-openapi-parser pactflow Плагин swagger-contract-testing-openapi-parser для Claude Code разбирает OpenAPI и генерирует тесты на дрейф контракта. Сопоставляет API-контракт с тестовым сценарием. ★ 7звёзд репо suede-parity-contract JasonColapietro Скилл suede-parity-contract держит одно значение на всех поверхностях продукта: контракт генерируется из эталонной поверхности, остальные проверяются против него тестом. CX Codex +1 ★ 121звёзд репо agent-browser vercel-labs Скилл agent-browser для Claude Code управляет браузером по запросам на навигацию, заполнение форм и проверку веб-приложений. Агент также может запускать через него исследовательское тестирование и автоматизировать Electron-приложения. CX Codex +1 1 600 000установок improve-codebase-architecture Matt Pocock Скилл improve-codebase-architecture для Claude Code ищет архитектурные узкие места в кодовой базе и показывает варианты углубления модулей в HTML-отчёте. Отчёт содержит материал для ревью перед рефакторингом. CX Codex +1 1 163 035установок tdd Matt Pocock Скилл управляет циклом красный-зелёный в TDD: проверяет, что тесты пишутся до кода, держит их на уровне публичных интерфейсов и не завязывает на внутреннюю структуру. CX Codex +1 1 141 062установок

Из того же набора73

Весь набор →
sherlock-review Скилл sherlock-review собирает доказательства и проверяет утверждения об изменениях кода. Помогает найти причину ошибки или подтвердить исправление. CX Codex +1 135установок wms-testing-patterns Скилл wms-testing-patterns для Claude Code содержит паттерны проверки инвентаризации, волн комплектации, EDI-документов и интеграции WMS с ERP. CX Codex +1 134установок six-thinking-hats Скилл six-thinking-hats для Claude Code разбирает тестирование через шесть позиций: факты, риски, пользу, идеи, ощущения и план действий. Структурирует стратегии, ретроспективы и разбор сбоев. CX Codex +1 131установок a11y-ally Скилл a11y-ally для Claude Code проверяет страницы на нарушения WCAG и предлагает контекстные исправления. Аудирует сайты и проверяет доступность видео. CX Codex +1 131установок qe-quality-assessment Скилл qe-quality-assessment для Claude Code оценивает качество кода по сложности, линту, запахам и здоровью тестов. Проверяет quality gates, формирует отчёты и оценивает готовность релиза. CX Codex +1 129установок qe-defect-intelligence Скилл qe-defect-intelligence анализирует код на вероятность ошибок по частоте изменений, сложности и истории багов. Помогает найти проблемные участки до того, как они попадут в продакшн. CX Codex +1 129установок risk-based-testing Скилл risk-based-testing распределяет ресурсы тестирования по уровню риска модулей по шкале от 1 до 5 и приоритизирует автотесты перед релизом. CX Codex +1 128установок n8n-trigger-testing-strategies Скилл n8n-trigger-testing-strategies для Claude Code тестирует триггеры n8n: вебхуки, cron-расписания, события и опрос. Помогает выяснить, почему воркфлоу срабатывает не тогда, когда ожидается. CX Codex +1 128установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой