tfx-researchlisted
Install: claude install-skill genusarvicolabathos238/triflux
# tfx-research — Light Web Research
> **ARGUMENTS 처리**: 이 스킬이 `ARGUMENTS: <값>`과 함께 호출되면, 해당 값을 사용자 입력으로 취급하여
> 워크플로우의 첫 단계 입력으로 사용한다. ARGUMENTS가 비어있거나 없으면 기존 절차대로 사용자에게 입력을 요청한다.
> **Deep 버전**: tfx-deep-research. "제대로/꼼꼼히" 수정자로 자동 에스컬레이션.
> 빠른 단일 소스 검색 + 요약. **검색 자체를 Gemini에 위임**해 Claude 토큰 최소화. Gemini CLI의 네이티브 Google Search로 검색+요약을 한 번에 처리.
## 용도
- 빠른 팩트 체크
- 라이브러리/프레임워크 최신 정보 확인
- API 문서 검색
- 에러 메시지 해결책 검색
- 간단한 기술 질문 답변
## 워크플로우
### Step 1: 쿼리 최적화 (Claude — ~100 토큰)
사용자 입력을 검색에 최적화된 영문 키워드로 변환한다. 이 단계만 Claude가 처리한다:
```
입력: "React 19에서 use() 훅 사용법"
최적화: "React 19 use() hook usage API reference 2026"
```
### Step 1.5: 검색 유형 선택 (인자 없이 호출 시)
인자 없이 `/tfx-research`만 호출된 경우, AskUserQuestion으로 검색 유형을 선택받는다:
```
AskUserQuestion:
"검색 유형을 선택하세요:"
1. 코드/라이브러리 문서 (context7)
2. 학술/논문 (Exa semantic)
3. 최신 뉴스/트렌드 (Brave)
4. 일반 웹 검색 (Tavily)
5. URL 콘텐츠 추출
```
선택 결과에 따라 Step 2 Gemini 위임 시 프롬프트에 검색 유형 힌트를 추가한다.
인자가 제공된 경우 이 단계를 건너뛰고 Step 2로 직행한다.
### Step 2: Gemini에 검색+요약 위임 (검색 실행 전체를 Gemini가 처리)
최적화된 쿼리를 Gemini CLI로 전달한다. Gemini는 네이티브 Google Search를 사용해 검색과 요약을 모두 수행한다:
```
Bash("bash scripts/tfx-route.sh gemini 'Research the following topic. Use Google Search to find current information. Return a structured markdown summary with sources: {optimized_query}' auto 120")
```
Gemini가 반환하는 결과에는 검색 결과, 출처 URL, 핵심 요약이 포함된다. Claude는 이 단계에서 토큰을 소비하지 않는다.
**실패 시**: Gemini CLI가 응답하지 않거나 오류가 발생하면 → [Claude Fallback](#claude-fallback-gemini-실패-시) 으로 전환.
### Step 3: 결과 포