# Code Analysis Expert

> 코드베이스 탐색, 정의 찾기, 함수/신호 추적, 코드 구조 분석. 특정 함수/클래스/심볼 위치 파악, 사용처 추적, call hierarchy 파악. Trigger on: 'find usage', 'trace', '어디에 있어', '코드 구조', 'call hierarchy', 'definition', '함수 찾아', '클래스 찾아'. NOTE: 파일 전체 내용/구조 파악(함수 목록 등)은 large-file-analyst를 사용할 것.

- Skill: `together2329/code-analysis-expert` (Agent Skill)
- Install (CLI): `npx skillmds@latest add together2329/code-analysis-expert`
- Raw SKILL.md: https://api.skillmd.com/api/skills/together2329/code-analysis-expert/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: together2329 (https://skillmd.com/u/together2329)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/together2329/code-analysis-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 결과가 너무 많으면 패턴을 좁힐 것