triflux 8.2.3 → 8.3.1

package/skills/tfx-prune/SKILL.md

@@ -0,0 +1,198 @@
+---
+name: tfx-prune
+description: "AI가 생성한 불필요한 코드(슬롭)를 제거할 때 사용한다. 'deslop', '슬롭 제거', 'anti-slop', '코드 정리', '불필요한 코드 제거', '과잉 추상화 정리' 같은 요청에 반드시 사용. AI 생성 코드의 중복, 불필요 추상화, 과잉 에러 핸들링을 정리할 때 적극 활용."
+triggers:
+  - deslop
+  - 슬롭 제거
+  - anti-slop
+  - 정리
+  - slop
+argument-hint: "[파일 경로 또는 git diff 범위]"
+---
+
+# tfx-prune — Tri-Verified AI Slop Remover
+
+> OMC ai-slop-cleaner 오마주. 핵심 차별점: 단일 판단이 아닌 **3자 독립 감지 + 합의** 기반 제거.
+> "AI가 만든 슬롭은 AI 3명이 합의해야 슬롭이다."
+
+## 용도
+
+- AI 생성 코드에서 불필요한 추상화, 중복, 과잉 패턴 제거
+- 코드 리뷰 후 슬롭 정리
+- 리팩터링 후 AI가 추가한 불필요한 코드 청소
+- PR 머지 전 코드 품질 최종 점검
+
+## 슬롭 카테고리
+
+| 카테고리 | 설명 | 예시 |
+|----------|------|------|
+| 불필요 추상화 | 단일 용도인데 인터페이스/팩토리/전략 패턴 적용 | `UserFactory` for 1 user type |
+| 중복 코드 | 같은 로직의 반복 | 동일 validation을 3곳에 복붙 |
+| 과잉 에러 핸들링 | 발생 불가능한 에러를 처리 | `catch (e) { /* impossible */ }` |
+| 과잉 주석 | 코드가 이미 명확한데 주석 | `// increment i by 1` `i++` |
+| 과잉 타입 | 불필요하게 복잡한 타입 정의 | 5단계 중첩 제네릭 |
+| 사용되지 않는 코드 | import 했지만 사용 안 함 | dead imports, unused variables |
+| 과잉 로깅 | 불필요한 console.log/debug | `console.log("here")` |
+
+## 워크플로우
+
+### Step 0: 슬롭 제거 범위 선택
+
+인자 없이 호출된 경우, AskUserQuestion으로 대상 범위를 선택받는다:
+
+```
+AskUserQuestion:
+  "슬롭 제거 범위를 선택하세요:"
+  1. 최근 변경 파일만 (git diff)
+  2. 전체 프로젝트
+  3. 특정 디렉토리 지정
+```
+
+- 1번 선택 → `git diff HEAD`로 최근 변경 파일 대상
+- 2번 선택 → 프로젝트 전체 소스 파일 대상 (대규모 주의 경고 표시)
+- 3번 선택 → 추가 AskUserQuestion으로 대상 디렉토리 경로 입력받음
+
+파일 경로나 git diff 범위가 인자로 이미 제공된 경우 이 단계를 건너뛴다.
+
+### Step 1: 대상 파일 수집
+
+```
+입력에 따라 대상 결정:
+
+1. 파일 경로 지정 → 해당 파일만
+2. git diff 범위 지정 → diff에 포함된 파일
+3. 입력 없음 → git diff HEAD로 최근 변경 파일
+4. "all" → 프로젝트 전체 소스 파일 (주의: 대규모)
+
+대상 파일 목록:
+  Bash("git diff --name-only HEAD~1") 또는 지정된 범위
+  → 소스 파일만 필터 (.ts, .js, .mjs, .tsx, .py 등)
+  → node_modules, dist, build 제외
+```
+
+### Step 2: 3자 독립 슬롭 감지 (Anti-Herding)
+
+3개 CLI가 **동시에, 상호 결과 비공개로** 각 파일의 슬롭을 감지한다:
+
+```
+공통 프롬프트 (각 CLI에 동일하게):
+  "다음 파일에서 AI 슬롭을 감지하세요.
+   슬롭 정의: 불필요 추상화, 중복, 과잉 에러핸들링, 과잉 주석, 과잉 타입,
+              미사용 코드, 과잉 로깅.
+
+   파일: {file_content}
+
+   각 발견에 대해:
+   { id, category, line_start, line_end, description, severity, suggested_fix }
+   severity: critical(기능에 영향) | high(가독성 심각) | medium(개선) | low(취향)
+
+   슬롭이 아닌 것은 보고하지 마세요. 과탐(false positive)보다 미탐이 낫습니다."
+
+실행:
+  Claude (Agent, background): 코드 품질 관점
+  Codex (Bash, background):   구현 효율 관점
+  Gemini (Bash, background):  가독성/DX 관점
+```
+
+### Step 3: 합의 필터링
+
+tfx-consensus 프로토콜로 교차검증한다:
+
+```
+for each finding in ALL results:
+  agreement = count(CLIs that found same or similar slop at same location)
+
+  if agreement >= 2:
+    → "CONFIRMED SLOP" (확정 — 제거 대상)
+  elif agreement == 1:
+    → "UNCONFIRMED" (미확정 — 제거하지 않음)
+
+원칙: 2+ 합의된 항목만 제거한다.
+       1개 CLI만 지적한 항목은 무시한다 (과탐 방지).
+```
+
+### Step 4: 슬롭 제거
+
+확정된 슬롭만 제거한다:
+
+```
+제거 순서 (안전 → 위험):
+  1. 과잉 주석 제거 (가장 안전)
+  2. 미사용 코드/import 제거
+  3. 과잉 로깅 제거
+  4. 과잉 에러핸들링 간소화
+  5. 중복 코드 통합
+  6. 불필요 추상화 제거 (가장 위험 — 인터페이스 변경 가능)
+
+각 제거 후:
+  - 변경 내용을 기록
+  - 제거 이유를 주석으로 남기지 않음 (그것 자체가 슬롭)
+```
+
+### Step 5: 회귀 테스트
+
+```
+제거 후 안전성 검증:
+
+1. 기존 테스트 실행
+   Bash("npm test" 또는 프로젝트 테스트 명령)
+
+2. 테스트 실패 시:
+   → 해당 제거를 롤백
+   → 롤백된 항목을 "위험 — 수동 검토 필요"로 표시
+
+3. 테스트 통과 시:
+   → 제거 확정
+```
+
+### Step 6: 보고서
+
+```markdown
+## Deslop 보고서
+
+### 요약
+| 항목 | 수 |
+|------|-----|
+| 대상 파일 | {count} |
+| 감지 (전체) | {total_findings} |
+| 합의 확정 | {confirmed} |
+| 미확정 (무시) | {unconfirmed} |
+| 제거 완료 | {removed} |
+| 롤백 (테스트 실패) | {rolled_back} |
+
+### 제거된 슬롭
+| # | 파일 | 라인 | 카테고리 | 합의 | 설명 |
+|---|------|------|----------|------|------|
+| 1 | auth.ts | 42-48 | 과잉 주석 | 3/3 | 자명한 코드에 장문 주석 |
+| 2 | utils.ts | 15-20 | 미사용 import | 2/3 | lodash 미사용 |
+
+### 미확정 (수동 검토 권장)
+| # | 파일 | 라인 | 카테고리 | 지적 CLI | 설명 |
+|---|------|------|----------|---------|------|
+| 1 | api.ts | 80-95 | 불필요 추상화 | Codex만 | Factory 패턴 필요성 논쟁 |
+
+### 테스트 결과
+통과: {pass}/{total} | 실패: {fail} | 롤백: {rollback}
+```
+
+## 토큰 예산
+
+| 단계 | 토큰 |
+|------|------|
+| Step 1 (파일 수집) | ~0.5K |
+| Step 2 (3x 독립 감지) | ~6K |
+| Step 3 (합의 필터링) | ~1K |
+| Step 4 (제거) | ~1.5K |
+| Step 5 (회귀 테스트) | ~0.5K |
+| Step 6 (보고서) | ~0.5K |
+| **총합** | **~10K** |
+
+## 사용 예
+
+```
+/tfx-prune
+/tfx-prune src/auth/middleware.ts
+/tfx-prune HEAD~5..HEAD
+/정리 src/
+/anti-slop "과잉 에러 핸들링 제거"
+```

