tfx-auto-codex — Codex 리드형 tfx-auto

ARGUMENTS 처리: 이 스킬이 ARGUMENTS: <값>과 함께 호출되면, 해당 값을 사용자 입력으로 취급하여 워크플로우의 첫 단계 입력으로 사용한다. ARGUMENTS가 비어있거나 없으면 기존 절차대로 사용자에게 입력을 요청한다.

래퍼: tfx-auto의 Codex 전용 바로가기. TFX_NO_CLAUDE_NATIVE=1. 목적: 기존 tfx-auto의 오케스트레이션 패턴을 유지하면서 Claude 네이티브 역할(explore, verifier, test-engineer, qa-tester)을 Codex로 치환해 Codex/Gemini만으로 실행한다.

핵심 원칙

1. Codex 라우팅 유지
   • 구현/분석/리뷰/디버깅/검증은 Codex 우선.
2. Gemini 유지
   • designer, writer는 Gemini 경로를 그대로 사용.
3. Claude 네이티브 제거
   • 실행 시 TFX_NO_CLAUDE_NATIVE=1로 강제.
4. 고난도 설계는 xhigh
   • 설계/분해/비판 검토 성격의 작업은 codex --profile gpt54_xhigh 기준으로 운용.

사용법

/tfx-auto-codex "인증 리팩터링 + UI 개선 + 테스트 보강"
/tfx-auto-codex 3:codex "src/api, src/auth, src/payment 병렬 리뷰"
/tfx-auto-codex 2:gemini "온보딩 UI 카피 + 접근성 개선"

실행 규칙

tfx-auto 워크플로우(입력 파싱 → 트리아지 → 분해 → DAG 실행 → 수집/보고)를 그대로 사용한다.

단, 실행 명령은 아래 환경변수를 반드시 포함한다:

TFX_NO_CLAUDE_NATIVE=1 bash ~/.claude/scripts/tfx-route.sh {agent} '{prompt}' {mcp_profile}

역할 치환 (자동)

TFX_NO_CLAUDE_NATIVE=1일 때:

• explore -> Codex fast
• verifier -> Codex thorough review (기본값: 이미 Codex로 설정됨)
• test-engineer -> Codex high
• qa-tester -> Codex thorough review

참고: verifier는 tfx-auto-codex의 기본 라우팅에서 이미 Codex로 실행된다. 별도 오버라이드가 필요한 경우 TFX_VERIFIER_OVERRIDE 환경변수를 사용한다.

TFX_VERIFIER_OVERRIDE

verifier 역할의 기본 Codex 라우팅을 재정의한다.

# Claude 네이티브 verifier로 실행 (예: 도구 접근이 필요한 경우)
TFX_VERIFIER_OVERRIDE=claude-native /tfx-auto-codex "..."

# 특정 Codex 프로필로 강제 지정
TFX_VERIFIER_OVERRIDE=codex:xhigh /tfx-auto-codex "..."

값	동작
미설정 (기본)	Codex thorough review
codex:<profile>	지정 프로필로 Codex 실행
claude-native	Claude 네이티브 verifier로 폴백

트리아지 기준

• codex: 코드 구현/수정/분석/리뷰/디버깅/테스트/검증/리서치
• gemini: 문서/UI/디자인/멀티모달

Claude 타입 반환은 기본적으로 허용하지 않는다. 분류 결과에 claude가 포함되면 codex로 치환 후 분해를 진행한다. 단, Codex CLI 미설치 환경에서는 실행 안전성을 위해 claude-native fallback이 유지될 수 있다.

권장 프로필

• 설계/계획/비판적 검토: xhigh
• 일반 구현/수정: high
• 리뷰: thorough
• 빠른 탐색: fast

의존성

• ~/.claude/scripts/tfx-route.sh 최신 동기화 상태
• Codex CLI 설치
• Gemini CLI 설치 (UI/문서 경로 사용 시)

Troubleshooting

문제 발생 시 /tfx-doctor 실행. (--fix 자동 수정, --reset 캐시 초기화)