# writing-tests

Скилл writing-tests задаёт правила тестов в репозитории opencode-swarm: только bun:test, изоляция моков между файлами и безопасные запуски через test_runner.

- скилл · `type=skill` · Claude Code, Codex, OpenCode, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 539 у репозитория
- Автор: ZaxbyHub
- Лицензия: MIT · policy=mirror · лицензия открытая, файл — в исходнике
- Исходник: https://github.com/ZaxbyHub/opencode-swarm/tree/HEAD/.opencode/skills/writing-tests/SKILL.md
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/zaxbyhub-writing-tests

## Что делает

Скилл подгружается перед тем, как агент тронет любой тестовый файл в `opencode-swarm`. Внутри — рамки фреймворка: импорты только из `bun:test`, таблица замен для `vi.fn()`, `vi.spyOn()` и `vi.mock()`, правила раскладки файлов. Отдельно перечислены антипаттерны, из-за которых CI падает на другой платформе.

Главная боль — моки. В режиме `--smol` Bun делит кеш модулей между тестовыми файлами одного процесса, так что `mock.module()` подменяет модуль и в соседнем файле. Защита тройная: спред реального модуля при подмене (обязательно для встроенных вроде `node:fs`), ленивая привязка в коде через импорт пространства имён и `afterEach(mock.restore())`. В Bun v1.3.11 этот вызов восстанавливает не всё, но окно заражения сужает.

На Windows тесты с асинхронными дочерними процессами не должны звать `mock.restore()`: хендлы держат блокировку каталога, и очистка падает с `EBUSY`. Их оборачивают в `describe.skipIf(process.platform === 'win32')`. У `test_runner` свои границы: `scope: 'convention'` берёт один исходник, `graph` и `impact` до 50 файлов, `all` открывается только при `SWARM_ALLOW_FULL_SUITE=1`. Весь набор гоняют шеллом по одному файлу за процесс, как в CI.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add ZaxbyHub/opencode-swarm --skill writing-tests -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add ZaxbyHub/opencode-swarm --skill writing-tests -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add ZaxbyHub/opencode-swarm --skill writing-tests -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install ZaxbyHub/opencode-swarm .opencode/skills/writing-tests
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add ZaxbyHub/opencode-swarm --skill writing-tests -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/ZaxbyHub/opencode-swarm --path .opencode/skills/writing-tests
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add ZaxbyHub/opencode-swarm --skill writing-tests -a opencode
```

### Claude.ai

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

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

## Когда брать
- разложить тесты по файлам так, чтобы CI проходил и на Linux, и на Windows
- найти `mock.module()`, который протекает в соседний тестовый файл
- подменить `node:child_process` и не обнулить остальные экспорты
- выбрать scope для `test_runner`, который не отклонится с `scope_exceeded`
- прогнать весь набор по одному файлу за процесс и прочитать хвост вывода

## Примеры запросов агенту
- Пишу тест на `src/tools/test-runner.ts` — загрузи скилл `writing-tests` и проверь, что моки не утекут в соседние файлы.
- Прогони юнит-тесты из `tests/unit/agents` по одному файлу за процесс и покажи последние 30 строк вывода.
- Почему заглушка `mock.module('node:fs')` видна в другом тестовом файле? Сверься с правилами из `writing-tests`.

## Похожие
- [writing-dev-server-tests](https://affpapa.org/nevibecode/skills/writing-dev-server-tests.md) — скилл · 1 установка
- [generate-tests](https://affpapa.org/nevibecode/skills/generate-tests.md) — скилл · ★ 328 у репозитория
- [bun-test-coverage](https://affpapa.org/nevibecode/skills/bun-test-coverage.md) — скилл · 424 установки
- [writing-unit-tests](https://affpapa.org/nevibecode/skills/writing-unit-tests.md) — скилл · 25700 установок
- [writing-mstest-tests](https://affpapa.org/nevibecode/skills/writing-mstest-tests.md) — скилл · 4500 установок
- [testing-boss](https://affpapa.org/nevibecode/skills/testing-boss.md) — скилл · 274 установки

## Другие версии с тем же именем
- [writing-tests · spencerpauly](https://affpapa.org/nevibecode/skills/writing-tests.md) — 550 установок
- [writing-tests · zaxbyhub](https://affpapa.org/nevibecode/skills/writing-tests-3.md) — ★ 539 у репозитория
- [writing-tests · zaxbyhub](https://affpapa.org/nevibecode/skills/writing-tests-2.md) — ★ 539 у репозитория

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

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