search-hierarchy — скилл для Claude Code: поиск по коду
Скилл search-hierarchy подбирает способ поиска по типу вопроса: по структуре кода, смыслу или точному имени. Помогает найти нужный файл до чтения его содержимого.
MIT ★ 3 951 обновлён 2026-01-26
npx skills add parcadei/Continuous-Claude-v3 --skill search-hierarchy -a claude-codeЧто делает search-hierarchy
search-hierarchy задаёт порядок работы с AST-grep, LEANN, Grep и Read. Для структурных запросов, например поиска функций и импортов, он направляет к AST-grep; для вопросов о том, как устроена логика, — к LEANN; для точных имён и регулярных выражений — к Grep. Read остаётся для изучения файла после поиска.
Хук grep-to-leann.sh определяет тип запроса: для структурного поиска предлагает AST-grep, для смыслового — LEANN, а буквальные совпадения пропускает к Grep. Это ограничивает прямое использование Grep для концептуальных вопросов. Установка для Claude Code выполняется через npx skills add parcadei/Continuous-Claude-v3 --skill search-hierarchy -a claude-code.
Какие задачи решает
- Найти определения функций и классов по структуре кода
- Проследить, как устроена авторизация
- Найти точное имя переменной или регулярное выражение
- Открыть найденный файл для полного разбора
Примеры запросов агенту
- Найди определения асинхронных функций в проекте.
- Разберись, как устроена авторизация, и найди нужный файл.
- Найди точные совпадения
check_evocationвopc/scripts.
Как установить search-hierarchy
1Через Skills CLI (Vercel)
npx skills add parcadei/Continuous-Claude-v3 --skill search-hierarchy -a claude-code2Вручную: положить файлы
~/.claude/skills/search-hierarchy/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/search-hierarchy/
1Через Skills CLI (Vercel)
npx skills add parcadei/Continuous-Claude-v3 --skill search-hierarchy -a codex2Вручную: положить файлы
.agents/skills/search-hierarchy/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add parcadei/Continuous-Claude-v3 --skill search-hierarchy -a cursor2Вручную: положить файлы
.cursor/skills/search-hierarchy/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install parcadei/Continuous-Claude-v3 .claude/skills/search-hierarchy2Вручную: положить файлы
.github/skills/search-hierarchy/SKILL.md1Через Skills CLI (Vercel)
npx skills add parcadei/Continuous-Claude-v3 --skill search-hierarchy -a gemini-cli2Командой платформы
gemini skills install https://github.com/parcadei/Continuous-Claude-v3 --path .claude/skills/search-hierarchyВручную: положить файлы
.devin/skills/search-hierarchy/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о search-hierarchy
Как установить search-hierarchy в Claude Code?
Выполните npx skills add parcadei/Continuous-Claude-v3 --skill search-hierarchy -a claude-code. Файл скилла находится по пути ~/.claude/skills/search-hierarchy/SKILL.md.
Что делает search-hierarchy?
Он направляет поиск по коду в подходящий инструмент: AST-grep для структурных запросов, LEANN для смысловых и Grep для точных совпадений. После поиска предлагает читать только найденный файл.
Какой хук использует search-hierarchy?
Хук grep-to-leann.sh распознаёт тип запроса и блокирует Grep для структурного и смыслового поиска, подсказывая подходящий инструмент.
Исходный текст
SKILL.md · MIT
---
name: search-hierarchy
description: Search Tool Hierarchy
user-invocable: false
---
# Search Tool Hierarchy
Use the most token-efficient search tool for each query type.
## Decision Tree
```
Query Type?
├── STRUCTURAL (code patterns)
│ → AST-grep (~50 tokens output)
│ Examples: "def foo", "class Bar", "import X", "@decorator"
│
├── SEMANTIC (conceptual questions)
│ → LEANN (~100 tokens if path-only)
│ Examples: "how does auth work", "find error handling patterns"
│
├── LITERAL (exact identifiers)
│ → Grep (variable output)
│ Examples: "TemporalMemory", "check_evocation", regex patterns
│
└── FULL CONTEXT (need complete understanding)
→ Read (1500+ tokens)
Last resort after finding the right file
```
## Token Efficiency Comparison
| Tool | Output Size | Best For |
|------|-------------|----------|
| AST-grep | ~50 tokens | Function/class definitions, imports, decorators |
| LEANN | ~100 tokens | Conceptual questions, architecture, patterns |
| Grep | ~200-2000 | Exact identifiers, regex, file paths |
| Read | ~1500+ | Full understanding after finding the file |
## Hook Enforcement
The `grep-to-leann.sh` hook automatically:
1. Detects query type (structural/semantic/literal)
2. Blocks and suggests AST-grep for structural queries
3. Blocks and suggests LEANN for semantic queries
4. Allows literal patterns through to Grep
## DO
- Start with AST-grep for code structure questions
- Use LEANN for "how does X work" questions
- Use Grep only for exact identifier matches
- Read files only after finding them via search
## DON'T
- Use Grep for conceptual questions (returns nothing)
- Read files before knowing which ones are relevant
- Use Read when AST-grep would give file:line
- Ignore hook suggestions
## Examples
```bash
# STRUCTURAL → AST-grep
ast-grep --pattern "async def $FUNC($$$):" --lang python
# SEMANTIC → LEANN
leann search opc-dev "how does authentication work" --top-k 3
# LITERAL → Grep
Grep pattern="check_evocation" path=opc/scripts
# FULL CONTEXT → Read (after finding file)
Read file_path=opc/scripts/z3_erotetic.py
```
## Optimal Flow
```
1. AST-grep: "Find async functions" → 3 file:line matches
2. Read: Top match only → Full understanding
3. Skip: 4 irrelevant files → 6000 tokens saved
```
© parcadei · MIT · parcadei/Continuous-Claude-v3