# ast-grep

Скилл ast-grep помогает искать, проверять и переписывать код через AST. Он пригодится для структурного рефакторинга и собственных правил линтинга.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 1 установка · ★ 5 у репозитория
- Автор: skempken
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/skempken/ast-grep-skill/tree/HEAD/.claude/skills/ast-grep/SKILL.md
- Обновлён: 2025-10-31
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/skempken-ast-grep

## Что делает

ast-grep ищет код по структуре AST, а не по обычному тексту. Скилл помогает разбирать шаблоны, метапеременные и конфигурацию правил для поиска, линтинга и переписывания кода. Он охватывает JavaScript, TypeScript, Python, Rust, Go, Java и другие языки.

Для разовых задач используются команды `ast-grep run`: они ищут совпадения, применяют переписывание, принимают код из stdin и выдают JSON для анализа. Команда `ast-grep scan` запускает правила проекта или отдельный YAML-файл, а `ast-grep test` проверяет правила. Шаблоны проекта, правил и тестов создаёт `ast-grep new`.

Правила собираются из `pattern`, `kind`, `regex`, отношений `inside`, `has`, `follows`, `precedes` и составных условий. Для Java нужны правила с `language: Java`, а для аннотаций используются структурные проверки через `kind` и `has`. Это важно: текстовый поиск не заменяет такие AST-условия.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add skempken/ast-grep-skill --skill ast-grep -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add skempken/ast-grep-skill --skill ast-grep -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add skempken/ast-grep-skill --skill ast-grep -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install skempken/ast-grep-skill .claude/skills/ast-grep
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add skempken/ast-grep-skill --skill ast-grep -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/skempken/ast-grep-skill --path .claude/skills/ast-grep
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add skempken/ast-grep-skill --skill ast-grep -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/skempken/ast-grep-skill/tree/HEAD/.claude/skills/ast-grep/SKILL.md

## Когда брать
- найти вызовы и конструкции по структуре AST
- переписать устаревший синтаксис по шаблону
- создать правило линтинга в YAML
- проверить правила через тесты
- получить совпадения в JSON для анализа

## Примеры запросов агенту
- Найди в JavaScript вызовы `console.log` командой `ast-grep run` и покажи совпадения.
- Перепиши конструкции `var $VAR = $VAL` в `let $VAR = $VAL` с помощью `ast-grep run`, но не применяй изменения автоматически.
- Создай правило `no-console`, проверь его через `ast-grep scan`, затем запусти тесты правила.

## Похожие
- [ast-grep-outline](https://affpapa.org/nevibecode/skills/ast-grep-outline.md) — скилл · 2800 установок
- [codegraph-ast-grep](https://affpapa.org/nevibecode/skills/codegraph-ast-grep.md) — скилл · 2800 установок
- [ast-grep-find](https://affpapa.org/nevibecode/skills/ast-grep-find.md) — скилл · 524 установки
- [react-audit-grep-patterns](https://affpapa.org/nevibecode/skills/react-audit-grep-patterns.md) — скилл · 854 установки
- [grep-for-mock-module-across-the-entire-test-file-and-confirm-eve](https://affpapa.org/nevibecode/skills/grep-for-mock-module-across-the-entire-test-file-and-confirm-eve.md) — скилл · ★ 539 у репозитория
- [Vercel Grep](https://affpapa.org/nevibecode/mcp/vercel-grep.md) — MCP-сервер · 1219 установок

## Другие версии с тем же именем
- [ast-grep · ast-grep](https://affpapa.org/nevibecode/skills/ast-grep.md) — 20100 установок
- [ast-grep · pproenca](https://affpapa.org/nevibecode/skills/pproenca-ast-grep.md) — 346 установок
- [ast-grep · ulpi-io](https://affpapa.org/nevibecode/skills/ulpi-io-ast-grep.md) — 148 установок

_Часть страницы не вошла по размеру — она есть в HTML-версии._

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