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

qe-contract-testing — скилл для Claude Code

Скилл qe-contract-testing для проверки контрактов REST, GraphQL и event-driven API с валидацией схем. Ловит несовместимые изменения и гарантирует, что API не сломает клиентов.

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

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

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

qe-contract-testing автоматизирует тестирование контрактов между потребителями и провайдерами API. Поддерживает consumer-driven контракты (Pact), валидацию OpenAPI и GraphQL схем, проверку обратной совместимости и анализ breaking changes. Генерирует контракты из спецификаций, верифицирует провайдера против контрактов потребителей, выявляет удаленные endpoint'ы и изменения параметров.

В составе скилла — интеграция с Pact Broker для координации между командами, поддержка event schema validation, анализ deprecation'ов и report с impact оценкой. Для работы нужен Node.js и доступ к API endpoint'ам или их спецификациям.

Цель — предотвратить breaking changes ещё на этапе разработки и задокументировать контракты, на которые полагаются клиенты. Включает примеры для REST, GraphQL, event-driven систем и CI/CD интеграцию.

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

  • проверить, совместима ли новая версия API с существующими клиентами
  • задокументировать контракты между микросервисами
  • ловить breaking changes до релиза
  • валидировать схему GraphQL запросов и ответов
  • скоординировать тестирование контрактов в разных командах

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

  • Сгенерируй consumer контракты из openapi.yaml и положи в contracts/
  • Проверь, совместима ли API v2 с контрактами v1, выяви breaking changes
  • Валидируй GraphQL схему из schema.graphql против реальных запросов

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

1Через Skills CLI (Vercel)

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

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

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

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

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

Вопросы о qe-contract-testing

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

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

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

Тестирует контракты между клиентами и API провайдерами. Генерирует контракты из спецификаций, проверяет обратную совместимость, выявляет breaking changes и валидирует схемы REST, GraphQL и event-driven систем.

Какие форматы API поддерживает скилл?

REST (OpenAPI), GraphQL и event-driven системы. Работает с Pact контрактами, JSON схемами и YAML спецификациями.

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

SKILL.md · MIT
---
inclusion: auto
name: qe-contract-testing
description: "Consumer-driven contract testing for APIs including REST, GraphQL, and event-driven systems with schema validation."
---

# QE Contract Testing

## Purpose

Guide the use of v3's contract testing capabilities including consumer-driven contracts, schema validation, backward compatibility checking, and API versioning verification.

## Activation

- When testing API contracts
- When validating schema changes
- When checking backward compatibility
- When testing GraphQL APIs
- When verifying event schemas

## Quick Start

```bash
# Generate contract from API
aqe contract generate --api openapi.yaml --output contracts/

# Verify provider against contracts
aqe contract verify --provider http://localhost:3000 --contracts contracts/

# Check breaking changes
aqe contract breaking --old api-v1.yaml --new api-v2.yaml

# Test GraphQL schema
aqe contract graphql --schema schema.graphql --operations queries/
```

## Agent Workflow

```typescript
// Contract generation
Task("Generate API contracts", `
  Analyze the REST API and generate consumer contracts:
  - Parse OpenAPI specification
  - Identify critical endpoints
  - Generate Pact contracts
  - Include example requests/responses
  Output to contracts/ directory.
`, "qe-api-contract")

// Breaking change detection
Task("Check API compatibility", `
  Compare API v2.0 against v1.0:
  - Detect removed endpoints
  - Check parameter changes
  - Verify response schema changes
  - Identify deprecations
  Report breaking vs non-breaking changes.
`, "qe-api-compatibility")
```

## Contract Testing Types

### 1. Consumer-Driven Contracts (Pact)

```typescript
await contractTester.consumerDriven({
  consumer: 'web-app',
  provider: 'user-service',
  contracts: 'contracts/web-app-user-service.json',
  verification: {
    providerBaseUrl: 'http://localhost:3000',
    providerStates: providerStateHandlers,
    publishResults: true
  }
});
```

### 2. Schema Validation

```typescript
await contractTester.validateSchema({
  type: 'openapi',
  schema: 'api/openapi.yaml',
  requests: actualRequests,
  validation: {
    requestBody: true,
    responseBody: true,
    headers: true,
    statusCodes: true
  }
});
```

### 3. GraphQL Contract Testing

```typescript
await graphqlTester.testContracts({
  schema: 'schema.graphql',
  operations: 'queries/**/*.graphql',
  validation: {
    queryValidity: true,
    responseShapes: true,
    nullability: true,
    deprecations: true
  }
});
```

### 4. Event Contract Testing

```typescript
await contractTester.eventContracts({
  schema: 'events/schemas/',
  events: {
    'user.created': {
      schema: 'UserCreatedEvent.json',
      examples: ['examples/user-created.json']
    },
    'order.completed': {
      schema: 'OrderCompletedEvent.json',
      examples: ['examples/order-completed.json']
    }
  },
  compatibility: 'backward'
});
```

