tfx-findlisted
Install: claude install-skill tellang/triflux
# tfx-find — Fast Codebase Explorer
> **ARGUMENTS 처리**: 이 스킬이 `ARGUMENTS: <값>`과 함께 호출되면, 해당 값을 사용자 입력으로 취급하여
> 워크플로우의 첫 단계 입력으로 사용한다. ARGUMENTS가 비어있거나 없으면 기존 절차대로 사용자에게 입력을 요청한다.
> OMC explore agent 오마주. Haiku의 속도 + Glob/Grep/Read의 정밀도.
> "찾는 건 빠르게, 읽는 건 정확하게."
## 용도
- 파일 위치를 모를 때 빠르게 찾기
- 특정 함수/클래스/변수가 어디서 사용되는지 추적
- 문자열 패턴으로 코드 검색
- 프로젝트 구조 빠르게 파악
- 설정 파일, 진입점, 테스트 파일 탐색
## 워크플로우
### Step 1: 검색 의도 파싱
사용자 입력에서 검색 유형을 판별한다:
```
검색 유형:
file_pattern — "*.test.ts 파일 찾아" → Glob
symbol — "createBridge 함수 어디?" → Grep (정규식)
string — "TODO 주석 찾아" → Grep (리터럴)
structure — "프로젝트 구조 보여줘" → Glob + tree
usage — "Router 클래스 사용처" → Grep (import/require + 참조)
definition — "handleAuth 정의 찾아" → Grep (function/class/const 패턴)
```
### Step 2: 검색 실행
검색 유형에 따라 최적 도구 조합을 선택한다:
```
file_pattern:
Glob("**/{pattern}") → 매칭 파일 목록
symbol:
Grep(pattern="{symbol}", type="{lang}") → 파일 목록
→ 상위 5개 파일 Read (정의부 중심, 각 ±10줄)
string:
Grep(pattern="{string}", output_mode="content", context=2) → 매칭 라인 + 컨텍스트
structure:
Glob("**/*.{ts,js,mjs,py,go}") → 파일 트리 구성
→ 디렉토리별 파일 수 + 역할 요약
usage:
Grep(pattern="import.*{symbol}|require.*{symbol}", output_mode="content") → import 위치
Grep(pattern="{symbol}", output_mode="content") → 실제 사용 위치
→ 중복 제거 후 사용처 목록
definition:
Grep(pattern="(function|class|const|let|var|export)\\s+{symbol}", output_mode="content")
→ 정의 위치 + 파일 경로
```
### Step 3: 결과 정리
검색 결과를 구조화하여 보고한다:
```markdown
## 검색 결과: {query}