Kayunangka/claude-skill

claude-skill은(는) 무엇을 하나요?

🔍 ast-grep을 사용한 코드 검색 강화: 코드 구조에서 패턴을 찾아 오류 처리 및 분석을 개선합니다.

개요

이 스킬은 ast-grep을 Claude Code에 통합하여, 코드의 추상 구문 트리(AST)를 기반으로 한 고급 패턴 검색 기능을 제공합니다. 텍스트 기반 검색의 한계를 넘어 코드 구조를 이해하는 검색이 가능합니다.

주요 기능

• 구조적 검색: 변수명이나 주석이 아닌 코드의 실제 구조를 기반으로 패턴 검색
• 패턴 매칭: 특정 오류 처리 패턴, 비표준 코드 스타일, 보안 취약점 식별
• YAML 기반 규칙: 사용자 정의 검색 규칙을 YAML 파일로 정의하여 재사용 가능
• 다양한 언어 지원: JavaScript, TypeScript, Python, Rust, Go 등 주요 언어 지원

설치

# ast-grep 설치 (예: npm을 통해)
npm install -g @ast-grep/cli

# 또는 cargo를 통해
cargo install ast-grep

사용법

기본 검색

# 특정 패턴 검색
sg --pattern 'try { $BODY } catch { $ERR }' --lang javascript

규칙 파일 사용

.sgconfig.yaml 파일을 프로젝트 루트에 생성하고 규칙 정의:

rules:
  - id: no-console-log
    severity: warning
    message: 콘솔 로그 사용 금지
    pattern: console.log($ARG)

예제

다음과 같은 오류 처리 패턴을 검색할 수 있습니다:

// 검색 대상: 모든 try-catch 블록
sg --pattern 'try { $BODY } catch ($$$ERR) { console.error($$$MSG) }' --lang javascript

참고

• ast-grep 공식 문서
• 패턴 문법 가이드