triflux 10.3.4 → 10.7.0

package/skills/tfx-prune/SKILL.md.tmpl

@@ -0,0 +1,200 @@
+---
+internal: true
+name: tfx-prune
+description: "AI가 생성한 불필요한 코드(슬롭)를 제거할 때 사용한다. 'deslop', '슬롭 제거', 'anti-slop', '코드 정리', '불필요한 코드 제거', '과잉 추상화 정리' 같은 요청에 반드시 사용. AI 생성 코드의 중복, 불필요 추상화, 과잉 에러 핸들링을 정리할 때 적극 활용."
+triggers:
+  - deslop
+  - 슬롭 제거
+  - anti-slop
+  - 정리
+  - slop
+argument-hint: "[파일 경로 또는 git diff 범위]"
+---
+
+# {{SKILL_NAME}} — Tri-Verified AI Slop Remover
+
+> **ARGUMENTS 처리**: 이 스킬이 `ARGUMENTS: <값>`과 함께 호출되면, 해당 값을 사용자 입력으로 취급하여
+> 워크플로우의 첫 단계 입력으로 사용한다. ARGUMENTS가 비어있거나 없으면 기존 절차대로 사용자에게 입력을 요청한다.
+
+
+> OMC ai-slop-cleaner 오마주. 핵심 차별점: 단일 판단이 아닌 **3자 독립 감지 + 합의** 기반 제거.
+> "AI가 만든 슬롭은 AI 3명이 합의해야 슬롭이다."
+
+## HARD RULES
+
+> headless-guard가 이 규칙 위반을 **자동 차단**한다. 우회 불가.
+
+1. **`codex exec` / `gemini -p` 직접 호출 절대 금지**
+2. Codex·Gemini → `Bash("tfx multi --teammate-mode headless --auto-attach --dashboard --assign 'cli:프롬프트:역할' --timeout 600")` **만** 사용
+3. Claude → `Agent(run_in_background=true)`
+4. Bash + Agent를 같은 메시지에서 동시 호출하여 병렬 실행
+
+## MODEL ROLES
+
+| CLI | 역할 | 감지 관점 |
+|-----|------|----------|
+| Claude (Opus) | 코드 품질 분석 + 합의 중재 | 설계 원칙, 코드 구조, 불필요 추상화 |
+| Codex | AI 슬롭 탐지 | 구현 효율, 중복 패턴, 과잉 에러 핸들링 |
+| Gemini | 가독성 평가 | 가독성/DX, 과잉 주석, 과잉 타입 |
+
+## 슬롭 카테고리
+
+| 카테고리 | 설명 | 예시 |
+|----------|------|------|
+| 불필요 추상화 | 단일 용도인데 인터페이스/팩토리/전략 패턴 적용 | `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")` |
+
+## EXECUTION STEPS
+
+### Step 0: 슬롭 제거 범위 선택
+
+인자 없이 호출된 경우 사용자에게 범위를 선택받는다:
+
+```
+1. 최근 변경 파일만 (git diff)
+2. 전체 프로젝트
+3. 특정 디렉토리 지정
+```
+
+- 1번 → `git diff HEAD`로 최근 변경 파일 대상
+- 2번 → 프로젝트 전체 소스 파일 대상 (대규모 주의 경고 표시)
+- 3번 → 추가 AskUserQuestion으로 대상 디렉토리 경로 입력받음
+
+파일 경로나 git diff 범위가 인자로 이미 제공된 경우 이 단계를 건너뛴다.
+
+### Step 1: 대상 파일 수집
+
+대상 결정 우선순위:
+1. 파일 경로 지정 → 해당 파일만
+2. git diff 범위 지정 → diff에 포함된 파일
+3. 입력 없음 → `git diff --name-only HEAD~1`로 최근 변경 파일
+4. "all" → 프로젝트 전체 소스 파일 (주의: 대규모)
+
+소스 파일만 필터: `.ts`, `.js`, `.mjs`, `.tsx`, `.py` 등. `node_modules`, `dist`, `build` 제외.
+
+### Step 2: 3자 독립 슬롭 감지 (Anti-Herding)
+
+**아래 2개 도구를 반드시 같은 응답에서 동시에 호출하라.**
+
+Claude (Agent, background):
+```
+Agent(
+  subagent_type="claude-sonnet-4-5",
+  model="opus",
+  run_in_background=true,
+  prompt="다음 파일에서 AI 슬롭을 감지하세요. 코드 품질 관점으로 분석합니다.
+슬롭 정의: 불필요 추상화, 중복, 과잉 에러핸들링, 과잉 주석, 과잉 타입, 미사용 코드, 과잉 로깅.
+파일: {file_content}
+각 발견에 대해 JSON: [{ id, category, line_start, line_end, description, severity, suggested_fix }]
+severity: critical(기능에 영향) | high(가독성 심각) | medium(개선) | low(취향)
+슬롭이 아닌 것은 보고하지 마세요. 과탐(false positive)보다 미탐이 낫습니다."
+)
+```
+
+Codex + Gemini (Bash, background):
+```
+Bash("tfx multi --teammate-mode headless --auto-attach --dashboard \
+  --assign 'codex:다음 파일에서 AI 슬롭을 감지하세요. 구현 효율 관점(중복 패턴, 과잉 에러핸들링, 미사용 코드)으로 분석. 파일: {file_content}. JSON: [{id,category,line_start,line_end,description,severity,suggested_fix}]. severity: critical|high|medium|low. 과탐보다 미탐이 낫습니다.:slop-detector' \
+  --assign 'gemini:다음 파일에서 AI 슬롭을 감지하세요. 가독성/DX 관점(과잉 주석, 과잉 타입, 불필요 추상화)으로 분석. 파일: {file_content}. JSON: [{id,category,line_start,line_end,description,severity,suggested_fix}]. severity: critical|high|medium|low. 과탐보다 미탐이 낫습니다.:readability-reviewer' \
+  --timeout 600")
+```
+
+### Step 3: 합의 필터링
+
+3개 CLI 결과를 교차검증한다:
+
+```
+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}
+```
+
+## ERROR RECOVERY
+
+- Codex/Gemini 타임아웃(600s 초과) → Claude Agent 단독으로 2자 합의 기준(단독 감지도 제거 대상) 적용
+- 테스트 명령 없음 → Step 5 건너뜀, 보고서에 "테스트 미실행 — 수동 검증 필요" 표시
+- 파일 파싱 오류 → 해당 파일 스킵 후 보고서에 "파싱 실패" 기록
+
+## TOKEN BUDGET
+
+| 단계 | 토큰 |
+|------|------|
+| 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-prune/skill.json

