triflux 9.2.4 → 9.4.0

package/skills/tfx-ralph/SKILL.md

@@ -1,78 +1,23 @@
 ---
 name: tfx-ralph
-description: "작업이 완전히 끝날 때까지 멈추지 않고 반복 실행해야 할 때 사용한다. 'ralph', '끝까지 해', '멈추지 마', 'don't stop', '완료될 때까지', '다 될 때까지 계속' 같은 요청에 반드시 사용. 여러 기준을 모두 충족해야 하는 복잡한 구현 작업에 적극 활용."
+description: >
+  tfx-persist의 별칭(alias). 'ralph', '끝까지 해', '멈추지 마' 같은 요청에 사용.
+  실제 동작은 tfx-persist 스킬이 수행합니다.
+  Use when: ralph, 끝까지, don't stop, 멈추지 마
 triggers:
   - tfx-ralph
-argument-hint: "<완료할 작업 설명>"
+  - ralph
 ---
 
-# tfx-ralph — Alias for tfx-persist
+# tfx-ralph — tfx-persist 별칭
 
-> **래퍼**: tfx-persist의 alias. 동일 기능.
-> `tfx-ralph`는 `tfx-persist`의 alias이다. 동일한 Tri-Verified Persistence Loop을 실행한다.
-> The boulder never stops — but it stops being wrong.
+이 스킬은 `tfx-persist`와 동일합니다. `/tfx-persist` 스킬을 호출하세요.
 
-## 실행 계약
-
-이 스킬은 `tfx-persist`와 **완전히 동일한 실행 흐름**을 공유한다:
-
-1. **동일한 headless multi 경로** — `tfx multi --teammate-mode headless` 기반 3자 검증
-2. **동일한 degradation 체인** — Tier 1 (전체 가용) → Tier 2 (부분 가용) → Tier 3 (Claude only)
-3. **동일한 워크플로우** — Goal Definition → Execution Loop → Final Verification → Deslop Pass
-
-## 전제조건 프로브 및 Tier Degradation
-
-> **진입 즉시 실행** — 10초 내 가시적 출력을 보장한다. 빈 stdout + exit 0 **금지**.
-
-### 환경 프로브
-
-```bash
-psmux --version 2>/dev/null && \
-  curl -sf http://127.0.0.1:27888/status >/dev/null && \
-  codex --version 2>/dev/null && \
-  gemini --version 2>/dev/null
-```
-
-### Tier 판정
-
-| Tier | 조건 | 실행 방식 |
-|------|------|----------|
-| **Tier 1** | psmux + Hub + Codex + Gemini 전부 정상 | 기존 headless multi (변경 없음) |
-| **Tier 2** | 일부 CLI만 가용 (Codex 또는 Gemini 중 하나) | 가용 CLI + Claude Agent 조합 |
-| **Tier 3** | headless 불가 또는 `claude -p` one-shot | Claude Agent only |
-
-```
-IF claude -p (one-shot 모드):
-  → Tier 3 즉시 fallback
-
-IF psmux 없음 OR Hub 미응답:
-  → Tier 3
-
-IF Codex 없음 AND Gemini 없음:
-  → Tier 3
-
-IF Codex 없음 OR Gemini 없음:
-  → Tier 2
-
-ELSE:
-  → Tier 1
-```
-
-### Tier 3 진입 시 필수 출력
-
-```
-⚠ [Tier 3] headless multi 환경 미충족 — single-model 모드로 실행합니다 (consensus 미적용)
-  누락: {missing_components}
-  권장: psmux, Hub, Codex CLI, Gemini CLI 설치 후 재실행
-```
-
-Tier 3에서는 모든 headless dispatch(`tfx multi ...`)를 **Claude Agent**(subagent)로 대체한다.
-Tier 2에서는 누락된 CLI만 Claude Agent로 대체한다.
-
-## 라우팅
+## 동작
 
+Skill 도구로 tfx-persist를 호출한다:
 ```
-/tfx-ralph "{task}" → /tfx-persist "{task}" 로 내부 전달
+Skill: tfx-persist
 ```
 
