# swift-testing-expert

Помогает писать и разбирать тесты на Swift Testing: макросы #expect и #require, теги, параметризация, миграция с XCTest.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 5300 установок · ★ 476
- Автор: AvdLee
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/AvdLee/Swift-Testing-Agent-Skill/tree/HEAD/swift-testing-expert/SKILL.md
- Обновлён: 2026-09-14
- HTML: https://affpapa.org/nevibecode/skills/swift-testing-expert

## Что делает

Скилл даёт агенту свод правил по Swift Testing. Он подсказывает, когда оставить XCTest — UI-автоматизация на `XCUIApplication`, метрики производительности на `XCTMetric`, код тестов только на Objective-C. Всё остальное переводится на Swift Testing.

Внутри — контракт поведения агента и карта ссылок: `references/expectations.md` про макросы, `references/parameterized-testing.md` про параметризацию, `references/parallelization-and-isolation.md` про параллельный запуск и `.serialized`, `references/migration-from-xctest.md` про переход с XCTest. Есть шаблон быстрой триажи: сначала выяснить версию Xcode и Swift, чем тесты написаны сейчас, падают ли они стабильно или мигают.

Импорт `Testing` разрешён только в тестовых таргетах, в приложение или библиотеку его тянуть нельзя. Миграцию скилл советует вести по шагам: сперва утверждения, потом организация сьютов, затем параметризация и трейты. Если тесты делят базу или глобальное состояние, сначала предлагается развести зависимости, а `.serialized` — только как временная мера.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add AvdLee/Swift-Testing-Agent-Skill --skill swift-testing-expert -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add AvdLee/Swift-Testing-Agent-Skill --skill swift-testing-expert -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add AvdLee/Swift-Testing-Agent-Skill --skill swift-testing-expert -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install AvdLee/Swift-Testing-Agent-Skill swift-testing-expert
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add AvdLee/Swift-Testing-Agent-Skill --skill swift-testing-expert -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/AvdLee/Swift-Testing-Agent-Skill --path swift-testing-expert
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add AvdLee/Swift-Testing-Agent-Skill --skill swift-testing-expert -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/AvdLee/Swift-Testing-Agent-Skill/tree/HEAD/swift-testing-expert/SKILL.md

## Когда брать
- перевести сьют с XCTest на Swift Testing без переписывания всего сразу
- разобраться, когда нужен `#require`, а когда хватит `#expect`
- заменить десяток однотипных тестов одним параметризованным
- найти причину мигающих тестов на общей базе
- отфильтровать тесты по тегам вместо списков имён в test plan

## Примеры запросов агенту
- Перепиши этот XCTest-сьют на Swift Testing, начни с утверждений
- Сделай из этих однотипных тестов один параметризованный `@Test(arguments:)`
- Тест мигает на общей базе — предложи, как изолировать зависимости

## Похожие
- [improve-codebase-architecture](https://affpapa.org/nevibecode/skills/improve-codebase-architecture.md) — скилл · 1163035 установок
- [design-taste-frontend](https://affpapa.org/nevibecode/skills/design-taste-frontend.md) — скилл · 678700 установок
- [tdd](https://affpapa.org/nevibecode/skills/tdd.md) — скилл · 1141062 установки
- [skill-creator](https://affpapa.org/nevibecode/skills/skill-creator.md) — скилл · 414180 установок
- [agent-browser](https://affpapa.org/nevibecode/skills/vercel-labs-agent-browser.md) — скилл · 1200000 установок
- [prototype](https://affpapa.org/nevibecode/skills/prototype.md) — скилл · 986201 установка

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

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