triflux 7.1.4 → 7.2.1

package/skills/tfx-auto-codex/SKILL.md

@@ -1,77 +1,98 @@
----
-name: tfx-auto-codex
-description: Codex 리드형 tfx-auto. Claude 네이티브 역할을 Codex로 치환하고 Gemini 사용은 유지합니다.
-triggers:
-  - tfx-auto-codex
-argument-hint: "\"작업 설명\" | N:agent_type \"작업 설명\""
----
-
-# tfx-auto-codex — Codex 리드형 tfx-auto
-
-> 목적: 기존 `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 xhigh` 기준으로 운용.
-
-## 사용법
-
-```bash
-/tfx-auto-codex "인증 리팩터링 + UI 개선 + 테스트 보강"
-/tfx-auto-codex 3:codex "src/api, src/auth, src/payment 병렬 리뷰"
-/tfx-auto-codex 2:gemini "온보딩 UI 카피 + 접근성 개선"
-```
-
-## 실행 규칙
-
-`tfx-auto` 워크플로우(입력 파싱 → 트리아지 → 분해 → DAG 실행 → 수집/보고)를 그대로 사용한다.
-
-단, **실행 명령은 아래 환경변수를 반드시 포함**한다:
-
-```bash
-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`
-- `test-engineer` -> Codex `high`
-- `qa-tester` -> Codex `thorough review`
-
-## 트리아지 기준
-
-- `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` 캐시 초기화)
+---
+name: tfx-auto-codex
+description: Codex 리드형 tfx-auto. Claude 네이티브 역할을 Codex로 치환하고 Gemini 사용은 유지합니다.
+triggers:
+  - tfx-auto-codex
+argument-hint: "\"작업 설명\" | N:agent_type \"작업 설명\""
+---
+
+# tfx-auto-codex — Codex 리드형 tfx-auto
+
+> 목적: 기존 `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 xhigh` 기준으로 운용.
+
+## 사용법
+
+```bash
+/tfx-auto-codex "인증 리팩터링 + UI 개선 + 테스트 보강"
+/tfx-auto-codex 3:codex "src/api, src/auth, src/payment 병렬 리뷰"
+/tfx-auto-codex 2:gemini "온보딩 UI 카피 + 접근성 개선"
+```
+
+## 실행 규칙
+
+`tfx-auto` 워크플로우(입력 파싱 → 트리아지 → 분해 → DAG 실행 → 수집/보고)를 그대로 사용한다.
+
+단, **실행 명령은 아래 환경변수를 반드시 포함**한다:
+
+```bash
+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 라우팅을 재정의한다.
+
+```bash
+# 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` 캐시 초기화)

package/skills/tfx-codex/SKILL.md