package/skills/tfx-qa/SKILL.md

@@ -0,0 +1,117 @@
+---
+name: tfx-qa
+description: "테스트 실행하고 실패하면 수정해서 통과시켜야 할 때 사용한다. 'qa', '검증해', '테스트 돌려', 'test-fix', '테스트 통과시켜' 같은 요청에 반드시 사용. 테스트 실패를 반복 수정하여 전부 통과시켜야 할 때 적극 활용."
+triggers:
+  - qa
+  - 검증
+  - 테스트 검증
+  - test-fix
+argument-hint: "[테스트 명령 또는 파일 경로]"
+---
+
+# tfx-qa — Light Test-Fix Cycle
+
+> 테스트 실행 → 실패 분석 → 자동 수정 → 재실행. 최대 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
+codex exec --dangerously-bypass-approvals-and-sandbox --skip-git-repo-check \
+  "다음 테스트를 실행하고 결과를 보고하라:
+   명령: {test_command}
+
+   출력 형식:
+   - 총 테스트 수
+   - 통과/실패/스킵 수
+   - 실패한 테스트 목록 (파일:테스트명:에러 메시지)
+   - 실패 원인 분석 (각 실패별)"
+```
+
+### Step 3: 실패 수정 + 재실행 루프
+
+```
+MAX_RETRIES = 3
+retry = 0
+
+WHILE (failures > 0 AND retry < MAX_RETRIES):
+  retry++
+
+  Codex로 실패 수정:
+    codex exec --dangerously-bypass-approvals-and-sandbox --skip-git-repo-check \
+    "다음 테스트 실패를 수정하라:
+     실패 목록: {failures}
+
+     규칙:
+     - 테스트 코드가 아닌 구현 코드를 수정하라 (테스트가 정확한 경우)
+     - 테스트 자체가 잘못된 경우만 테스트를 수정하라
+     - 수정 후 해당 테스트를 다시 실행하여 확인하라"
+
+  재실행하여 결과 확인
+
+END WHILE
+```
+
+### Step 4: 결과 보고
+
+```markdown
+## QA 결과: {test_target}
+
+### 실행 요약
+| 라운드 | 통과 | 실패 | 수정 |
+|--------|------|------|------|
+| Round 1 | {n} | {n} | — |
+| Round 2 | {n} | {n} | {수정 내용} |
+| Round 3 | {n} | {n} | {수정 내용} |
+
+### 최종 결과
+- 테스트: {pass}/{total} 통과
+- 수정된 파일: {list}
+- 미해결 실패: {list, 있으면}
+
+### 수정 상세
+- `{file}:{line}` — {무엇을 왜 수정했는지}
+```
+
+3회 후에도 실패가 남으면 미해결 목록 + 원인 분석을 사용자에게 보고.
+
+## 토큰 예산
+
+| 단계 | 토큰 |
+|------|------|
+| Step 1 (식별) | ~300 |
+| Step 2 (실행) | ~1.5K |
+| Step 3 (수정, 회당) | ~1.5K |
+| Step 4 (보고) | ~500 |
+| **총합 (최대 3회)** | **~5K** |
+
+## 사용 예
+
+```
+/tfx-qa
+/tfx-qa "npm test -- --grep auth"
+/tfx-qa "pytest tests/test_api.py -v"
+/tfx-qa "깨진 테스트 고쳐줘"
+```

package/skills/tfx-research/SKILL.md

@@ -0,0 +1,126 @@
+---
+name: tfx-research
+description: "빠른 웹 검색과 요약이 필요할 때 사용한다. '검색해줘', '찾아봐', '최신 정보', '이거 뭐야', 'search', '공식 문서 확인' 같은 요청에 반드시 사용. 라이브러리 문서, API 레퍼런스, 에러 해결, 최신 뉴스, 팩트 체크 등 외부 정보가 필요한 모든 상황에 적극 활용한다."
+triggers:
+  - tfx-research
+  - 빠른 리서치
+  - 검색
+  - 찾아줘
+  - search
+  - web search
+argument-hint: "<검색 주제>"
+---
+
+# tfx-research — Light Web Research
+
+> 빠른 단일 소스 검색 + 요약. 토큰 최소화, 즉시 결과.
+
+## 용도
+
+- 빠른 팩트 체크
+- 라이브러리/프레임워크 최신 정보 확인
+- API 문서 검색
+- 에러 메시지 해결책 검색
+- 간단한 기술 질문 답변
+
+## 워크플로우
+
+### Step 1: 쿼리 최적화
+
+사용자 입력을 검색에 최적화된 쿼리로 변환한다:
+
+```
+입력: "React 19에서 use() 훅 사용법"
+최적화: "React 19 use() hook usage API reference 2026"
+```
+
+### Step 1.5: 검색 유형 선택 (인자 없이 호출 시)
+
+인자 없이 `/tfx-research`만 호출된 경우, AskUserQuestion으로 검색 유형을 선택받는다:
+
+```
+AskUserQuestion:
+  "검색 유형을 선택하세요:"
+  1. 코드/라이브러리 문서 (context7)
+  2. 학술/논문 (Exa semantic)
+  3. 최신 뉴스/트렌드 (Brave)
+  4. 일반 웹 검색 (Tavily)
+  5. URL 콘텐츠 추출
+```
+
+선택 결과에 따라 Step 2의 자동 선택 로직을 건너뛰고 해당 MCP를 직접 사용한다.
+인자가 제공된 경우 이 단계를 건너뛰고 Step 2의 자동 선택 로직을 따른다.
+
+### Step 2: MCP 소스 자동 선택
+
+검색 유형에 따라 최적 MCP를 자동 선택한다:
+
+| 유형 | 선택 MCP | 이유 |
+|------|----------|------|
+| 코드/라이브러리 문서 | context7 (resolve → query) | 공식 문서 최적화 |
+| 학술/심층 검색 | Exa (web_search_exa) | Neural semantic search |
+| 최신 뉴스/트렌드 | Brave (brave_web_search) | 독립 인덱스, freshness |
+| 일반 웹 검색 | Tavily (tavily_search) | 범용, 빠른 응답 |
+| URL 콘텐츠 추출 | Exa (crawling_exa) | Clean text extraction |
+
+**선택 로직:**
+```
+if query matches library/framework name → context7
+elif query contains "논문", "research", "paper" → Exa (category: "research paper")
+elif query contains "뉴스", "news", "최신" → Brave (brave_news_search)
+elif query contains URL → Exa crawling
+else → Tavily (가장 범용적)
+```
+
+### Step 3: 검색 실행
+
+선택된 MCP로 검색 실행. 결과를 토큰 효율적으로 포맷:
+
+```
+검색 파라미터:
+  - numResults: 5 (토큰 절약)
+  - highlights: true (Exa — 전문 대신 하이라이트)
+  - maxCharacters: 500 (Tavily/Exa — 콘텐츠 제한)
+  - 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
+
+## 사용 예
+
+```
+/tfx-research "Next.js 15 Server Actions best practices"
+/tfx-research "pnpm workspace monorepo setup 2026"
+/tfx-research "ECONNREFUSED 에러 Node.js 해결"
+```

