ast-grep-outline — скилл для Claude Code: что делает и как установить
Строит компактную карту структуры кода и файлов через ast-grep без чтения всего исходника. Помогает экономить контекст при разборе незнакомых репозиториев.
npx skills add ast-grep/agent-skill --skill ast-grep-outline -a claude-code
npx skills add ast-grep/agent-skill --skill outline -a claude-codeЧто делает ast-grep-outline
Скилл запускает команду ast-grep outline и возвращает синтаксическое дерево файла с номерами строк. Для отдельных файлов выводятся функции, импорты и члены классов. Для директорий инструмент собирает только экспортируемые имена. Это заметно снижает расход контекста.
Детализацию вывода задаёт параметр --view: от кратких имён до развёрнутого списка методов со строками. Флаг --items переключает фокус между импортами и структурой файла, а ключ --match фильтрует верхнеуровневые сущности регулярными выражениями.
Инструмент анализирует исключительно локальный синтаксис. Он не резолвит типы, не отслеживает цепочки реэкспортов и не строит граф вызовов, поэтому внешние зависимости придётся искать другими утилитами.
Какие задачи решает
- составить карту публичного API незнакомой папки
- посмотреть методы и поля класса с номерами строк
- проверить импорты перед правкой файла
- оценить изменения структуры в изменённых git-файлах
Примеры запросов агенту
- Покажи структуру экспортов в папке src через ast-grep outline
- Посмотри методы класса UserService в файле user.ts с номерами строк
- Проверь импорты в директории components через ast-grep outline
Как установить ast-grep-outline
1Через Skills CLI (Vercel)
npx skills add ast-grep/agent-skill --skill ast-grep-outline -a claude-codenpx skills add ast-grep/agent-skill --skill outline -a claude-code2Вручную: положить файлы
~/.claude/skills/outline/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/outline/
1Через Skills CLI (Vercel)
npx skills add ast-grep/agent-skill --skill outline -a codex2Вручную: положить файлы
.agents/skills/outline/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add ast-grep/agent-skill --skill outline -a cursor2Вручную: положить файлы
.cursor/skills/outline/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install ast-grep/agent-skill outline2Вручную: положить файлы
.github/skills/outline/SKILL.md1Через Skills CLI (Vercel)
npx skills add ast-grep/agent-skill --skill outline -a gemini-cli2Командой платформы
gemini skills install https://github.com/ast-grep/agent-skill --path ast-grep/skills/outlineВручную: положить файлы
.devin/skills/outline/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add ast-grep/agent-skill --skill outline -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Из того же набора2
Похожие
Рядом в теме «Настройка агента: память, контекст, субагенты»
Все скиллы по теме «Настройка агента: память, контекст, субагенты» →Вопросы о ast-grep-outline
Как установить ast-grep-outline в Claude Code?
Выполните команду npx skills add ast-grep/agent-skill --skill ast-grep-outline -a claude-code.
Что делает ast-grep-outline?
Скилл формирует компактную схему кода с номерами строк, собирая функции, классы, импорты и экспорты. Это даёт возможность изучить структуру файла до чтения полного текста.
Умеет ли инструмент строить граф вызовов?
Нет, он разбирает только локальный синтаксис. Скилл не выводит типы, не переходит по цепочкам экспорта и не связывает вызовы между файлами.
