메뉴
웹 검색/리서치가 필요할 때 사용한다. '검색해줘', '찾아봐', '최신 정보', '이거 뭐야', '심층 조사', '자세히 알아봐', 'deep research', '전면 리서치', '자율 리서치', '조사해', 'research and plan' 같은 요청에 반드시 사용. 추가로 'X 있나?', 'X 쓸 수 있나?', 'X 풀려있어?', 'X 어떻게 쓰는지', 'X 가능한가?', '방법 있나?', 'X 살아있나?' 같은 도구·기능 존재/사용법/상태 의문문에도 사용.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
어떤 스킬·경로를 선택할지 묻는 메타 라우팅 요청에 사용한다. 실행하지 않고 canonical routing SSOT에서 branch와 즉시 owner 하나만 반환한다.
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.
CLI 프로젝트의 setup/postinstall 흐름에 GitHub 스타 요청을 추가한다. 'star prompt', '스타 요청', '리포 스타', 'star request', '깃헙 스타 넣어줘', 'star 눌러달라고', '응원 요청' 같은 요청에 사용한다.
코드나 아키텍처를 분석해야 할 때 사용한다. '코드 분석', 'code analysis', '아키텍처 분석', '이 코드 어떻게 돌아가?', '구조 파악', '심층 분석', '제대로 분석', '3관점 분석', '편향 없이 분석' 같은 요청에 반드시 사용.
통합 CLI 오케스트레이터이자 실행 스킬 front door. 단일/병렬 구현·수정 작업을 자동 분류해 Codex 우선으로 dispatch 하고, 명시 플래그로 mode/parallel/consensus 등 동작을 오버라이드한다. '코드 짜줘', '구현해줘', '만들어줘', '수정해줘', '고쳐줘', 'implement', 'build', 'fix' 같은 구현/수정 요청에 사용. 플래그 상세는 argument-hint, 라우팅 정책은 .claude/rules/tfx-routing.md 참조.
triflux 진단 및 수리 도구. AskUserQuestion 기반 인터랙티브 선택지로 CLI 미발견, HUD 미표시, 캐시 오류, 스킬 미설치 등을 진단하고 자동 수정합니다. Use when: not working, broken, error, 안 돼, 이상해, 에러, 캐시, reset, doctor
| internal | true |
| name | tfx-research |
| description | 웹 검색/리서치가 필요할 때 사용한다. '검색해줘', '찾아봐', '최신 정보', '이거 뭐야', '심층 조사', '자세히 알아봐', 'deep research', '전면 리서치', '자율 리서치', '조사해', 'research and plan' 같은 요청에 반드시 사용. 추가로 'X 있나?', 'X 쓸 수 있나?', 'X 풀려있어?', 'X 어떻게 쓰는지', 'X 가능한가?', '방법 있나?', 'X 살아있나?' 같은 도구·기능 존재/사용법/상태 의문문에도 사용. |
| argument-hint | <주제> [--quick | --auto] [--depth quick|standard|deep] |
ARGUMENTS 처리:
--quick→ Quick.--auto→ Auto. 그 외 → Deep (기본).
AI makes completeness near-free. 기본은 Claude(Exa/학술) + Codex(Brave/실용) 2-CLI 멀티소스 교차검증 합의 (Antigravity/Tavily는 agy --print idle 미도달 행으로 Deep 제외; Quick 단일 검색만 유지). 빠른 단일 Google Search 는
--quick. 자율 쿼리생성+구조화 보고서 는--auto.
| 플래그 | 모드 | 특징 |
|---|---|---|
| (없음) | Deep (기본) | 2-CLI 멀티소스 교차검증, consensus score |
--quick | Quick | Antigravity 단일 Google Search |
--auto | Auto | 자율 쿼리생성(3-5개) + 검색 + 구조화 보고서 |
codex exec 직접 호출 및 deprecated Gemini CLI 직접 호출 금지Bash("tfx multi ...") 만Agent(run_in_background=true)| CLI | MCP | 관점 |
|---|---|---|
| Claude | Exa (neural semantic) | 학술/기술 깊이, 공식 문서, 벤치마크 |
| Codex | Brave Search | 실용/구현/산업 사례 |
--depth 플래그)| 모드 | 서브쿼리 | 소스/쿼리 | 라운드 | 토큰 | 시간 |
|---|---|---|---|---|---|
| quick | 3 | 2 | 1 | ~20K | 2-3분 |
| standard | 5 | 3 | 1-2 | ~40K | 5-8분 (기본) |
| deep | 8-10 | 5 | 2-3 | ~80K | 10-15분 |
--depth 미지정 시 AskUserQuestion.
Agent (Claude + Exa):
Agent(
subagent_type="claude",
model="opus",
run_in_background=true,
prompt="서브쿼리를 Exa web_search_exa 로 검색. 서브쿼리: {sub_queries}. 관점: 학술/기술. category='research paper' 우선, highlights=true, numResults=5. 각 결과 제목/URL/핵심 추출."
)
Bash (Codex + Brave): (Antigravity/agy 제외 — agy --print 는 무거운 리서치에서 idle 미도달 시 5분 행; route 에서 --print-timeout 180s 로 bound)
Bash("tfx multi --teammate-mode headless --auto-attach --dashboard \
--assign 'codex:서브쿼리를 Brave Search 로 검색. 서브쿼리: {sub_queries}. 관점: 실용/산업. brave_web_search + brave_news_search, freshness=pw. 각 쿼리 상위 5개 구조화.:researcher' \
--timeout 1800", run_in_background=true)
배리어: 위 dispatch는 background — task-notification 완료(
=== HEADLESS_COMPLETE ... ===마커) 후 출력 파일에서 검색 결과를 회수하고, Agent 결과도 수집한 다음에만 Step 3을 진행한다.
교차검증 기준:
소스 가중치: 공식 1.0 / 논문 0.9 / 엔지니어링 블로그 0.7 / 일반 0.5. 날짜: 6개월 ×1.0 / 1년 ×0.8 / 2년 ×0.5.
# Deep Research Report: {topic}
**Depth**: {depth} | **Consensus**: {score}% | **Sources**: {n}개
## Executive Summary
## Key Findings (consensus 기반)
### 1. {finding} — 합의도: 3/3 또는 2/3
## Comparative Analysis
## 미합의 사항 (Disputed)
## 추천
## 소스 목록 (신뢰도 + MCP)
중요 하위 주제 발견 시 최대 3개까지 재귀 실행.
--quick)사용자 입력 → 영문 검색 키워드.
AskUserQuestion:
1. 코드/라이브러리 (context7)
2. 학술/논문 (Exa semantic)
3. 뉴스/트렌드 (Brave)
4. 일반 웹 (Tavily)
5. URL 콘텐츠 추출
Quick 모드 Step 1.5 에서 5. URL 콘텐츠 추출 을 선택했거나 Deep 모드에서 소스 URL 본문이 필요하면:
node scripts/lib/stealth-fetch.mjs <url> 를 실행한다.html 또는 text 를 URL 본문 근거로 사용한다.stealth-fetch 폴백: <이유> 1줄 경고 후 기존 폴백을 사용한다: WebFetch → Tavily extract → Exa fetch.Bash("bash ~/.claude/scripts/tfx-route.sh antigravity 'Research: use Google Search, return structured markdown with sources. Query: {optimized_query}' auto 120")
Fallback: Antigravity 실패 시 MCP 순서 — context7 → WebSearch → Brave → Exa → Tavily.
## 검색 결과: {query}
### 핵심 답변
### 상세 내용 (출처 + 요약)
### 관련 키워드
--auto)자율 쿼리생성 → 검색 → 핵심 추출 → 구조화 보고서.
인자로 받거나 대화로 요청. 모호하면 범위 좁히기 후속 질문.
규칙:
예 ("Next.js 15 변경점"):
- "Next.js 15 주요 변경점 정리"
- "Next.js 15 App Router 변경사항 2026"
- "Next.js 15 breaking changes migration"
- "Next.js 15 vs 14 comparison"
brave-search MCP 우선, 없으면 WebSearch. 쿼리당 상위 5-10개, URL 중복 제거, 실패 시 쿼리 변형 재시도.
# Research: {topic}
Date: {date}
## Executive Summary
## Key Findings (3-5개)
## Comparative Analysis (비교 대상 있을 때)
## Actionable Recommendations (실행 가능)
## Sources (URL + 한줄 요약)
.tfx/reports/research-{timestamp}.md
/tfx-research "2026 실시간 파이프라인 아키텍처 비교" # Deep
/tfx-research --depth deep "Claude vs Cursor vs Windsurf" # Deep
/tfx-research --quick "Next.js 15 Server Actions" # Quick
/tfx-research --auto "Rust vs Go 백엔드 성능 비교" # Auto (쿼리생성+보고서)