# writing-tests

Скилл writing-tests задаёт правила для написания и изменения тестов в репозитории opencode-swarm. Помогает учитывать изоляцию моков, временные каталоги и проверку регрессионных тестов.

- скилл · `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/.agents/skills/writing-tests/SKILL.md
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/writing-tests-2

## Что делает

Перед работой с тестами скилл направляет к `AGENTS.md` и `.opencode/skills/writing-tests/SKILL.md` в заданном порядке. Если задача затрагивает архитектуру или другие перечисленные области проекта, нужно также прочитать `.agents/skills/engineering-conventions/SKILL.md`.

Правила рекомендуют использовать только `bun:test`, по возможности выбирать внедрение зависимостей или `_internals` вместо `mock.module`, а временные пути строить через `os.tmpdir()` и `path.join(...)`. Для каталога с большим количеством моков предусмотрена изоляция по файлам. Регрессионный тест проверяют удалением или обходом исправления: тест должен упасть по ожидаемой причине, а после возврата исправления — пройти. При работе в Codex ручные правки делают через `apply_patch`, а тесты запускают командами оболочки; широкие области `test_runner` не используют.

## Установка

### 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 .agents/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 .agents/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/.agents/skills/writing-tests/SKILL.md

## Когда брать
- проверить правила проекта перед изменением тестов
- выбрать подход к мокам модулей Node.js
- создать временные пути, работающие на разных платформах
- проверить, что регрессионный тест ловит исправленную ошибку

## Примеры запросов агенту
- Перед изменением тестов прочитай правила для `opencode-swarm` и проверь мои правки.
- Добавь регрессионный тест на эту ошибку и покажи, что он падает без исправления.
- Подготовь тест с временным каталогом через `os.tmpdir()` и `path.join(...)`.

## Похожие
- [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 установок
- [writing-dev-server-tests](https://affpapa.org/nevibecode/skills/writing-dev-server-tests.md) — скилл · 1 установка
- [writing-playwright-tests](https://affpapa.org/nevibecode/skills/writing-playwright-tests.md) — скилл · ★ 15831 у репозитория
- [bmad-qa-generate-e2e-tests](https://affpapa.org/nevibecode/skills/bmad-qa-generate-e2e-tests.md) — скилл · 17200 установок
- [run-tests](https://affpapa.org/nevibecode/skills/run-tests.md) — скилл · 7000 установок

## Другие версии с тем же именем
- [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/zaxbyhub-writing-tests.md) — ★ 539 у репозитория

Из того же набора: [zaxbyhub/opencode-swarm](https://affpapa.org/nevibecode/by/zaxbyhub/opencode-swarm.md) — 121 карточка

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

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