@@ -1,65 +1,65 @@
----
-name: tfx-codex
-description: Codex-Only 오케스트레이터. tfx-auto 워크플로우를 Codex 전용으로 고정합니다.
-triggers:
-  - tfx-codex
-argument-hint: "\"작업 설명\" | N:codex \"작업 설명\""
----
-
-# tfx-codex — Codex-Only 오케스트레이터
-
-> Codex CLI만 사용하여 모든 외부 CLI 작업을 라우팅합니다.
-> Gemini CLI가 없는 환경에서 사용합니다.
-
-## 사용법
-
-```
-/tfx-codex "작업 설명"
-/tfx-codex N:codex "작업 설명"
-```
-
-## 동작 원리
-
-`tfx-auto`와 동일한 워크플로우를 사용하되, `TFX_CLI_MODE=codex` 환경변수를 설정하여
-모든 Gemini 에이전트(designer, writer)를 Codex로 리매핑합니다.
-
-### 에이전트 라우팅
-
-| 에이전트 | 원래 CLI | tfx-codex에서 |
-|----------|---------|-------------|
-| executor, build-fixer, debugger | Codex | Codex (변경 없음) |
-| architect, planner, critic, analyst | Codex | Codex (변경 없음) |
-| code-reviewer, security-reviewer | Codex | Codex (변경 없음) |
-| scientist, document-specialist | Codex | Codex (변경 없음) |
-| **designer** | ~~Gemini~~ | **Codex** (effort: high) — UI 코드 생성 |
-| **writer** | ~~Gemini~~ | **Codex Spark** (effort: spark_fast) — 경량 문서 |
-| explore | Claude Haiku | Claude Haiku (변경 없음) |
-| verifier, test-engineer | Claude Sonnet | Claude Sonnet (변경 없음) |
-
-## 실행 규칙
-
-**tfx-auto SKILL.md의 전체 워크플로우(커맨드 숏컷 → 트리아지 → 실행 → 결과 파싱 → 보고)를 그대로 따릅니다.**
-
-유일한 차이점:
-
-1. **Phase 3 CLI 실행 시** `TFX_CLI_MODE=codex`를 환경변수로 전달:
-   ```bash
-   TFX_CLI_MODE=codex bash ~/.claude/scripts/tfx-route.sh {agent} '{prompt}' {mcp_profile}
-   ```
-
-2. **Phase 2 트리아지에서** gemini 분류 결과를 codex로 강제 변환:
-   - Codex 분류가 `gemini`를 반환하면 → `codex`로 교체
-   - Opus 분해에서 designer/writer → Codex 에이전트 + implement/analyze MCP 프로필
-
-3. **MCP 프로필 조정**:
-   - designer: `implement` (코드 기반 UI 작업)
-   - writer: `analyze` (문서 기반 리서치+작성)
-
-## 필수 조건
-
-- [Codex CLI](https://github.com/openai/codex): `npm install -g @openai/codex`
-- Gemini CLI 불필요
-
-## Troubleshooting
-
-문제 발생 시 `/tfx-doctor` 실행. (`--fix` 자동 수정, `--reset` 캐시 초기화)
+---
+name: tfx-codex
+description: Codex-Only 오케스트레이터. tfx-auto 워크플로우를 Codex 전용으로 고정합니다.
+triggers:
+  - tfx-codex
+argument-hint: "\"작업 설명\" | N:codex \"작업 설명\""
+---
+
+# tfx-codex — Codex-Only 오케스트레이터
+
+> Codex CLI만 사용하여 모든 외부 CLI 작업을 라우팅합니다.
+> Gemini CLI가 없는 환경에서 사용합니다.
+
+## 사용법
+
+```
+/tfx-codex "작업 설명"
+/tfx-codex N:codex "작업 설명"
+```
+
+## 동작 원리
+
+`tfx-auto`와 동일한 워크플로우를 사용하되, `TFX_CLI_MODE=codex` 환경변수를 설정하여
+모든 Gemini 에이전트(designer, writer)를 Codex로 리매핑합니다.
+
+### 에이전트 라우팅
+
+| 에이전트 | 원래 CLI | tfx-codex에서 |
+|----------|---------|-------------|
+| executor, build-fixer, debugger | Codex | Codex (변경 없음) |
+| architect, planner, critic, analyst | Codex | Codex (변경 없음) |
+| code-reviewer, security-reviewer | Codex | Codex (변경 없음) |
+| scientist, document-specialist | Codex | Codex (변경 없음) |
+| **designer** | ~~Gemini~~ | **Codex** (effort: high) — UI 코드 생성 |
+| **writer** | ~~Gemini~~ | **Codex Spark** (effort: spark_fast) — 경량 문서 |
+| explore | Claude Haiku | Claude Haiku (변경 없음) |
+| verifier, test-engineer | Claude Sonnet | Codex (변경 없음) |
+
+## 실행 규칙
+
+**tfx-auto SKILL.md의 커맨드 숏컷 → 트리아지 → 멀티 태스크 라우팅 → 실행 → 결과 파싱 → 보고 섹션을 그대로 따릅니다.**
+
+유일한 차이점:
+
+1. **실행 섹션(CLI 에이전트) 수행 시** `TFX_CLI_MODE=codex`를 환경변수로 전달:
+   ```bash
+   TFX_CLI_MODE=codex bash ~/.claude/scripts/tfx-route.sh {agent} '{prompt}' {mcp_profile}
+   ```
+
+2. **트리아지 섹션에서** gemini 분류 결과를 codex로 강제 변환:
+   - Codex 분류가 `gemini`를 반환하면 → `codex`로 교체
+   - Opus 분해에서 designer/writer → Codex 에이전트 + implement/analyze MCP 프로필
+
+3. **MCP 프로필 조정**:
+   - designer: `implement` (코드 기반 UI 작업)
+   - writer: `analyze` (문서 기반 리서치+작성)
+
+## 필수 조건
+
+- [Codex CLI](https://github.com/openai/codex): `npm install -g @openai/codex`
+- Gemini CLI 불필요
+
+## Troubleshooting
+
+문제 발생 시 `/tfx-doctor` 실행. (`--fix` 자동 수정, `--reset` 캐시 초기화)

package/skills/tfx-gemini/SKILL.md

@@ -1,82 +1,83 @@
----
-name: tfx-gemini
-description: Gemini-Only 오케스트레이터. tfx-auto 워크플로우를 Gemini 전용으로 고정합니다.
-triggers:
-  - tfx-gemini
-argument-hint: "\"작업 설명\" | N:gemini \"작업 설명\""
----
-
-# tfx-gemini — Gemini-Only 오케스트레이터
-
-> Gemini CLI만 사용하여 모든 외부 CLI 작업을 라우팅합니다.
-> Codex CLI가 없는 환경에서 사용합니다.
-
-## 사용법
-
-```
-/tfx-gemini "작업 설명"
-/tfx-gemini N:gemini "작업 설명"
-```
-
-## 동작 원리
-
-`tfx-auto`와 동일한 워크플로우를 사용하되, `TFX_CLI_MODE=gemini` 환경변수를 설정하여
-모든 Codex 에이전트를 Gemini로 리매핑합니다.
-
-### 에이전트 라우팅
-
-| 에이전트 | 원래 CLI | tfx-gemini에서 |
-|----------|---------|--------------|
-| **executor, debugger, deep-executor** | ~~Codex~~ | **Gemini Pro** |
-| **build-fixer** | ~~Codex~~ | **Gemini Flash** |
-| **architect, planner, critic, analyst** | ~~Codex~~ | **Gemini Pro** |
-| **code-reviewer, security-reviewer, quality-reviewer** | ~~Codex~~ | **Gemini Pro** |
-| **scientist, scientist-deep** | ~~Codex~~ | **Gemini Pro/Flash** |
-| **document-specialist** | ~~Codex~~ | **Gemini Flash** |
-| designer | Gemini | Gemini (변경 없음) |
-| writer | Gemini | Gemini (변경 없음) |
-| explore | Claude Haiku | Claude Haiku (변경 없음) |
-| verifier, test-engineer | Claude Sonnet | Claude Sonnet (변경 없음) |
-
-### 모델 분기
-
-| 복잡도 | Gemini 모델 | 대상 에이전트 | 근거 |
-|--------|------------|-------------|------|
-| 높음 | `gemini-3.1-pro-preview` | executor, debugger, deep-executor | 구현/분석 깊이 필요 |
-| 높음 | `gemini-3.1-pro-preview` | architect, planner, critic, analyst | 설계 품질 |
-| 높음 | `gemini-3.1-pro-preview` | code-reviewer, security-reviewer, quality-reviewer | 리뷰 품질 |
-| 높음 | `gemini-3.1-pro-preview` | scientist-deep | 심층 리서치 |
-| 낮음 | `gemini-3-flash-preview` | build-fixer, spark | 빠른 수정/린트 |
-| 낮음 | `gemini-3-flash-preview` | scientist, document-specialist | 일반 검색+요약 |
-| 낮음 | `gemini-3-flash-preview` | writer | 문서/가이드 생성 |
-
-## 실행 규칙
-
-**tfx-auto SKILL.md의 전체 워크플로우(커맨드 숏컷 → 트리아지 → 실행 → 결과 파싱 → 보고)를 그대로 따릅니다.**
-
-유일한 차이점:
-
-1. **Phase 3 CLI 실행 시** `TFX_CLI_MODE=gemini`을 환경변수로 전달:
-   ```bash
-   TFX_CLI_MODE=gemini bash ~/.claude/scripts/tfx-route.sh {agent} '{prompt}' {mcp_profile}
-   ```
-
-2. **Phase 2 트리아지에서** codex 분류 결과를 gemini로 강제 변환:
-   - Codex 분류가 `codex`를 반환하면 → `gemini`로 교체
-   - Opus 분해에서 모든 Codex 에이전트 → Gemini 모델 매핑
-
-3. **Phase 2a Codex 분류 단계를 건너뜀**:
-   - Codex CLI가 없으므로 Opus가 직접 분류+분해 수행
-
-4. **Windows 안정화 자동 적용**:
-   - 모든 Gemini 워커에 `--timeout 60` + health check
-   - hang 감지 시 자동 재시도
-
-## 필수 조건
-
-- [Gemini CLI](https://github.com/google-gemini/gemini-cli): `npm install -g @google/gemini-cli`
-- Codex CLI 불필요
-
-## Troubleshooting
-
-문제 발생 시 `/tfx-doctor` 실행. (`--fix` 자동 수정, `--reset` 캐시 초기화)
+---
+name: tfx-gemini
+description: Gemini-Only 오케스트레이터. tfx-auto 워크플로우를 Gemini 전용으로 고정합니다.
+triggers:
+  - tfx-gemini
+argument-hint: "\"작업 설명\" | N:gemini \"작업 설명\""
+---
+
+# tfx-gemini — Gemini-Only 오케스트레이터
+
+> Gemini CLI만 사용하여 모든 외부 CLI 작업을 라우팅합니다.
+> Codex CLI가 없는 환경에서 사용합니다.
+
+## 사용법
+
+```
+/tfx-gemini "작업 설명"
+/tfx-gemini N:gemini "작업 설명"
+```
+
+## 동작 원리
+
+`tfx-auto`와 동일한 워크플로우를 사용하되, `TFX_CLI_MODE=gemini` 환경변수를 설정하여
+모든 Codex 에이전트를 Gemini로 리매핑합니다.
+
+### 에이전트 라우팅
+
+| 에이전트 | 원래 CLI | tfx-gemini에서 |
+|----------|---------|--------------|
+| **executor, debugger, deep-executor** | ~~Codex~~ | **Gemini Pro** |
+| **build-fixer** | ~~Codex~~ | **Gemini Flash** |
+| **architect, planner, critic, analyst** | ~~Codex~~ | **Gemini Pro** |
+| **code-reviewer, security-reviewer, quality-reviewer** | ~~Codex~~ | **Gemini Pro** |
+| **scientist** | ~~Codex~~ | **Gemini Flash** |
+| **scientist-deep** | ~~Codex~~ | **Gemini Pro** |
+| **document-specialist** | ~~Codex~~ | **Gemini Flash** |
+| designer | Gemini | Gemini (변경 없음) |
+| writer | Gemini | Gemini (변경 없음) |
+| explore | Claude Haiku | Claude Haiku (변경 없음) |
+| verifier, test-engineer | Claude Sonnet | Claude Sonnet (변경 없음) |
+
+### 모델 분기
+
+| 복잡도 | Gemini 모델 | 대상 에이전트 | 근거 |
+|--------|------------|-------------|------|
+| 높음 | `gemini-3.1-pro-preview` | executor, debugger, deep-executor | 구현/분석 깊이 필요 |
+| 높음 | `gemini-3.1-pro-preview` | architect, planner, critic, analyst | 설계 품질 |
+| 높음 | `gemini-3.1-pro-preview` | code-reviewer, security-reviewer, quality-reviewer | 리뷰 품질 |
+| 높음 | `gemini-3.1-pro-preview` | scientist-deep | 심층 리서치 |
+| 낮음 | `gemini-3-flash-preview` | build-fixer, spark | 빠른 수정/린트 |
+| 낮음 | `gemini-3-flash-preview` | scientist, document-specialist | 일반 검색+요약 |
+| 낮음 | `gemini-3-flash-preview` | writer | 문서/가이드 생성 |
+
+## 실행 규칙
+
+**tfx-auto SKILL.md의 커맨드 숏컷 → 트리아지 → 멀티 태스크 라우팅 → 실행 → 결과 파싱 → 보고 섹션을 그대로 따릅니다.**
+
+유일한 차이점:
+
+1. **실행 섹션(CLI 에이전트) 수행 시** `TFX_CLI_MODE=gemini`을 환경변수로 전달:
+   ```bash
+   TFX_CLI_MODE=gemini bash ~/.claude/scripts/tfx-route.sh {agent} '{prompt}' {mcp_profile}
+   ```
+
+2. **트리아지 섹션에서** codex 분류 결과를 gemini로 강제 변환:
+   - Codex 분류가 `codex`를 반환하면 → `gemini`로 교체
+   - Opus 분해에서 모든 Codex 에이전트 → Gemini 모델 매핑
+
+3. **트리아지 섹션 1단계(Codex 분류)를 건너뜀**:
+   - Codex CLI가 없으므로 Opus가 직접 분류+분해 수행
+
+4. **Windows 안정화 자동 적용**:
+   - 모든 Gemini 워커에 `--timeout 60` + health check
+   - hang 감지 시 자동 재시도
+
+## 필수 조건
+
+- [Gemini CLI](https://github.com/google-gemini/gemini-cli): `npm install -g @google/gemini-cli`
+- Codex CLI 불필요
+
+## Troubleshooting
+
+문제 발생 시 `/tfx-doctor` 실행. (`--fix` 자동 수정, `--reset` 캐시 초기화)