# bug-hunt-swarm

Ищет первопричину багов параллельно через субагентов и ранжирует версии. Нужен для регрессий, сбоев и нестабильного поведения без правок кода.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 713 установок · ★ 4009
- Автор: Dimillian
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/Dimillian/Skills/tree/HEAD/bug-hunt-swarm/SKILL.md
- Обновлён: 2026-03-29
- HTML: https://affpapa.org/nevibecode/skills/bug-hunt-swarm

## Что делает

Скилл собирает краткое описание проблемы: симптом, ожидаемый и фактический результат, шаги воспроизведения, область влияния и доказательства. Перед расследованием он читает `AGENTS.md` и документацию затронутой части проекта, затем ограничивает проверяемую область.

Для большой или неоднозначной проблемы запускаются четыре субагента: один уточняет воспроизведение и границы сбоя, другой прослеживает путь выполнения, третий изучает недавние изменения через `git diff`, `git log` и `git show`, четвёртый предлагает кратчайшую проверку гипотез. Можно также читать логи, трассировки и запускать существующие тесты. Все действия выполняются только на чтение.

Главный агент объединяет выводы, отбрасывает догадки без доказательств и выдаёт ранжированные гипотезы с уровнем уверенности, недостающими данными и следующим проверочным шагом. Скилл не меняет файлы, поэтому исправление потребуется делать отдельно.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Dimillian/Skills --skill bug-hunt-swarm -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Dimillian/Skills --skill bug-hunt-swarm -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Dimillian/Skills --skill bug-hunt-swarm -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Dimillian/Skills bug-hunt-swarm
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Dimillian/Skills --skill bug-hunt-swarm -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/Dimillian/Skills --path bug-hunt-swarm
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add Dimillian/Skills --skill bug-hunt-swarm -a opencode
```

### Claude.ai

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

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

## Когда брать
- найти причину регрессии по истории Git
- локализовать участок кода, где расходится поведение
- проверить условия воспроизведения нестабильного сбоя
- сопоставить логи и трассировки с гипотезами
- выбрать минимальный шаг для проверки причины

## Примеры запросов агенту
- Расследуй падение приложения: собери версии причин и предложи кратчайшую проверку.
- Найди первопричину регрессии после последних изменений Git, не редактируя файлы.
- Разбери нестабильный тест и ранжируй гипотезы по имеющимся логам.

## Похожие
- [bug-hunter](https://affpapa.org/nevibecode/skills/bug-hunter.md) — скилл · 783 установки
- [ai-team-orchestration](https://affpapa.org/nevibecode/skills/ai-team-orchestration.md) — скилл · 381 установка
- [Swarm Orchestration](https://affpapa.org/nevibecode/skills/swarm-orchestration.md) — скилл · 2100 установок
- [bug-reproduction](https://affpapa.org/nevibecode/skills/bug-reproduction.md) — скилл · 1400 установок
- [bug-reproduction-brief](https://affpapa.org/nevibecode/skills/bug-reproduction-brief.md) — скилл · 62 установки
- [swarm-planner](https://affpapa.org/nevibecode/skills/swarm-planner.md) — скилл · 1200 установок

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

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

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