package/skills/tfx-review/SKILL.md

@@ -0,0 +1,51 @@
+---
+name: tfx-review
+description: "코드 리뷰가 필요할 때 사용한다. 'review', '리뷰해줘', '코드 봐줘', '이거 괜찮아?', 'PR 리뷰', '변경사항 확인' 같은 요청에 반드시 사용. git diff, 특정 파일, 또는 최근 변경에 대한 빠른 피드백이 필요할 때 적극 활용."
+triggers:
+  - review
+  - 리뷰
+  - 코드 리뷰
+  - code review
+argument-hint: "[파일 경로 또는 변경 설명]"
+---
+
+# tfx-review — Light Code Review
+
+> Codex 단일 리뷰로 빠른 피드백. 토큰 최소화.
+
+## 워크플로우
+
+### Step 1: 리뷰 대상 식별
+```
+우선순위:
+  1. 사용자가 파일 경로 지정 → 해당 파일
+  2. git diff (staged + unstaged) → 변경된 파일
+  3. 최근 커밋 → git diff HEAD~1
+```
+
+### Step 2: Codex 리뷰 실행
+```bash
+codex exec review --dangerously-bypass-approvals-and-sandbox --skip-git-repo-check \
+  "다음 코드 변경을 리뷰하라. 심각도별 분류(critical/high/medium/low).
+   체크: 로직 결함, 보안 취약점, 성능 문제, SOLID 위반, 에러 핸들링.
+   변경사항: {diff_or_file_content}"
+```
+
+### Step 3: 결과 포맷
+```markdown
+## Code Review: {target}
+
+### Critical (즉시 수정)
+- [C1] {파일:라인} — {설명}
+
+### High (수정 권장)
+- [H1] {파일:라인} — {설명}
+
+### Medium (개선 제안)
+- [M1] {파일:라인} — {설명}
+
+### Summary
+{전체 코드 품질 평가 1-2줄}
+```
+
+## 토큰: ~8K