| name | fireauto-lsp-guide |
| description | "정의로 이동", "참조 찾기", "심볼 검색", "타입 확인", "호출 계층", "코드 찾기", "함수 찾기", "어디서 쓰이는지", "어디에 정의된", "구현체 찾기", "인터페이스 구현", "코드 추적", "코드 탐색" 등 코드 탐색이나 심볼 검색이 필요할 때 자동으로 LSP 도구를 우선 사용하세요.
|
LSP 우선 사용 가이드
LSP(Language Server Protocol) 도구가 활성화되어 있으면, 코드 탐색 시 Grep/Glob 대신 LSP를 먼저 사용하세요.
핵심 원칙
코드를 찾을 때 이 순서를 따르세요:
- LSP (가장 빠르고 정확) → 정의, 참조, 심볼, 호출 계층
- Glob/Grep (LSP로 안 되는 경우) → 파일 패턴 검색, 텍스트 검색
- Read (내용 확인) → LSP로 위치를 찾은 후 해당 파일 읽기
LSP 도구 활용 매핑
| 사용자가 이렇게 말하면 | LSP 연산 | 설명 |
|---|
| "이 함수 어디에 정의돼있어?" | goToDefinition | 심볼이 선언된 위치로 이동 |
| "이거 어디서 쓰이고 있어?" | findReferences | 모든 참조 위치를 찾음 |
| "이 타입이 뭐야?" | hover | 타입 정보, 문서 표시 |
| "이 파일에 뭐가 있어?" | documentSymbol | 파일 내 모든 함수/클래스/변수 목록 |
| "프로젝트에서 OO 찾아줘" | workspaceSymbol | 워크스페이스 전체 심볼 검색 |
| "이 인터페이스 구현체 찾아줘" | goToImplementation | 인터페이스/추상 메서드의 구현체 |
| "이 함수를 누가 호출해?" | incomingCalls | 이 함수를 호출하는 모든 곳 |
| "이 함수가 뭘 호출해?" | outgoingCalls | 이 함수가 호출하는 모든 것 |
실전 패턴
버그 수정 요청
사용자: "결제 로직에 버그가 있어"
1. workspaceSymbol → "payment", "checkout" 등으로 관련 심볼 검색
2. goToDefinition → 핵심 함수 위치 확인
3. incomingCalls → 어디서 호출되는지 추적
4. findReferences → 관련 타입/변수가 어디서 쓰이는지 파악
5. Read → 찾은 파일의 실제 코드 확인 후 수정
리팩토링 요청
사용자: "PaymentProvider 인터페이스 수정해줘"
1. goToDefinition → 인터페이스 정의 위치
2. goToImplementation → 모든 구현체 (Lemon, Paddle, Toss)
3. findReferences → 인터페이스를 사용하는 모든 곳
4. 영향 범위 파악 후 안전하게 수정
코드 이해 요청
사용자: "이 프로젝트 구조 설명해줘"
1. documentSymbol → 주요 파일들의 심볼 목록
2. workspaceSymbol → 핵심 타입/함수 전체 조회
3. incomingCalls/outgoingCalls → 호출 흐름 파악
주의사항
- LSP는 코드 구조 탐색에 최적화돼 있어요. 문자열 검색(에러 메시지, 설정값 등)은 여전히 Grep이 나아요.
- LSP 서버가 없는 언어 파일은 자동으로 Grep/Glob으로 폴백하세요.
line과 character는 1-based (1부터 시작)예요.
