triflux 9.2.1 → 9.2.3

package/skills/tfx-research/SKILL.md

@@ -14,7 +14,7 @@ argument-hint: "<검색 주제>"
 # tfx-research — Light Web Research
 
 > **Deep 버전**: tfx-deep-research. "제대로/꼼꼼히" 수정자로 자동 에스컬레이션.
-> 빠른 단일 소스 검색 + 요약. 토큰 최소화, 즉시 결과.
+> 빠른 단일 소스 검색 + 요약. **검색 자체를 Gemini에 위임**해 Claude 토큰 최소화. Gemini CLI의 네이티브 Google Search로 검색+요약을 한 번에 처리.
 
 ## 용도
 
@@ -26,9 +26,9 @@ argument-hint: "<검색 주제>"
 
 ## 워크플로우
 
-### Step 1: 쿼리 최적화
+### Step 1: 쿼리 최적화 (Claude — ~100 토큰)
 
-사용자 입력을 검색에 최적화된 쿼리로 변환한다:
+사용자 입력을 검색에 최적화된 영문 키워드로 변환한다. 이 단계만 Claude가 처리한다:
 
 ```
 입력: "React 19에서 use() 훅 사용법"
@@ -49,10 +49,58 @@ AskUserQuestion:
   5. URL 콘텐츠 추출
 ```
 
-선택 결과에 따라 Step 2의 자동 선택 로직을 건너뛰고 해당 MCP를 직접 사용한다.
-인자가 제공된 경우 이 단계를 건너뛰고 Step 2의 자동 선택 로직을 따른다.
+선택 결과에 따라 Step 2 Gemini 위임 시 프롬프트에 검색 유형 힌트를 추가한다.
+인자가 제공된 경우 이 단계를 건너뛰고 Step 2로 직행한다.
 
-### Step 2: MCP 소스 자동 선택
+### Step 2: Gemini에 검색+요약 위임 (검색 실행 전체를 Gemini가 처리)
+
+최적화된 쿼리를 Gemini CLI로 전달한다. Gemini는 네이티브 Google Search를 사용해 검색과 요약을 모두 수행한다:
+
+```
+Bash("bash scripts/tfx-route.sh gemini exec 'Research the following topic. Use Google Search to find current information. Return a structured markdown summary with sources: {optimized_query}'")
+```
+
+Gemini가 반환하는 결과에는 검색 결과, 출처 URL, 핵심 요약이 포함된다. Claude는 이 단계에서 토큰을 소비하지 않는다.
+
+**실패 시**: Gemini CLI가 응답하지 않거나 오류가 발생하면 → [Claude Fallback](#claude-fallback-gemini-실패-시) 으로 전환.
+
+### Step 3: 결과 포맷팅 (Claude — 경량, ~300 토큰)
+
+Gemini 출력을 표준 결과 템플릿으로 정리한다. 새로운 검색이나 요약 없이 포맷 변환만 수행:
+
+```markdown
+## 검색 결과: {query}
+
+### 핵심 답변
+{Gemini 요약에서 추출한 1-3문장 직접 답변}
+
+### 상세 내용
+- **[출처 1 제목](URL)**: {하이라이트 요약}
+- **[출처 2 제목](URL)**: {하이라이트 요약}
+- **[출처 3 제목](URL)**: {하이라이트 요약}
+
+### 관련 키워드
+{추가 검색에 유용한 키워드}
+```
+
+## 토큰 예산
+
+| 단계 | 담당 | 토큰 |
+|------|------|------|
+| 쿼리 최적화 | Claude | ~100 |
+| 검색 실행 + 요약 | Gemini | 0 (Claude 미소비) |
+| 결과 포맷팅 | Claude | ~300 |
+| **Claude 총합** | | **~500 (오케스트레이션만)** |
+
+> 기존 대비 Claude 토큰 ~90% 절감. 검색 품질은 Gemini의 Google Search 네이티브 연동으로 유지.
+
+---
+
+## Claude Fallback (Gemini 실패 시)
+
+Gemini CLI가 실패하거나 응답이 없을 경우 Claude + MCP 원본 워크플로우로 폴백한다.
+
+### Fallback Step 2: MCP 소스 자동 선택
 
 검색 유형에 따라 최적 MCP를 자동 선택한다:
 
@@ -73,7 +121,7 @@ elif query contains URL → Exa crawling
 else → Tavily (가장 범용적)
 ```
 
-### Step 3: 검색 실행
+### Fallback Step 3: 검색 실행
 
 선택된 MCP로 검색 실행. 결과를 토큰 효율적으로 포맷:
 
@@ -85,36 +133,6 @@ else → Tavily (가장 범용적)
   - freshness: 상황에 따라 자동 설정
 ```
 
-### Step 4: 결과 요약
-
-검색 결과를 구조화된 요약으로 변환:
-
-```markdown
-## 검색 결과: {query}
-
-### 핵심 답변
-{1-3문장 직접 답변}
-
-### 상세 내용
-- **[출처 1 제목](URL)**: {하이라이트 요약}
-- **[출처 2 제목](URL)**: {하이라이트 요약}
-- **[출처 3 제목](URL)**: {하이라이트 요약}
-
-### 관련 키워드
-{추가 검색에 유용한 키워드}
-```
-
-## 토큰 예산
-
-| 단계 | 토큰 |
-|------|------|
-| 쿼리 최적화 | ~200 |
-| 검색 실행 | ~2K (MCP 결과) |
-| 결과 요약 | ~2K |
-| **총합** | **~5K** |
-
-## Fallback 전략
-
 MCP 사용 불가 시 순서:
 1. context7 → 2. WebSearch (내장) → 3. Brave → 4. Exa → 5. Tavily