# codebase-search

Скилл разбирает запросы вида «где это лежит» на один поисковый пакет и возвращает карту доказательств до правок.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 392 установки · ★ 50
- Автор: akillness
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/akillness/jeo-skills/tree/HEAD/.agent-skills/codebase-search/SKILL.md
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/skills/codebase-search

## Что делает

Скилл работает как маршрутизатор, а не как учебник по поиску. Он превращает запрос в один основной пакет: точный текст, символы и индексы, структура кода, конфиги и контент, поиск в хостинге или трассировка графа зависимостей. Дальше сужает область и читает только файлы-победители.

Внутри — пошаговый разбор: нормализация запроса, выбор пакета, сужение по каталогу или типу файлов, чтение определений и потребителей, ответ в виде карты доказательств с путями и строками. Скилл умеет выходить за свои границы: если область уже найдена и нужна диагностика, он передаёт работу `debugging` или `log-analysis`, а для плана миграции — `code-refactoring`.

Понадобится доступ к `Read`, `Grep`, `Glob` и `Bash`. Для структурного поиска нужны внешние инструменты вроде ast-grep или Semgrep, для поиска по символам — LSP или индексатор. Если репозиторий маленький и вы и так помните, где что лежит, скилл только добавит шагов.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill codebase-search -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill codebase-search -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill codebase-search -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install akillness/jeo-skills codebase-search
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill codebase-search -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/akillness/jeo-skills --path .agent-skills/codebase-search
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill codebase-search -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/akillness/jeo-skills/tree/HEAD/.agent-skills/codebase-search/SKILL.md

## Когда брать
- найти, где определена функция и кто её вызывает
- отделить authored-файлы от vendor и generated
- определить, какие файлы отвечают за конфиг и шаблоны
- оценить поверхность изменений перед правкой
- перейти от поиска к диагностике бага без потери контекста

## Примеры запросов агенту
- найди, где определён этот обработчик и кто его вызывает
- какие файлы отвечают за конфиг и шаблоны в этом репозитории
- что нужно проверить перед изменением этой схемы

## Похожие
- [file-search](https://affpapa.org/nevibecode/skills/file-search.md) — скилл · 521 установка
- [search-router](https://affpapa.org/nevibecode/skills/search-router.md) — скилл · 485 установок
- [ast-grep-outline](https://affpapa.org/nevibecode/skills/ast-grep-outline.md) — скилл · 2400 установок
- [morph-search](https://affpapa.org/nevibecode/skills/morph-search.md) — скилл · 489 установок
- [review-delta](https://affpapa.org/nevibecode/skills/review-delta.md) — скилл · 1200 установок
- [file-operations](https://affpapa.org/nevibecode/skills/file-operations.md) — скилл · 414 установок

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

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