ast-grep — скилл для Claude Code: структурный поиск кода
Скилл помогает составлять правила ast-grep для поиска по структуре кода. Пригодится, когда текстового поиска недостаточно, чтобы найти нужные вызовы или конструкции.
npx skills add ast-grep/agent-skill --skill ast-grep -a claude-codeЧто делает ast-grep
Скилл переводит запрос на естественном языке в правило ast-grep: сначала уточняет язык и нужные совпадения, затем предлагает проверить правило на примере кода. Для сложных условий используются YAML-правила с pattern, kind, has, inside, all, any или not.
Правило можно проверить через ast-grep scan, а затем запустить поиск по проекту командой ast-grep run или ast-grep scan. Для разбора структуры доступны --debug-query и вывод --json. Нужен установленный ast-grep CLI. Без него проверить правило командами из руководства не получится.
Какие задачи решает
- найти асинхронные функции без обработки ошибок
- отыскать вызовы функции с заданными аргументами
- найти языковые конструкции по структуре AST
- проверить правило поиска на небольшом фрагменте кода
Примеры запросов агенту
- Найди в проекте асинхронные функции, где нет обработки ошибок, и составь правило ast-grep.
- Покажи вызовы `fetchData` с конкретными аргументами в JavaScript-файлах.
- Проверь правило ast-grep на этом фрагменте и объясни, почему оно не находит совпадения.
Как установить ast-grep
1Через Skills CLI (Vercel)
npx skills add ast-grep/agent-skill --skill ast-grep -a claude-code2Вручную: положить файлы
~/.claude/skills/ast-grep/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/ast-grep/
1Через Skills CLI (Vercel)
npx skills add ast-grep/agent-skill --skill ast-grep -a codex2Вручную: положить файлы
.agents/skills/ast-grep/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add ast-grep/agent-skill --skill ast-grep -a cursor2Вручную: положить файлы
.cursor/skills/ast-grep/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install ast-grep/agent-skill ast-grep2Вручную: положить файлы
.github/skills/ast-grep/SKILL.md1Через Skills CLI (Vercel)
npx skills add ast-grep/agent-skill --skill ast-grep -a gemini-cli2Командой платформы
gemini skills install https://github.com/ast-grep/agent-skill --path ast-grep/skills/ast-grepВручную: положить файлы
.devin/skills/ast-grep/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add ast-grep/agent-skill --skill ast-grep -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
Похожие
Вопросы о ast-grep
Как установить ast-grep в Claude Code?
Выполните npx skills add ast-grep/agent-skill --skill ast-grep -a claude-code. Команда устанавливает скилл для Claude Code.
Что делает скилл ast-grep?
Он помогает формулировать и проверять правила структурного поиска по коду, а затем применять их к проекту через ast-grep CLI.
Что нужно для проверки правил ast-grep?
В руководстве для проверки используется ast-grep CLI. Правило можно запускать на фрагменте кода через scan --stdin или на файлах и проекте.
