qe-contract-testing — скилл для Claude Code
Скилл qe-contract-testing для проверки контрактов REST, GraphQL и event-driven API с валидацией схем. Ловит несовместимые изменения и гарантирует, что API не сломает клиентов.
MIT 115 установок ★ 533 обновлён 2026-10-25
npx skills add proffesor-for-testing/agentic-qe --skill qe-contract-testing -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/qe-contract-testing/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/qe-contract-testing/
1Через Skills CLI (Vercel)
npx skills add proffesor-for-testing/agentic-qe --skill qe-contract-testing -a codex2Вручную: положить файлы
.agents/skills/qe-contract-testing/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add proffesor-for-testing/agentic-qe --skill qe-contract-testing -a cursor2Вручную: положить файлы
.cursor/skills/qe-contract-testing/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install proffesor-for-testing/agentic-qe .kiro/skills/qe-contract-testing2Вручную: положить файлы
.github/skills/qe-contract-testing/SKILL.md1Через Skills CLI (Vercel)
npx skills add proffesor-for-testing/agentic-qe --skill qe-contract-testing -a gemini-cli2Командой платформы
gemini skills install https://github.com/proffesor-for-testing/agentic-qe --path .kiro/skills/qe-contract-testingВручную: положить файлы
.devin/skills/qe-contract-testing/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add proffesor-for-testing/agentic-qe --skill qe-contract-testing -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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