tfx-find

Stars7

Forks2

UpdatedJuly 20, 2026 at 00:59

코드베이스에서 파일, 함수, 클래스, 문자열을 빠르게 찾을 때 사용한다. '코드 검색', 'find in code', '어디에 있어?', '이 함수 어디서 쓰여?', '파일 찾아줘', '코드베이스 탐색' 같은 요청에 반드시 사용. 파일 위치, 심볼 사용처, 패턴 검색이 필요한 모든 상황에 적극 활용.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Source

tellang

tellang/triflux

View GitHub Repository View Creator Repositories

Download

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

File Explorer

2 files

SKILL.md

readonly

internal	true
name	tfx-find
description	코드베이스에서 파일, 함수, 클래스, 문자열을 빠르게 찾을 때 사용한다. '코드 검색', 'find in code', '어디에 있어?', '이 함수 어디서 쓰여?', '파일 찾아줘', '코드베이스 탐색' 같은 요청에 반드시 사용. 파일 위치, 심볼 사용처, 패턴 검색이 필요한 모든 상황에 적극 활용.
argument-hint	<검색 패턴 또는 질문>

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: 결과 정리

검색 결과를 구조화하여 보고한다:

## 검색 결과: {query}

### 매칭 파일 ({count}개)
| # | 파일 | 라인 | 컨텍스트 |
|---|------|------|---------|
| 1 | src/hub/bridge.mjs | 42 | export function createBridge(...) |
| 2 | src/hub/router.mjs | 15 | import { createBridge } from './bridge' |

### 코드 스니펫
{핵심 코드 (필요 시)}

### 관련 파일
- src/hub/bridge.test.mjs (테스트)
- src/hub/index.mjs (re-export)

검색 최적화 규칙

Glob 먼저, Grep 나중: 파일 위치를 알면 Glob, 내용 검색은 Grep.
type 필터 사용: type: "js" 등으로 불필요 파일 제외.
head_limit 사용: 결과가 많을 때 상위 N개만 반환.
병렬 검색: 독립적인 검색은 동시에 실행.
점진적 확장: 좁은 범위 → 넓은 범위. src/ → **/*.

동작 규칙

결과가 0개이면 패턴을 완화하여 재검색한다 (대소문자 무시, 부분 매칭).
결과가 50개 초과이면 가장 관련성 높은 10개만 보여주고 필터 제안.
파일 내용은 필요한 부분만 Read한다 (전체 파일 읽기 금지).
검색 패턴에 정규식 특수문자가 있으면 자동 이스케이프.

토큰 예산

단계	토큰
의도 파싱	~200
검색 실행	~1.5K
결과 정리	~1K
총합	~3K

사용 예

/tfx-find "createBridge 함수 정의와 사용처"
/코드 검색 "*.test.mjs 파일 목록"
/find in code "TODO|FIXME|HACK 주석"
/코드에서 찾기 "환경변수 사용하는 파일"

More from this repository

same repository

tfx-harness

tellang/triflux

어떤 스킬·경로를 선택할지 묻는 메타 라우팅 요청에 사용한다. 실행하지 않고 canonical routing SSOT에서 branch와 즉시 owner 하나만 반환한다.

2026-07-277

tfx-live

tellang/triflux

Use when Claude, Codex, or a Triflux worker needs live Claude↔Codex orchestration: start/ask/stop, multi-turn, peer relay, daemon UDS attach, or UDS-first with tmux fallback.

2026-07-237

star-prompt

tellang/triflux

CLI 프로젝트의 setup/postinstall 흐름에 GitHub 스타 요청을 추가한다. 'star prompt', '스타 요청', '리포 스타', 'star request', '깃헙 스타 넣어줘', 'star 눌러달라고', '응원 요청' 같은 요청에 사용한다.

2026-07-207

tfx-analysis

tellang/triflux

코드나 아키텍처를 분석해야 할 때 사용한다. '코드 분석', 'code analysis', '아키텍처 분석', '이 코드 어떻게 돌아가?', '구조 파악', '심층 분석', '제대로 분석', '3관점 분석', '편향 없이 분석' 같은 요청에 반드시 사용.

2026-07-207

tfx-auto

tellang/triflux

통합 CLI 오케스트레이터이자 실행 스킬 front door. 단일/병렬 구현·수정 작업을 자동 분류해 Codex 우선으로 dispatch 하고, 명시 플래그로 mode/parallel/consensus 등 동작을 오버라이드한다. '코드 짜줘', '구현해줘', '만들어줘', '수정해줘', '고쳐줘', 'implement', 'build', 'fix' 같은 구현/수정 요청에 사용. 플래그 상세는 argument-hint, 라우팅 정책은 .claude/rules/tfx-routing.md 참조.

2026-07-207

tfx-doctor

tellang/triflux

triflux 진단 및 수리 도구. AskUserQuestion 기반 인터랙티브 선택지로 CLI 미발견, HUD 미표시, 캐시 오류, 스킬 미설치 등을 진단하고 자동 수정합니다. Use when: not working, broken, error, 안 돼, 이상해, 에러, 캐시, reset, doctor

2026-07-207

internal	true
name	tfx-find
description	코드베이스에서 파일, 함수, 클래스, 문자열을 빠르게 찾을 때 사용한다. '코드 검색', 'find in code', '어디에 있어?', '이 함수 어디서 쓰여?', '파일 찾아줘', '코드베이스 탐색' 같은 요청에 반드시 사용. 파일 위치, 심볼 사용처, 패턴 검색이 필요한 모든 상황에 적극 활용.
argument-hint	<검색 패턴 또는 질문>

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: 결과 정리

검색 결과를 구조화하여 보고한다:

## 검색 결과: {query}

### 매칭 파일 ({count}개)
| # | 파일 | 라인 | 컨텍스트 |
|---|------|------|---------|
| 1 | src/hub/bridge.mjs | 42 | export function createBridge(...) |
| 2 | src/hub/router.mjs | 15 | import { createBridge } from './bridge' |

### 코드 스니펫
{핵심 코드 (필요 시)}

### 관련 파일
- src/hub/bridge.test.mjs (테스트)
- src/hub/index.mjs (re-export)

검색 최적화 규칙

Glob 먼저, Grep 나중: 파일 위치를 알면 Glob, 내용 검색은 Grep.
type 필터 사용: type: "js" 등으로 불필요 파일 제외.
head_limit 사용: 결과가 많을 때 상위 N개만 반환.
병렬 검색: 독립적인 검색은 동시에 실행.
점진적 확장: 좁은 범위 → 넓은 범위. src/ → **/*.

동작 규칙

결과가 0개이면 패턴을 완화하여 재검색한다 (대소문자 무시, 부분 매칭).
결과가 50개 초과이면 가장 관련성 높은 10개만 보여주고 필터 제안.
파일 내용은 필요한 부분만 Read한다 (전체 파일 읽기 금지).
검색 패턴에 정규식 특수문자가 있으면 자동 이스케이프.

토큰 예산

단계	토큰
의도 파싱	~200
검색 실행	~1.5K
결과 정리	~1K
총합	~3K

사용 예

/tfx-find "createBridge 함수 정의와 사용처"
/코드 검색 "*.test.mjs 파일 목록"
/find in code "TODO|FIXME|HACK 주석"
/코드에서 찾기 "환경변수 사용하는 파일"