@@ -1,13 +1,7 @@
 {
   "name": "tfx-prune",
   "description": "AI가 생성한 불필요한 코드(슬롭)를 제거할 때 사용한다. 'deslop', '슬롭 제거', 'anti-slop', '코드 정리', '불필요한 코드 제거', '과잉 추상화 정리' 같은 요청에 반드시 사용. AI 생성 코드의 중복, 불필요 추상화, 과잉 에러 핸들링을 정리할 때 적극 활용.",
-  "triggers": [
-    "deslop",
-    "슬롭 제거",
-    "anti-slop",
-    "정리",
-    "slop"
-  ],
+  "triggers": ["deslop", "슬롭 제거", "anti-slop", "정리", "slop"],
   "argument_hint": "[파일 경로 또는 git diff 범위]",
   "internal": true
 }

package/skills/tfx-psmux-rules/SKILL.md.tmpl

@@ -0,0 +1,326 @@
+---
+name: tfx-psmux-rules
+description: >
+  psmux + Codex CLI 명령 생성 시 반드시 적용되는 강제 규칙. PowerShell/bash 구분,
+  경로 형식, 인자 이스케이프, WT 정리, 프로파일 지정 방식 등을 검증한다.
+  이 스킬은 psmux, send-keys, codex exec, codex spawn, 세션 생성, worktree 실행,
+  launch 스크립트 생성, WT attach, 패널 스플릿, 스웜 정리 시 자동 트리거된다.
+  다른 스킬(tfx-codex-swarm, tfx-multi, tfx-remote-spawn 등)이 psmux 명령을
+  생성할 때 이 스킬의 규칙을 위반하면 생성을 중단하고 수정해야 한다.
+triggers:
+  - tfx-psmux-rules
+  - psmux-rules
+---
+
+# {{SKILL_NAME}} — psmux + Codex CLI 강제 규칙
+
+> **이 스킬은 참고 문서가 아니다. 강제 규칙이다.**
+> psmux 명령, launch 스크립트, Codex CLI 호출을 생성하는 모든 스킬은
+> 아래 규칙을 **반드시** 준수해야 한다. 위반 시 생성을 중단하고 수정한다.
+
+## 적용 시점
+
+다음 행위 중 하나라도 수행할 때 이 규칙이 자동 적용된다:
+- `psmux send-keys` 명령 생성
+- `launch-*.sh` 또는 `launch-*.ps1` 스크립트 생성
+- `codex` CLI 호출 인자 조합
+- `wt.exe` 탭/패인 명령 생성
+- 스웜 세션 정리
+
+---
+
+## RULE 1: psmux 기본 셸 = PowerShell
+
+psmux 세션의 기본 셸은 **PowerShell**이다.
+
+### MUST NOT (금지)
+
+```bash
+# WRONG — bash 문법을 PowerShell 세션에 직접 전달
+psmux send-keys -t session "cd '/c/Users/...' && codex ..." Enter
+psmux send-keys -t session "prompt=\$(cat file.md)" Enter
+psmux send-keys -t session "export FOO=bar" Enter
+```
+
+### MUST (필수)
+
+```bash
+# CORRECT — PowerShell 구문으로 bash.exe 전체 경로 호출
+BASH_WIN='C:\\Program Files\\Git\\bin\\bash.exe'
+psmux send-keys -t session "& '$BASH_WIN' './launch.sh'" Enter
+
+# CORRECT — PowerShell 네이티브 명령 사용
+psmux send-keys -t session "Set-Location 'C:\\path'" Enter
+psmux send-keys -t session "\$p = Get-Content 'file.md' -Raw" Enter
+```
+
+### 금지 패턴 체크리스트
+
+| 패턴 | 문제 | 대체 |
+|------|------|------|
+| `cd '/c/...'` | PS가 `/c/`를 상대경로로 해석 → `C:\c\...` | `Set-Location 'C:\...'` |
+| `$(cat file)` | bash 명령 치환, PS에서 `Get-Content` 호출됨 | `$p = Get-Content file -Raw` |
+| `&&` | PS7에서 작동하지만 앞 명령 실패 시 의미 다름 | `;` 또는 별도 send-keys |
+| `export VAR=val` | bash 전용 | `$env:VAR = 'val'` |
+| `grep`, `awk`, `sed` | bash 유틸리티 | PS cmdlet 또는 bash.exe 경유 |
+
+---
+
+## RULE 2: 경로는 Windows 형식
+
+psmux send-keys로 전달하는 경로는 반드시 **Windows 형식**이다.
+
+```
+WRONG:  /c/Users/SSAFY/Desktop/Projects/...
+RIGHT:  C:\Users\SSAFY\Desktop\Projects\...
+```
+
+`.sh` 런처 내부에서만 Unix 경로(`/c/...`) 사용 가능.
+
+---
+
+## RULE 3: 프롬프트 인자 인용 필수
+
+PRD/프롬프트 내용을 CLI 인자로 전달할 때 **반드시 인용**한다.
+
+### PowerShell (.ps1)
+
+```powershell
+$p = (Get-Content 'prompt.md' -Raw) -replace "`r`n"," " -replace "`n"," "
+
+# MUST — 인용 필수
+codex -c 'model="gpt-5.3-codex"' "$p"
+
+# MUST NOT — 미인용 시 & ; | 등이 PS 연산자로 해석됨
+codex -c 'model="gpt-5.3-codex"' $p
+```
+
+### Bash (.sh)
+
+```bash
+prompt=$(cat prompt.md)
+
+# MUST — 더블쿼트 필수
+exec codex "$prompt"
+
+# MUST NOT — 워드 스플리팅 + 글로빙 발생
+exec codex $prompt
+```
+
+---
+
+## RULE 4: 프로파일 사용, 인자 하드코딩 금지
+
+Codex든 Gemini든 **모델·effort·실행모드는 프로파일(config)로 관리**한다.
+CLI 인자로 하드코딩하지 않는다.
+
+### 4-1. 프로파일 우선
+
+```bash
+# CORRECT — 프로파일에 model/effort/approval_mode 모두 정의해두고 호출
+codex < prompt.md
+codex --full-auto < prompt.md   # config.toml에 approval_mode 미설정 시만
+
+# WRONG — 인자로 모델·effort 하드코딩
+codex -c 'model="gpt-5.3-codex"' -c 'model_reasoning_effort="high"' "prompt"
+```
+
+프로파일 관리는 `tfx-profile` 스킬 또는 `~/.codex/config.toml` 직접 편집.
+
+### 4-2. config.toml 중복 플래그 금지
+
+config.toml에 이미 설정된 값을 CLI 플래그로 다시 지정하면 **에러**:
+```
+error: the argument '--dangerously-bypass-approvals-and-sandbox' cannot be used multiple times
+```
+
+**규칙**: 런처 생성 전 config.toml을 확인하고, 이미 있는 항목은 CLI에서 생략.
+
+### 4-3. 프롬프트는 stdin으로 전달
+
+프롬프트를 CLI 인자로 넘기면 `--` 접두사 텍스트가 플래그로 파싱되는 문제 발생.
+**항상 stdin(파이프 또는 리다이렉션)으로 전달한다.**
+
+```bash
+# bash 런처
+exec codex < /c/path/prompts/prompt.md
+```
+
+```powershell
+# PS1 런처
+Get-Content 'C:\path\prompts\prompt.md' -Raw | codex
+```
+
+---
+
+## RULE 5: WT 패인 정리 — CRITICAL (크래시/프리징 방지)
+
+> **이 규칙을 위반하면 Windows Terminal이 크래시/프리징된다.**
+> 원인: WT 1.24의 ConPTY close 레이스 버그 ([microsoft/terminal#17871](https://github.com/microsoft/terminal/issues/17871)).
+> `kill-session`은 물론 `send-keys "exit"`도 ConPTY 파이프 끊김 → 동일 레이스 가능.
+> **유일한 안전 경로: detach-client로 WT와 ConPTY 연결을 먼저 분리.**
+
+### MUST — 3단계 정리 (detach-first, 순서 반드시 준수)
+
+```bash
+# 1) WT 클라이언트를 세션에서 detach (ConPTY 연결 안전 분리)
+for s in $(psmux list-sessions -F '#{session_name}' 2>/dev/null | grep "$PREFIX"); do
+  psmux detach-client -t "$s" 2>/dev/null || true
+done
+
+# 2) WT가 detach된 pane을 정리할 시간 확보
+sleep 2
+
+# 3) detach된 세션을 안전하게 kill (WT와 무관)
+for s in $(psmux list-sessions -F '#{session_name}' 2>/dev/null | grep "$PREFIX"); do
+  psmux kill-session -t "$s" 2>/dev/null || true
+done
+```
+
+### MUST NOT — 아래 패턴은 전부 크래시/프리징 유발
+
+```bash
+# WRONG 1 — detach 없이 바로 kill
+psmux kill-session -t "$s"
+
+# WRONG 2 — exit도 ConPTY 파이프 끊김 → 같은 레이스
+psmux send-keys -t "$s" "exit" Enter
+
+# WRONG 3 — WT split pane 직접 닫기 (Ctrl+Shift+W 금지)
+# 대신: pane 안에서 psmux detach (또는 Ctrl+B, D) → pane이 자동으로 닫힘
+```
+
+---
+
+## RULE 5-1: psmux 경로 탐색
+
+psmux는 환경마다 설치 위치가 다르다. `hub/team/psmux.mjs`의 `PSMUX_BIN`이
+자동 탐색하지만, 스크립트에서 직접 psmux를 호출할 때도 경로를 고려해야 한다.
+
+탐색 우선순위:
+1. `$PSMUX_BIN` 환경변수 (설정 시 최우선)
+2. PATH의 `psmux`
+3. `%LOCALAPPDATA%\psmux\psmux.exe` (Windows 기본)
+4. `%APPDATA%\npm\psmux.cmd` (npm global)
+5. `~\scoop\shims\psmux.exe` (Scoop)
+
+---
+
+## RULE 5-2: 설치 / 업데이트 preflight
+
+`psmux`는 단순히 PATH에 있다고 끝이 아니다. Triflux는 아래 capability를 전제로 한다.
+
+- `new-session`
+- `attach-session`
+- `kill-session`
+- `capture-pane`
+- `detach-client` (있으면 attach/detach cleanup hardening에 활용)
+
+설치/업데이트가 의심될 때는 먼저:
+
+```bash
+tfx doctor --json
+```
+
+공식 설치/업데이트 기준:
+
+```bash
+# install
+winget install marlocarlo.psmux
+scoop install psmux
+choco install psmux
+cargo install psmux
+
+# update
+winget upgrade marlocarlo.psmux
+scoop update psmux
+choco upgrade psmux
+cargo install psmux --force
+```
+
+**금지:** 문서/스크립트에서 `npm install -g psmux`를 표준 설치 경로처럼 안내하지 않는다.
+
+---
+
+## RULE 5-3: WT 명령 치트시트
+
+### 패인 분할
+
+```bash
+# 현재 창에서 수평 분할 (상/하)
+wt.exe -w 0 sp -H -p triflux --title "worker" psmux attach-session -t SESSION
+
+# 현재 창에서 수직 분할 (좌/우)
+wt.exe -w 0 sp -V -p triflux --title "worker" psmux attach-session -t SESSION
+
+# 2x2 그리드 (4 패인)
+wt.exe -w 0 \
+  sp -H -p triflux --title "w1" psmux attach-session -t S1 \; \
+  sp -V -p triflux --title "w2" psmux attach-session -t S2 \; \
+  move-focus up \; \
+  sp -V -p triflux --title "w3" psmux attach-session -t S3
+```
+
+### 포커스 이동
+
+```bash
+wt.exe -w 0 move-focus up|down|left|right
+```
+
+### 패인 닫기 (세션 kill보다 안전)
+
+```bash
+wt.exe -w 0 close-pane
+```
+
+### 필수 옵션
+
+| 옵션 | 의미 | 필수 여부 |
+|------|------|----------|
+| `-w 0` | 현재 WT 윈도우 | 필수 (없으면 새 창) |
+| `-p triflux` | triflux WT 프로파일 | 필수 (테마/셸 일관성) |
+| `--title "name"` | 패인 제목 | 권장 (식별용) |
+| `sp -H` / `sp -V` | 분할 방향 | 필수 |
+
+### 새 탭 금지
+
+```bash
+# WRONG — 새 탭 생성 (nt)
+wt.exe -w 0 nt -p triflux ...
+
+# RIGHT — split-pane (sp)
+wt.exe -w 0 sp -V -p triflux ...
+```
+
+---
+
+## RULE 6: WT 탭/창은 wt-manager 경유 필수
+
+- `wt.exe new-tab ...` 직접 호출 금지
+- `wt.exe split-pane ...` 직접 호출 금지
+- `Start-Process wt.exe ...` PowerShell 호출 금지
+- 반드시 wt-manager.mjs의 createTab() / applyLayout() 사용
+
+---
+
+## RULE 7: spark53 프로파일은 Pro 전용
+
+`spark53_med`, `spark53_low` 등 spark 모델 프로파일은 **Codex Pro 구독 전용**이다.
+비-Pro 환경에서는 `codex53_low`로 폴백한다.
+
+---
+
+## RULE 8: WT 레이아웃 선택 필수
+
+WT에 패인을 배치하기 전에 **반드시** 사용자에게 레이아웃을 확인한다.
+새 탭(`nt`)은 금지 — split + dashboard가 기본.
+
+선택지: 새 창에서 스플릿 / 현재 창에서 스플릿 / dashboard / attach 안 함
+
+---
+
+## 위반 감지 시 행동
+
+1. 생성한 명령/스크립트가 위 규칙을 위반하면 **즉시 수정**한다
+2. 수정 불가능하면 **생성을 중단**하고 사용자에게 알린다
+3. 다른 스킬이 이 규칙을 무시하고 명령을 생성하면 **경고를 출력**한다

package/skills/tfx-psmux-rules/skill.json

@@ -1,8 +1,5 @@
 {
   "name": "tfx-psmux-rules",
   "description": "psmux + Codex CLI 명령 생성 시 반드시 적용되는 강제 규칙. PowerShell/bash 구분, 경로 형식, 인자 이스케이프, WT 정리, 프로파일 지정 방식 등을 검증한다. 이 스킬은 psmux, send-keys, codex exec, codex spawn, 세션 생성, worktree 실행, launch 스크립트 생성, WT attach, 패널 스플릿, 스웜 정리 시 자동 트리거된다. 다른 스킬(tfx-codex-swarm, tfx-multi, tfx-remote-spawn 등)이 psmux 명령을 생성할 때 이 스킬의 규칙을 위반하면 생성을 중단하고 수정해야 한다.",
-  "triggers": [
-    "tfx-psmux-rules",
-    "psmux-rules"
-  ]
+  "triggers": ["tfx-psmux-rules", "psmux-rules"]
 }

package/skills/tfx-qa/SKILL.md

@@ -24,6 +24,7 @@ argument-hint: "[테스트 명령 또는 파일 경로]"
 
 
 
+
 > **Deep 버전**: tfx-deep-qa. "제대로/꼼꼼히" 수정자로 자동 에스컬레이션.
 > 테스트 실행 → 실패 분석 → 자동 수정 → 재실행. 최대 3회. OMC ultraqa 영감.
 

package/skills/tfx-qa/skill.json

@@ -1,12 +1,7 @@
 {
   "name": "tfx-qa",
   "description": "테스트 실행하고 실패하면 수정해서 통과시켜야 할 때 사용한다. 'qa', '검증해', '테스트 돌려', 'test-fix', '테스트 통과시켜' 같은 요청에 반드시 사용. 테스트 실패를 반복 수정하여 전부 통과시켜야 할 때 적극 활용.",
-  "triggers": [
-    "qa",
-    "검증",
-    "테스트 검증",
-    "test-fix"
-  ],
+  "triggers": ["qa", "검증", "테스트 검증", "test-fix"],
   "argument_hint": "[테스트 명령 또는 파일 경로]",
   "internal": true
 }

package/skills/tfx-ralph/SKILL.md.tmpl

@@ -0,0 +1,28 @@
+---
+internal: true
+name: tfx-ralph
+description: >
+  tfx-persist의 별칭(alias). 'ralph', '끝까지 해', '멈추지 마' 같은 요청에 사용.
+  실제 동작은 tfx-persist 스킬이 수행합니다.
+  Use when: ralph, 끝까지, don't stop, 멈추지 마
+triggers:
+  - tfx-ralph
+  - ralph
+---
+
+# {{SKILL_NAME}} — tfx-persist 별칭
+
+> **ARGUMENTS 처리**: 이 스킬이 `ARGUMENTS: <값>`과 함께 호출되면, 해당 값을 사용자 입력으로 취급하여
+> 워크플로우의 첫 단계 입력으로 사용한다. ARGUMENTS가 비어있거나 없으면 기존 절차대로 사용자에게 입력을 요청한다.
+
+
+이 스킬은 `tfx-persist`와 동일합니다. `/tfx-persist` 스킬을 호출하세요.
+
+## 동작
+
+Skill 도구로 tfx-persist를 호출한다:
+```
+Skill: tfx-persist
+```
+
+사용자의 원래 요청을 그대로 전달한다.

package/skills/tfx-ralph/skill.json

@@ -1,9 +1,6 @@
 {
   "name": "tfx-ralph",
   "description": "tfx-persist의 별칭(alias). 'ralph', '끝까지 해', '멈추지 마' 같은 요청에 사용. 실제 동작은 tfx-persist 스킬이 수행합니다. Use when: ralph, 끝까지, don't stop, 멈추지 마",
-  "triggers": [
-    "tfx-ralph",
-    "ralph"
-  ],
+  "triggers": ["tfx-ralph", "ralph"],
   "internal": true
 }