ast-grep
Guide for writing ast-grep rules to perform structural code search and analysis. Use when users need to search codebases using Abstract Syntax Tree (AST) patterns, find specific code structures, or perform complex code queries that go beyond simple text search. This skill should
Installation
Pick a client and clone the repository into its skills directory.
Installation
About this skill
Guide for writing ast-grep rules to perform structural code search and analysis. Use when users need to search codebases using Abstract Syntax Tree (AST) patterns, find specific code structures, or perform complex code queries that go beyond simple text search. This skill should be used when users ask to search for code patterns, find specific language constructs, or locate code with particular structural characteristics.
How to use
- Wyjaśnij, co chcesz znaleźć — opisz wzorzec kodu, który szukasz. Na przykład: "Znajdź wszystkie funkcje asynchroniczne, które nie mają obsługi błędów" lub "Znajdź wszystkie wywołania funkcji z określonym parametrem". Jeśli nie jesteś pewny, zadaj pytania wyjaśniające: jaki język programowania, jakie warianty kodu powinny być uwzględnione, co chcesz wyłączyć.
- Przygotuj przykładowy kod — utwórz prosty fragment kodu, który reprezentuje to, co chcesz dopasować. Zapisz go w pliku testowym, aby móc sprawdzić, czy reguła ast-grep działa prawidłowo.
- Zdefiniuj regułę ast-grep — na podstawie Twojego opisu i przykładu, umiejętność pomoże Ci napisać regułę, która będzie szukać kodu na podstawie jego struktury, a nie tylko tekstu.
- Przetestuj regułę — uruchom ast-grep z Twoją regułą na przykładowym kodzie i sprawdź, czy znalazł dokładnie to, czego szukasz.
- Dostosuj regułę — jeśli wyniki nie są zadowalające, wyjaśnij, co się nie zgadza, a umiejętność pomoże Ci ulepszyć regułę, aby lepiej dopasowała się do Twoich potrzeb.