Install
npx skills add ast-grep/agent-skill누구에게 맞나
프로그래밍 어시스턴트에게 텍스트 일치가 아니라 코드 구조(추상 구문 트리)로 검색하게 하려면 이 스킬을 쓴다. 공식으로는 Claude Code 플러그인 마켓에 있으며 ast-grep 구조 검색을 제공한다.
전제 조건: 이 기기에 ast-grep이 이미 설치되어 있고, 어시스턴트가 스킬을 설치할 수 있어야 한다. 설명에는 ast-grep 자체를 어떻게 설치하는지는 없다. 설치 프로그램을 지어내지 말 것. 설명은 Claude Code를 지명한다. 다른 클라이언트를 공식 전용으로 쓰지 말 것. 그 명단 밖에서 쓸 수 있는지는 원문에 없다.
설치 주 경로는 npx 명령 하나뿐이다. 설치 후에는 질문에서 이 스킬 사용을 명시해야 한다. 예: “Use ast-grep to find...”. 설명은 2025년 11월 시점에도 Claude Code가 모든 적합한 장면에서 ast-grep을 자동 판단하지는 못한다고 한다. 설치 디렉터리는 적혀 있지 않다. 설치 후에는 현재 어시스턴트에서 이 스킬을 이름으로 호출할 수 있는지만 확인한다.
3분 만에 첫 시도
공식 페이지:
https://github.com/ast-grep/agent-skill
먼저 이 기기의 ast-grep가 동작하는지 확인한 뒤 권장 설치를 실행한다(스킬 파일을 이 기기에 쓰므로 저장소 이름을 먼저 대조한다):
npx skills add ast-grep/agent-skill
명령이 실패하면 멈춘다. 성공해도 업무 코드를 먼저 바꾸지 않는다. 기존 저장소를 열고 자연어로 분명히 말한다: Use ast-grep to find..., 그리고 위험이 낮은 구조 목표를 준다. 예: 어떤 함수 호출 형태를 찾기. 어시스턴트에게 먼저 ast-grep이 맞는지 분석하고, 매칭용 예시와 규칙을 쓰고, 예시에서 먼저 테스트하라고 요청한다.
성공 신호: 어시스턴트가 ast-grep을 명시적으로 썼고, 규칙이 예시에서 검증되었으며, 저장소 전체 결과에 파일 경로와 줄 번호가 있다. 규칙 파일을 쓰거나 업무 코드를 바꾸려 하면 먼저 막고, 부작용을 확인한 뒤 계속한다.
사용 사례
사례 1: 읽기 전용 구조 검색. 질문에서 ast-grep을 명시적으로 지명해야 한다. 어시스턴트가 구조로 일치 항목을 찾고 파일 경로와 줄 번호를 반환하게 한다. 처음에는 결과만 본다. 덤으로 리팩터하지 말 것. 설명에 언어 범위나 예시 저장소는 없다. 상상 속 언어 목록에서 추론하지 말 것.
사례 2: 규칙을 먼저 쓰고, 검증한 뒤, 마지막으로 저장소 전체를 검색한다. 설명의 단계는 다음과 같다. 질의가 ast-grep에 맞는지 분석하고, 매칭용 예시 코드를 만들고, 규칙을 작성하고, 예시에서 테스트하고, 통과한 뒤에야 코드베이스 전체를 검색하고, 마지막으로 경로와 줄 번호를 낸다. 예시 테스트가 통과했을 때만 전체 검색을 허용한다. 규칙 파일 경로나 CLI 플래그는 없다. 빠진 것을 채우지 말 것.
사용 경계
주 경로가 적힌 것은 다음뿐이다:
npx skills add ast-grep/agent-skill
이 기기에는 ast-grep이 이미 설치되어 있어야 한다. 트리거는 명시적으로 이름을 대야 한다. 예: “Use ast-grep to find...”. 모든 장면에서 자동 선택되기를 기대하지 말 것.
능력의 근거는 구조 검색과 「예시 → 규칙 → 테스트 → 전체 → 경로와 줄 번호」 연쇄뿐이다. Claude Code 플러그인 마켓의 스킬로 적혀 있지만, 첫 시도에서 본문에 없는 마켓 클릭 단계로 바꾸지 말 것.
ast-grep 설치 명령, 요금, 언어 범위, 설치 디렉터리는 없다. 첫 시도는 읽기 전용 조회만 한다. 리팩터 입구로 쓰지 말 것. 근거가 없는 항목은 알 수 없음으로 두고, 조작을 지어내지 말 것.