К основному содержанию
скилл CX Codex

search-hierarchy — скилл для Claude Code: поиск по коду

Скилл search-hierarchy подбирает способ поиска по типу вопроса: по структуре кода, смыслу или точному имени. Помогает найти нужный файл до чтения его содержимого.

MIT ★ 3 951 обновлён 2026-01-26

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add parcadei/Continuous-Claude-v3 --skill search-hierarchy -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/search-hierarchy/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/search-hierarchy/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
file-search Netresearch DTT GmbH Скилл file-search учит агента искать по репозиторию через rg, fd, ast-grep, semgrep, rga, tokei и scc вместо grep и find. Пригодится перед задачей, когда нужно собрать контекст. CX Codex +1 549установок ast-grep pproenca Скилл с набором правил по написанию и отладке ast-grep-запросов: поиск по AST, линтинг и переписывание кода. CX Codex +1 346установок codebase-search akillness Скилл codebase-search разбирает запросы вида «где это лежит» на один поисковый пакет и возвращает карту доказательств до правок. CX Codex +1 395установок sqry - Semantic Code Search verivus-oss MCP-сервер sqry - Semantic Code Search ищет по кодовой базе на основе AST и графов вызовов без отправки данных в сеть. Сервер помогает агенту разбирать зависимости и связи между функциями. CX Codex +1 ★ 31звёзд репо GitHub Code Search arjunkmrm MCP-сервер GitHub Code Search ищет реальные примеры кода в открытых репозиториях GitHub. Помогает найти, как разработчики используют библиотеки и решают задачи в production — прямо в Claude Code, Cursor, Copilot и других редакторах. CX Codex +1 3 818установок exa-search affaan-m Скилл exa-search для Claude Code ищет актуальные веб-данные, код, компании и профессиональные профили через Exa. Агент подключает его для поиска по запросу или фонового исследования задачи. CX Codex +1 6 300установок

Из того же набора161

Весь набор →
parallel-agent-contracts Скилл parallel-agent-contracts задаёт строгие правила для параллельных агентов в TypeScript: проверку типов через tsc и поиск дубликатов интерфейсов через grep перед созданием новых типов. CX Codex +1 ★ 3 951звёзд репо spark Субагент spark для Claude Code вносит небольшие точечные правки и быстрые исправления. Он подключается к задачам с ограниченным объёмом изменений. CX Codex ★ 3 951звёзд репо entropy Скилл entropy для задач по энтропии Шеннона, условной и дифференциальной энтропии, KL-дивергенции и принципу максимальной энтропии. CX Codex +1 ★ 3 951звёзд репо proactive-delegation Правило proactive-delegation учит Claude Code делегировать задачи субагентам без лишних вопросов. Оно бережёт главный контекст, распознавая исследования, исправления багов и параллельные шаги. CX Codex +1 ★ 3 951звёзд репо channel-capacity Скилл channel-capacity для Claude Code считает пропускную способность канала и взаимную информацию, а также применяет алгоритм Блахута-Аримото в задачах теории информации и кодирования. CX Codex +1 ★ 3 951звёзд репо rudin-real-complex-analysis Скилл rudin-real-complex-analysis помогает решать задачи и проверять доказательства по учебнику Walter Rudin «Real and Complex Analysis» с помощью дерева теорем и Python-скриптов. CX Codex +1 ★ 3 951звёзд репо agent-context-isolation Скилл agent-context-isolation для Claude Code учит передавать работу фоновых агентов через файлы. Он помогает не загружать их полные транскрипты в основной контекст. CX Codex +1 ★ 3 951звёзд репо fields Скилл fields для работы с полями в абстрактной алгебре. Помогает проверить аксиомы поля, вычислить минимальные многочлены и решить алгебраические уравнения через встроенные инструменты Bash и Read. CX Codex +1 ★ 3 951звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой