tfx-qalisted
Install: claude install-skill genusarvicolabathos238/triflux
# tfx-qa — Light Test-Fix Cycle
> **ARGUMENTS 처리**: 이 스킬이 `ARGUMENTS: <값>`과 함께 호출되면, 해당 값을 사용자 입력으로 취급하여
> 워크플로우의 첫 단계 입력으로 사용한다. ARGUMENTS가 비어있거나 없으면 기존 절차대로 사용자에게 입력을 요청한다.
> **Deep 버전**: tfx-deep-qa. "제대로/꼼꼼히" 수정자로 자동 에스컬레이션.
> 테스트 실행 → 실패 분석 → 자동 수정 → 재실행. 최대 3회. OMC ultraqa 영감.
## 용도
- 테스트 실행 후 실패 자동 수정
- CI 실패 빠른 해결
- 리팩터링 후 회귀 검증 + 수정
- "테스트 돌려서 깨진 거 고쳐" 류의 요청
## 워크플로우
### Step 1: 테스트 대상 식별
```
우선순위:
1. 사용자가 테스트 명령 지정 → 그대로 실행
2. 사용자가 파일 지정 → 해당 파일의 테스트 탐색
3. 지정 없음 → 프로젝트 테스트 전체 (npm test / pytest 등 자동 감지)
자동 감지:
package.json의 "test" 스크립트 → npm test
pytest.ini / pyproject.toml → pytest
Makefile의 test 타깃 → make test
```
### Step 2: 테스트 실행 (Round 1)
```bash
bash ~/.claude/scripts/tfx-route.sh codex \
"다음 테스트를 실행하고 결과를 보고하라:
명령: {test_command}
출력 형식:
- 총 테스트 수
- 통과/실패/스킵 수
- 실패한 테스트 목록 (파일:테스트명:에러 메시지)
- 실패 원인 분석 (각 실패별)" implement
```
### Step 3: 실패 수정 + 재실행 루프
```
MAX_RETRIES = 3
retry = 0
WHILE (failures > 0 AND retry < MAX_RETRIES):
retry++
Codex로 실패 수정:
bash ~/.claude/scripts/tfx-route.sh codex \
"다음 테스트 실패를 수정하라:
실패 목록: {failures}
규칙:
- 테스트 코드가 아닌 구현 코드를 수정하라 (테스트가 정확한 경우)
- 테스트 자체가 잘못된 경우만 테스트를 수정하라
- 수정 후 해당 테스트를 다시 실행하여 확인하라" implement
재실행하여 결과 확인
END WHILE
```
### Step 4: 결과 보고
```markdown
## QA 결과: {test_target}
### 실행 요약
| 라운드 | 통과 | 실패 | 수정 |
|--------|------|------|------|
| Round 1 | {n} | {n} | — |
| Round 2 | {n} | {n} | {수정 내용} |
| Round 3 | {n} | {n} | {수정 내용} |