tfx-analysis — Light Code Analysis

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

Deep 버전: tfx-deep-analysis. "제대로/꼼꼼히" 수정자로 자동 에스컬레이션. Codex 단일 분석으로 빠른 인사이트. SuperClaude sc:analyze 영감.

용도

• 코드 품질 빠른 점검
• 모듈/파일 구조 분석
• 의존성 관계 파악
• 성능 병목 후보 식별
• 기술 부채 탐지
• "이 코드 어떤 상태야?" 류의 질문

워크플로우

Step 1: 분석 대상 식별

우선순위:
  1. 사용자가 파일/디렉토리 지정 → 해당 범위
  2. 사용자가 주제 지정 (예: "인증 모듈") → 관련 파일 탐색
  3. 지정 없음 → 프로젝트 전체 고수준 분석

분석 유형 자동 감지:
  파일 1개 → 코드 품질 + 로직 분석
  디렉토리 → 구조 + 의존성 + 모듈 분석
  프로젝트 전체 → 아키텍처 + 기술 부채 분석

Step 2: Codex 분석 실행

bash ~/.claude/scripts/tfx-route.sh codex \
  "시니어 소프트웨어 엔지니어로서 다음을 분석하라:
   대상: {target}
   유형: {analysis_type}

   분석 항목:
   1. 구조 — 파일/모듈 구성, 계층, 의존성 방향
   2. 복잡도 — 순환 복잡도 높은 함수, 깊은 중첩
   3. 품질 — SOLID 위반, 코드 냄새, 중복
   4. 성능 — O(n²) 패턴, 불필요한 연산, 캐싱 부재
   5. 기술 부채 — TODO/FIXME, deprecated API, 하드코딩
   6. 테스트 — 커버리지 추정, 테스트 부재 영역

   구조화된 보고서로 출력하라." analyze

Step 3: 결과 포맷

## 분석 결과: {target}

### 구조 개요
{파일/모듈 구조 요약 또는 의존성 다이어그램}

### 주요 발견
| # | 카테고리 | 심각도 | 설명 | 위치 |
|---|---------|--------|------|------|
| 1 | 복잡도 | high | {설명} | `{file}:{line}` |
| 2 | 성능 | medium | {설명} | `{file}:{line}` |

### 메트릭
- 파일 수: {n} | 총 라인: {n}
- 평균 복잡도: {n} | 최대 복잡도: {n} (`{file}:{function}`)
- TODO/FIXME: {n}개
- 테스트 커버리지 추정: {n}%

### 개선 권장사항
1. **{우선순위 1}** — {구체적 제안}
2. **{우선순위 2}** — {구체적 제안}
3. **{우선순위 3}** — {구체적 제안}

토큰 예산

사용 예

/tfx-analysis "src/auth/"
/tfx-analysis "이 프로젝트 전체 아키텍처 분석"
/tfx-analysis "src/utils/parser.ts 코드 품질"