-전체 워크플로우, 토큰 예산, Anti-Stuck 메커니즘은 [tfx-persist/SKILL.md](../tfx-persist/SKILL.md)를 참조하라.
+사용자의 원래 요청을 그대로 전달한다.

package/skills/tfx-research/SKILL.md

@@ -57,7 +57,7 @@ AskUserQuestion:
 최적화된 쿼리를 Gemini CLI로 전달한다. Gemini는 네이티브 Google Search를 사용해 검색과 요약을 모두 수행한다:
 
 ```
-Bash("bash scripts/tfx-route.sh gemini exec 'Research the following topic. Use Google Search to find current information. Return a structured markdown summary with sources: {optimized_query}'")
+Bash("bash scripts/tfx-route.sh gemini 'Research the following topic. Use Google Search to find current information. Return a structured markdown summary with sources: {optimized_query}' auto 120")
 ```
 
 Gemini가 반환하는 결과에는 검색 결과, 출처 URL, 핵심 요약이 포함된다. Claude는 이 단계에서 토큰을 소비하지 않는다.

package/skills/tfx-review/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: tfx-review
-description: "코드 리뷰가 필요할 때 사용한다. 'review', '리뷰해줘', '코드 봐줘', '이거 괜찮아?', 'PR 리뷰', '변경사항 확인' 같은 요청에 반드시 사용. git diff, 특정 파일, 또는 최근 변경에 대한 빠른 피드백이 필요할 때 적극 활용."
+description: "코드 리뷰가 필요할 때 사용한다. 'review', '리뷰해줘', '코드 봐줘', '이거 괜찮아?', 'PR 리뷰', '변경사항 확인' 같은 요청에 반드시 사용. git diff, 특정 파일, 또는 최근 변경에 대한 빠른 피드백이 필요할 때 적극 활용. 코드 변경사항 확인, '이거 문제 없어?', 'looks good?', 'LGTM?', '머지해도 될까' 같은 요청에도 적극 활용. 꼼꼼한 심층 리뷰는 tfx-deep-review를 사용."
 triggers:
   - review
   - 리뷰

package/skills/tfx-setup/SKILL.md

@@ -11,7 +11,10 @@ argument-hint: "[doctor]"
 
 # tfx-setup — triflux 초기 설정 위저드
 
-> 설치 후 최초 1회 실행 권장. HUD 설정, CLI 확인, 전체 진단을 수행합니다.
+> 설치 후 최초 1회 + **매 업데이트 후** 실행 권장.
+> `tfx update` 완료 후에도 이 스킬의 단계 1.5(훅 등록 확인)를 반드시 실행하여
+> 신규/변경된 훅이 settings.json에 반영되도록 한다.
+> 훅 우선순위 관리는 `tfx-hooks` 스킬의 오케스트레이터 패턴을 따른다.
 
 ## 워크플로우
 
@@ -43,6 +46,19 @@ Bash("triflux setup")
 
 스크립트/HUD/스킬을 `~/.claude/`에 배포. 결과 표시.
 
+#### 단계 1.5: 훅 등록 확인
+
+`~/.claude/settings.json`을 Read 도구로 읽어 필수 훅이 등록되어 있는지 확인한다.
+
+필수 훅 목록:
+| 이벤트 | matcher | 스크립트 | 역할 |
+|--------|---------|---------|------|
+| PreToolUse | Bash\|Agent | headless-guard-fast.sh | Codex/Gemini 직접 호출 차단 |
+| PreToolUse | Bash | psmux-safety-guard.mjs | psmux kill-session 직접 호출 차단 (WT 프리징 방지) |
+| PreToolUse | Skill | tfx-gate-activate.mjs | tfx-multi 게이트 |
+
+누락된 훅이 있으면 update-config 스킬로 등록한다. 이미 있으면 ✅ 표시.
+
 #### 단계 2: HUD 설정
 
 `~/.claude/settings.json`을 Read 도구로 읽어 `statusLine` 확인.