Show GN: query-inspector - 소스 코드 내 SQL/ORM 쿼리를 추출해 튜닝 리포트를 작성하는 Claude Code 스킬

query-inspector는 프로젝트의 소스 코드에 있는 SQL과 ORM(JPA 파생 메서드, @Query, QueryDSL, Kotlin JDSL, MyBatis 등)이 생성하는 쿼리를 추출해, 인덱스 누락 / N+1 문제 / 안티패턴 등을 진단하여 결과와 튜닝 가이드를 리포팅해 주는 Claude Code 플러그인입니다.

git 변경분에서만 추출하여 incremental하게, 또는 전체를 대상으로 튜닝을 진행할 수 있으며, 튜닝은 하지 않고 추출된 쿼리 전문과 추가 정보만 리포트로 출력할 수도 있습니다.

주로 커밋 직전에 호출하여 변경분에 대한 튜닝만 진행하는 것이 좋습니다.

특징은 다음과 같습니다.

• 런타임 로깅(p6spy 등)이나 APM과 달리 실행 전 정적 분석으로 점검합니다. 실행 없이 ORM이 생성할 SQL을 추론하는 방식입니다.
• DB 접속 없이도 대부분 검출하고, 원하면 개발 DB에 붙어 실제 EXPLAIN까지 확인합니다(DB 접속 시 운영 환경 차단, 읽기 전용 쿼리만 사용, 접속 정보 미노출 등 여러 안전 장치를 마련해 두었습니다).
• 이 플러그인에는 튜닝 리포트를 생성하는 tuning-report 스킬과, 전체 쿼리의 목록 리포트를 생성하는 inventory-report 스킬이 있습니다.
• 현재(v1.0.0) Kotlin/Java 중심으로 충분히 검증했고, Python(Django/SQLAlchemy)은 지원하기는 하나 충분한 검증을 못했습니다.

소개 글: https://velog.io/@jogakdal/query-inspector