| name | code-analysis-expert |
| description | 코드베이스 탐색, 정의 찾기, 함수/신호 추적, 코드 구조 분석. 특정 함수/클래스/심볼 위치 파악, 사용처 추적, call hierarchy 파악. Trigger on: 'find usage', 'trace', '어디에 있어', '코드 구조', 'call hierarchy', 'definition', '함수 찾아', '클래스 찾아'. NOTE: 파일 전체 내용/구조 파악(함수 목록 등)은 large-file-analyst를 사용할 것.
|
| priority | 90 |
| activation | {"keywords":["find usage","trace signal","어디에 있어","코드 구조","call hierarchy","definition","함수 찾아","클래스 찾아"],"auto_detect":true} |
| requires_tools | ["find_files","grep_file","read_file","read_lines"] |
| related_skills | ["verilog-expert"] |
SKILL: Code Analysis Expert — MANDATORY PROTOCOL
Step 1: 위치 파악
경로를 모르면 반드시 find_files부터.
Action: find_files(pattern="*.py", directory="src")
Step 2: 심볼 검색
Action: grep_file(pattern="def target_function", path="src/", recursive=True)
Step 3: 코드 확인
1000줄 이상 파일: grep_file로 줄 번호 파악 후 해당 범위만 read_lines 사용.
절대 read_file 단독으로 대용량 파일 읽지 말 것.
Action: read_lines(path="src/main.py", start_line=<N-20>, end_line=<N+50>)
Step 4: 답변
항상 파일경로:줄번호 형식으로 인용.
Gotchas
#include/import 발견 시 해당 파일도 확인
- 파일 전체 구조/함수 목록이 필요하면 large-file-analyst skill을 사용할 것
- grep 결과가 너무 많으면 패턴을 좁힐 것