# api-contract-review

Скилл api-contract-review для Claude Code проверяет REST API-контракты на ошибки HTTP-семантики, версионирования и совместимости. Запускается по просьбе проверить API или перед выпуском изменений.

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

## Что делает

api-contract-review разбирает REST-эндпоинты и проверяет, подходят ли им HTTP-методы и коды ответа. Он ищет несогласованные форматы ответов, нарушения обратной совместимости и утечки внутренних сущностей вместо DTO. Скилл также проверяет пагинацию коллекций и структуру ошибок.

Проверка охватывает версионирование API и единообразие имён маршрутов. Для публичных API скилл рекомендует версию в пути, например `/v1/users`. Его можно подключить при ревью PR с изменениями контроллеров.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add decebals/claude-code-java --skill api-contract-review -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add decebals/claude-code-java --skill api-contract-review -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add decebals/claude-code-java --skill api-contract-review -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install decebals/claude-code-java skills/api-contract-review
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add decebals/claude-code-java --skill api-contract-review -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/decebals/claude-code-java --path skills/api-contract-review
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add decebals/claude-code-java --skill api-contract-review -a opencode
```

### Claude.ai

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

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

## Когда брать
- найти неверный HTTP-метод для операции
- проверить обратную совместимость изменений API
- обнаружить непоследовательные коды и форматы ответов
- выявить выдачу сущностей вместо DTO

## Примеры запросов агенту
- Проверь REST API и найди ошибки в HTTP-методах и кодах ответа.
- Проведи ревью контроллеров в этом PR перед выпуском изменений.
- Проверь версионирование и обратную совместимость эндпоинтов.

## Похожие
- [rest-api-design-patterns](https://affpapa.org/nevibecode/skills/rest-api-design-patterns.md) — скилл · 527 установок
- [public-api-design-review](https://affpapa.org/nevibecode/skills/public-api-design-review.md) — скилл · 10200 установок
- [api-contract-normalizer](https://affpapa.org/nevibecode/skills/api-contract-normalizer.md) — скилл · 260 установок
- [API Design taste](https://affpapa.org/nevibecode/prompts/api-design-taste.md) — промпт · ★ 178201 у репозитория
- [api-versioning-strategy](https://affpapa.org/nevibecode/skills/api-versioning-strategy.md) — скилл · 417 установок
- [rest-api-design](https://affpapa.org/nevibecode/skills/secondsky-rest-api-design.md) — скилл · 607 установок

Из того же набора: [decebals/claude-code-java](https://affpapa.org/nevibecode/by/decebals/claude-code-java.md) — 18 карточек

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

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