# break-it

Скилл предлагает найти и исправить ошибку в готовом конвейере RAG — учит понимать архитектуру быстрее, чем писать с нуля. Подходит для разработчиков, которые хотят разобраться, как работают реальные системы поиска и генерации.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 24
- Автор: TakaGoto
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/TakaGoto/rag-learning-academy/tree/HEAD/.claude/skills/break-it/SKILL.md
- Обновлён: 2026-04-03
- HTML: https://affpapa.org/nevibecode/skills/break-it

## Что делает

Break-it генерирует сломанный конвейер RAG и просит найти баг. Ошибки варьируются по сложности: на лёгком уровне результаты явно неправильные, на среднем выглядят правдоподобно, но ошибочны, на сложном баги взаимодействуют друг с другом.

Скилл охватывает типичные отказы: фрагментация текста (слишком мелкие куски, отсутствие перекрытия), несовпадение моделей эмбедингов при индексации и поиске, неправильный порядок контекста в промпте, слишком строгие фильтры по метаданным, устаревший индекс. Каждый раунд логируется, что помогает отследить прогресс.

После того как ошибка найдена, скилл объясняет, почему она вызывает наблюдаемое поведение, как часто такие баги встречаются на практике и как их избежать. Если застрял, можно запросить подсказку — от указания на общую область проблемы до прямого объяснения.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add TakaGoto/rag-learning-academy --skill break-it -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add TakaGoto/rag-learning-academy --skill break-it -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add TakaGoto/rag-learning-academy --skill break-it -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install TakaGoto/rag-learning-academy break-it
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add TakaGoto/rag-learning-academy --skill break-it -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/TakaGoto/rag-learning-academy --path .claude/skills/break-it
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add TakaGoto/rag-learning-academy --skill break-it -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/TakaGoto/rag-learning-academy/tree/HEAD/.claude/skills/break-it/SKILL.md

## Когда брать
- Понять, как ошибки в фрагментации текста теряют релевантный контекст
- Отловить несовпадение моделей эмбедингов между индексацией и поиском
- Выявить эффект потери информации в середине контекста
- Диагностировать, когда индекс устаревает и не учитывает новые документы
- Научиться читать код RAG-конвейера критически

## Примеры запросов агенту
- Дай мне задачу на отладку RAG среднего уровня сложности
- /break-it hard — хочу сложный баг с двумя взаимосвязанными ошибками
- Помоги разобраться, почему поиск возвращает нерелевантные результаты

## Похожие
- [skill-creator](https://affpapa.org/nevibecode/skills/skill-creator.md) — скилл · 414180 установок
- [writing-for-agents](https://affpapa.org/nevibecode/skills/writing-for-agents.md) — скилл · 466719 установок
- [media-use](https://affpapa.org/nevibecode/skills/media-use.md) — скилл · 1100000 установок
- [mcp-builder](https://affpapa.org/nevibecode/skills/mcp-builder.md) — скилл · 130949 установок
- [subagent-driven-development](https://affpapa.org/nevibecode/skills/subagent-driven-development.md) — скилл · 237746 установок
- [orchestration](https://affpapa.org/nevibecode/skills/orchestration.md) — скилл · 350300 установок

Из того же набора: [takagoto/rag-learning-academy](https://affpapa.org/nevibecode/by/takagoto/rag-learning-academy.md) — 16 карточек

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

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