# integration-testing

Скилл для написания и отладки тестов elastic-package: фикстуры пайплайнов, системные тесты с мок-API и script-тесты. Пригодится при работе над интеграциями Elastic.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 514 установок · ★ 16
- Автор: elastic
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/elastic/integration-skills/tree/HEAD/skills/integration-testing/SKILL.md
- Обновлён: 2026-10-16
- HTML: https://affpapa.org/nevibecode/skills/elastic-integration-testing

## Что делает

Скилл включается, когда вы пишете или чините тесты elastic-package. Три направления: фикстуры пайплайнов (входные `.log`/`.json`, ожидаемый вывод `*-expected.json`, конфиги), системные тесты в `_dev/test/system/` и `_dev/deploy/` с мок-API, а также script-тесты на пути ошибок, обработку ошибок API и обновление пакетов.

Устроено так: основной файл `SKILL.md` только направляет, а вся конкретика лежит в `references/`. Для пайплайнов — `references/pipeline-testing.md`, для системных тестов — `references/system-testing.md` плюс отдельный файл под тип входа (`cel`, `tcp`/`udp`, `http_endpoint`, `logfile`/`filestream`, `kafka`/`gcp-pubsub`, облачные хранилища). Для script-тестов — `references/script-testing.md`. Если интеграция поддерживает несколько типов входа, грузится общий файл и каждый подходящий.

Есть два файла-инструкции для субагентов: `references/builder-setup-subagent-guidance.md` и `references/builder-system-test-subagent-guidance.md`. Оркестратор передаёт субагенту путь к файлу в промпте, а тот читает его сам — вставлять содержимое в промпт не нужно. Скилл не заменяет профильные: проектирование процессоров ingest-пайплайнов, разработку CEL-программ и выбор команд elastic-package он не покрывает.

## Установка

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

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install elastic/integration-skills integration-testing
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

### Claude.ai

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

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

## Когда брать
- собрать фикстуры пайплайна и сверить вывод с `*-expected.json`
- поднять мок-API для системного теста
- разобраться, почему системный тест даёт 0 hits
- написать script-тест на путь ошибки или обновление пакета
- выбрать нужный reference-файл под тип входа data stream

## Примеры запросов агенту
- Помоги написать фикстуры для pipeline-теста этого data stream и проверь ожидаемый вывод
- Системный тест падает с 0 hits — разберись, что не так с мок-API
- Нужен script-тест на ошибку API и на обновление пакета, подскажи формат txtar

## Похожие
- [planning-oracle-to-postgres-migration-integration-testing](https://affpapa.org/nevibecode/skills/planning-oracle-to-postgres-migration-integration-testing.md) — скилл · 1800 установок
- [aspire-integration-testing](https://affpapa.org/nevibecode/skills/aspire-integration-testing.md) — скилл · 499 установок
- [132-java-testing-integration-testing](https://affpapa.org/nevibecode/skills/132-java-testing-integration-testing.md) — скилл · 376 установок
- [322-frameworks-spring-boot-testing-integration-tests](https://affpapa.org/nevibecode/skills/322-frameworks-spring-boot-testing-integration-tests.md) — скилл · 357 установок
- [mailpit-integration](https://affpapa.org/nevibecode/skills/mailpit-integration.md) — скилл · 421 установка
- [testing](https://affpapa.org/nevibecode/skills/codewithmukesh-testing.md) — скилл · 2800 установок

## Другие версии с тем же именем
- [integration-testing · aj-geddes](https://affpapa.org/nevibecode/skills/integration-testing.md) — 551 установка

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

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

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