## Breaking Change Detection

```yaml
breaking_changes:
  always_breaking:
    - endpoint_removed
    - required_param_added
    - response_field_removed
    - type_changed

  potentially_breaking:
    - optional_param_removed
    - response_field_added
    - enum_value_removed

  non_breaking:
    - endpoint_added
    - optional_param_added
    - response_field_made_optional
    - documentation_changed
```

## Contract Report

```typescript
interface ContractReport {
  summary: {
    contracts: number;
    passed: number;
    failed: number;
    warnings: number;
  };
  consumers: {
    name: string;
    contracts: ContractResult[];
    compatibility: 'compatible' | 'breaking' | 'unknown';
  }[];
  breakingChanges: {
    type: string;
    location: string;
    description: string;
    impact: 'high' | 'medium' | 'low';
    migration: string;
  }[];
  deprecations: {
    item: string;
    deprecatedIn: string;
    removeIn: string;
    replacement: string;
  }[];
}
```

## CI/CD Integration

```yaml
contract_verification:
  consumer_side:
    - generate_contracts
    - publish_to_broker
    - can_i_deploy_check

  provider_side:
    - fetch_contracts_from_broker
    - verify_against_provider
    - publish_results

  pre_release:
    - check_breaking_changes
    - verify_all_consumers
    - update_compatibility_matrix
```

## Pact Broker Integration

```typescript
await contractTester.withBroker({
  brokerUrl: 'https://pact-broker.example.com',
  auth: { token: process.env.PACT_TOKEN },
  operations: {
    publish: true,
    canIDeploy: true,
    webhooks: true
  }
});
```

## Coordination

**Primary Agents**: qe-api-contract, qe-api-compatibility, qe-graphql-tester
**Coordinator**: qe-contract-coordinator
**Related Skills**: qe-test-generation, qe-security-compliance

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

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

Все скиллы по теме «Тесты и QA» →
api-contract-testing secondsky Скилл api-contract-testing помогает проверять контракты API между микросервисами через Pact и схемы OpenAPI без развёртывания полного сквозного окружения. CX Codex +1 498установок contract-testing-builder patricio0312rev Скилл contract-testing-builder внедряет контрактное тестирование API через Pact, OpenAPI и JSON Schema, чтобы изменения на бэкенде не ломали клиентские сервисы. CX Codex +1 266установок contract-testing kindlmann Скилл contract-testing для Claude Code помогает настроить контрактные тесты Pact между потребителем и провайдером API. Он включается по запросам о Pact, проверке провайдера или can-i-deploy. CX Codex +1 1 400установок 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звёзд репо testing-integration OrchestKit Скилл testing-integration помогает проверять границы API и сервисов: интеграционные тесты, контракты Pact и валидацию схем Zod. Включается при работе с тестами API или взаимодействием сервисов. CX Codex +1 131установок

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

Весь набор →
shift-left-testing Скилл shift-left-testing для Claude Code переносит проверки на ранние этапы разработки: валидирует требования, помогает писать тесты до кода и запускать их в CI. Описывает ранний контроль качества и TDD. CX Codex +1 117установок test-environment-management Скилл test-environment-management для Claude Code помогает настраивать тестовую инфраструктуру и сближать её с production. Он включается при подготовке окружений, поиске различий между средами и сокращении расходов на тесты. CX Codex +1 117установок debug-loop Скилл debug-loop для пошагового отладки багов с реальными командами, не симуляциями. Формулирует гипотезы, проверяет их на живых данных, ищет корень проблемы и только потом правит код. CX Codex +1 117установок shift-right-testing Скилл shift-right-testing направляет агента при тестировании в продакшене через фиче-флаги, канареечные релизы и хаос-тесты. Пригодится при настройке прогрессивной доставки и SLO. CX Codex +1 115установок security-visual-testing Скилл security-visual-testing проверяет вёрстку веб-страниц с контролем утечек данных, параллельным сравнением экранов и аудитом доступности WCAG. CX Codex +1 115установок enterprise-integration-testing Скилл enterprise-integration-testing для сквозного тестирования интеграций между SAP, WMS и шинами данных. Помогает проверять сценарии Order-to-Cash и выверять синхронизацию систем. CX Codex +1 113установок holistic-testing-pact Скилл holistic-testing-pact формирует стратегию тестирования по принципам PACTS и четырём квадрантам Holistic Testing. Направляет проверку качества в классических и агентных архитектурах. CX Codex +1 111установок observability-testing-patterns Скилл observability-testing-patterns для Claude Code задаёт паттерны проверки дашбордов, алертов, логов и APM-трассировки при тестировании мониторинга. CX Codex +1 109установок

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

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