triflux 10.4.0 → 10.7.0

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

@@ -0,0 +1,189 @@
+---
+internal: true
+name: tfx-autoroute
+description: "작업 유형에 따라 최적 모델을 자동 선택하여 실행해야 할 때 사용한다. 'sisyphus', '시지프스', 'auto-route', '알아서 라우팅', '최적 모델로' 같은 요청에 사용. 어떤 CLI를 쓸지 모르겠을 때, 또는 실패 시 자동 모델 승격이 필요할 때 적극 활용."
+triggers:
+  - sisyphus
+  - 끝없이
+  - never stop
+  - 시지프스
+  - auto-route
+argument-hint: "<작업 설명>"
+---
+
+# {{SKILL_NAME}} — Auto-Routing Autonomous Executor
+
+> **ARGUMENTS 처리**: 이 스킬이 `ARGUMENTS: <값>`과 함께 호출되면, 해당 값을 사용자 입력으로 취급하여
+> 워크플로우의 첫 단계 입력으로 사용한다. ARGUMENTS가 비어있거나 없으면 기존 절차대로 사용자에게 입력을 요청한다.
+
+
+> oh-my-openagent Sisyphus agent 오마주. 바위는 멈추지 않는다 — 그리고 올바른 산을 고른다.
+> "실패하면 더 강한 모델로. 성공할 때까지."
+
+## 용도
+
+- 작업 유형을 모르겠을 때 자동으로 최적 CLI 선택
+- 실패 허용 없이 끝까지 완수해야 할 때
+- Haiku로 충분한 작업에 Opus를 낭비하지 않을 때
+- 비용 최적화 + 완수율 극대화
+
+## 핵심 원리
+
+```
+1. IntentGate로 작업 유형 분류
+2. 유형에 맞는 최적 CLI/모델에 라우팅
+3. 실패 시 자동 승격 (Haiku → Sonnet → Opus, Codex normal → xhigh)
+4. 최종 실패 시에만 사용자에게 보고
+```
+
+## 워크플로우
+
+### Step 0: 라우팅 전략 선택
+
+실행 전에 AskUserQuestion으로 모델 라우팅 전략을 선택받는다:
+
+```
+AskUserQuestion:
+  "기본 라우팅 전략을 선택하세요:"
+  1. 자동 (IntentGate 판단) [기본]
+  2. 성능 우선 (Codex 위주)
+  3. 비용 절약 (Haiku 위주)
+  4. 정확도 우선 (Opus 위주)
+```
+
+- 1번 선택 → Step 1의 IntentGate 분류를 정상 수행
+- 2번 선택 → primary_cli를 Codex(xhigh)로 고정, 실패 시에만 Opus fallback
+- 3번 선택 → primary_cli를 Claude Haiku로 고정, 실패 시 Sonnet → Codex 순 승격
+- 4번 선택 → primary_cli를 Claude Opus로 고정, fallback 없음
+
+사용자가 빈 응답을 보내면 기본값 1번(자동)을 적용한다.
+
+### Step 1: IntentGate 분류
+
+사용자 입력을 분석하여 작업 카테고리와 복잡도를 판단한다:
+
+```
+분류 결과:
+{
+  "category": "visual | deep | quick | code | research | review",
+  "complexity": "trivial | simple | moderate | complex | extreme",
+  "estimated_tokens": N,
+  "routing": {
+    "primary_cli": "gemini | codex | claude",
+    "primary_model": "flash | normal | haiku",
+    "fallback_chain": ["sonnet", "opus"]
+  }
+}
+```
+
+### Step 2: 카테고리 라우팅
+
+| 카테고리 | Primary CLI | Primary 모델 | 이유 |
+|----------|-------------|-------------|------|
+| visual (UI/디자인/멀티모달) | Gemini | flash | 시각적 처리 최적 |
+| deep (아키텍처/설계/분석) | Codex | xhigh | 깊은 추론 필요 |
+| quick (간단한 수정/질문) | Claude | haiku | 최소 비용 |
+| code (구현/디버깅/리팩터링) | Codex | normal | 코드 작성 최적 |
+| research (검색/문서/조사) | Codex | normal | MCP 접근 |
+| review (리뷰/검증/QA) | Codex | thorough | 꼼꼼한 검토 |
+
+### Step 3: 실행
+
+라우팅 결과에 따라 실행한다:
+
+```
+if primary_cli == "codex":
+  Bash("bash ~/.claude/scripts/tfx-route.sh codex '{prompt}' implement")
+
+elif primary_cli == "gemini":
+  Bash("bash ~/.claude/scripts/tfx-route.sh gemini '{prompt}' implement")
+
+elif primary_cli == "claude":
+  if primary_model == "haiku":
+    Agent(model="haiku", prompt="{prompt}")
+  else:
+    Agent(model="sonnet", prompt="{prompt}")
+```
+
+### Step 4: 실패 감지 및 자동 승격
+
+실행 결과를 평가하고, 실패 시 fallback chain을 따라 승격한다:
+
+```
+실패 판단 기준:
+  - exit_code != 0
+  - 출력에 "error", "failed", "unable to" 포함
+  - 출력이 비어 있음
+  - 출력이 프롬프트를 반복하기만 함 (hallucination)
+
+승격 체인:
+  Level 0: primary (최소 비용)
+    ↓ 실패
+  Level 1: 동일 CLI, 모델 한 단계 승격
+    예: haiku → sonnet, codex normal → codex xhigh
+    ↓ 실패
+  Level 2: CLI 전환 + 강한 모델
+    예: gemini → codex xhigh, codex → claude opus
+    ↓ 실패
+  Level 3: Claude Opus 직접 실행 (최후 수단)
+    ↓ 실패
+  Level 4: 사용자에게 보고 + 도움 요청 (AskUserQuestion)
+```
+
+### Step 5: 결과 보고
+
+```markdown
+## Sisyphus 완료
+
+**작업**: {task_description}
+**분류**: {category} / {complexity}
+**라우팅**: {primary_cli} ({primary_model})
+**승격 횟수**: {escalation_count}
+**최종 실행**: {final_cli} ({final_model})
+
+### 실행 경로
+| 시도 | CLI | 모델 | 결과 | 토큰 |
+|------|-----|------|------|------|
+| 1 | Haiku | haiku | 실패 (불완전) | ~1K |
+| 2 | Codex | normal | 성공 | ~3K |
+
+### 결과
+{output}
+
+### 비용 절감
+Primary Opus였다면: ~{opus_cost}K tokens
+실제 사용: ~{actual_cost}K tokens
+절감: {savings}%
+```
+
+## Anti-Stuck 메커니즘
+
+```
+같은 에러로 2회 연속 실패 시:
+  → 에러 메시지를 다음 프롬프트에 포함하여 우회 시도
+
+승격 체인 전체 소진 시 (Level 4):
+  → AskUserQuestion: "다음 작업이 모든 모델에서 실패했습니다.
+     에러: {error}. 접근 방식을 변경하시겠습니까?"
+```
+
+## 토큰 예산
+
+가변. 최소 비용 라우팅이 핵심이므로 고정 예산 없음.
+
+| 시나리오 | 예상 토큰 |
+|----------|----------|
+| 1회 성공 (haiku) | ~2K |
+| 1회 성공 (codex) | ~5K |
+| 1회 승격 후 성공 | ~8K |
+| 2회 승격 후 성공 | ~15K |
+| 전체 체인 소진 | ~25K |
+
+## 사용 예
+
+```
+/tfx-autoroute "이 함수의 타입 에러 수정해"
+/tfx-autoroute "프로젝트 구조 분석해서 아키텍처 다이어그램 만들어"
+/tfx-autoroute "README.md 한국어로 번역"
+/시지프스 "테스트 커버리지 80%까지 올려"
+```

package/skills/tfx-autoroute/skill.json

@@ -1,13 +1,7 @@
 {
   "name": "tfx-autoroute",
   "description": "작업 유형에 따라 최적 모델을 자동 선택하여 실행해야 할 때 사용한다. 'sisyphus', '시지프스', 'auto-route', '알아서 라우팅', '최적 모델로' 같은 요청에 사용. 어떤 CLI를 쓸지 모르겠을 때, 또는 실패 시 자동 모델 승격이 필요할 때 적극 활용.",
-  "triggers": [
-    "sisyphus",
-    "끝없이",
-    "never stop",
-    "시지프스",
-    "auto-route"
-  ],
+  "triggers": ["sisyphus", "끝없이", "never stop", "시지프스", "auto-route"],
   "argument_hint": "<작업 설명>",
   "internal": true
 }

package/skills/tfx-codex/SKILL.md

@@ -23,6 +23,7 @@ argument-hint: "\"작업 설명\" | N:codex \"작업 설명\""
 
 
 
+
 > **래퍼**: tfx-auto의 Codex 전용 바로가기. TFX_CLI_MODE=codex.
 > **HARD RULE**: Claude는 이 스킬에서 Edit/Write를 사용하면 안 된다. 모든 코드 수정은 Codex CLI를 통해 수행한다.
 > Codex CLI만 사용하여 모든 외부 CLI 작업을 라우팅합니다.

package/skills/tfx-codex/skill.json

@@ -1,9 +1,7 @@
 {
   "name": "tfx-codex",
   "description": "Codex-Only 오케스트레이터. tfx-auto 워크플로우를 Codex 전용으로 고정합니다. '코덱스로 해줘', '코덱스한테 시켜', 'codex로', 'Codex 전용' 같은 요청에 반드시 사용.",
-  "triggers": [
-    "tfx-codex"
-  ],
+  "triggers": ["tfx-codex"],
   "argument_hint": "\\\"작업 설명\\\" | N:codex \\\"작업 설명\\\"",
   "internal": true
 }

package/skills/tfx-codex-swarm/SKILL.md.tmpl

@@ -0,0 +1,16 @@
+---
+name: tfx-codex-swarm
+deprecated: true
+superseded-by: tfx-swarm
+description: "DEPRECATED — tfx-swarm으로 통합됨. 'codex swarm', '코덱스 스웜' 요청은 tfx-swarm이 처리."
+triggers:
+  - codex-swarm
+  - 코덱스 스웜
+---
+
+# {{SKILL_NAME}} — DEPRECATED
+
+> **DEPRECATED:** 이 스킬은 `tfx-swarm`으로 통합되었습니다. `/tfx-swarm`을 사용하세요.
+> swarm-planner + swarm-hypervisor 파이프라인이 worktree/psmux/codex/원격 실행을 통합 관리합니다.
+
+이 스킬이 호출되면 자동으로 `/tfx-swarm`을 호출합니다.

package/skills/tfx-codex-swarm/evals/evals.json

@@ -23,4 +23,4 @@
       "files": []
     }
   ]
-}
+}

package/skills/tfx-codex-swarm/skill.json

@@ -1,8 +1,5 @@
 {
   "name": "tfx-codex-swarm",
   "description": "DEPRECATED — tfx-swarm으로 통합됨. 'codex swarm', '코덱스 스웜' 요청은 tfx-swarm이 처리.",
-  "triggers": [
-    "codex-swarm",
-    "코덱스 스웜"
-  ]
+  "triggers": ["codex-swarm", "코덱스 스웜"]
 }

package/skills/tfx-codex-swarm-workspace/iteration-1/benchmark.json

@@ -4,24 +4,66 @@
   "configurations": [
     {
       "name": "with_skill",
-      "pass_rate": {"mean": 1.0, "stddev": 0.0},
-      "total_tokens": {"mean": 30953, "stddev": 6089},
-      "duration_seconds": {"mean": 166.8, "stddev": 10.2},
+      "pass_rate": { "mean": 1.0, "stddev": 0.0 },
+      "total_tokens": { "mean": 30953, "stddev": 6089 },
+      "duration_seconds": { "mean": 166.8, "stddev": 10.2 },
       "per_eval": [
-        {"eval_name": "full-swarm-all-prds", "pass_rate": 1.0, "assertions_passed": 7, "assertions_total": 7, "tokens": 37789, "duration_s": 178.4},
-        {"eval_name": "selective-spawn-with-override", "pass_rate": 1.0, "assertions_passed": 4, "assertions_total": 4, "tokens": 29085, "duration_s": 163.1},
-        {"eval_name": "implicit-swarm-no-keywords", "pass_rate": 1.0, "assertions_passed": 5, "assertions_total": 5, "tokens": 25984, "duration_s": 158.8}
+        {
+          "eval_name": "full-swarm-all-prds",
+          "pass_rate": 1.0,
+          "assertions_passed": 7,
+          "assertions_total": 7,
+          "tokens": 37789,
+          "duration_s": 178.4
+        },
+        {
+          "eval_name": "selective-spawn-with-override",
+          "pass_rate": 1.0,
+          "assertions_passed": 4,
+          "assertions_total": 4,
+          "tokens": 29085,
+          "duration_s": 163.1
+        },
+        {
+          "eval_name": "implicit-swarm-no-keywords",
+          "pass_rate": 1.0,
+          "assertions_passed": 5,
+          "assertions_total": 5,
+          "tokens": 25984,
+          "duration_s": 158.8
+        }
       ]
     },
     {
       "name": "without_skill",
-      "pass_rate": {"mean": 0.875, "stddev": 0.144},
-      "total_tokens": {"mean": 53786, "stddev": 10873},
-      "duration_seconds": {"mean": 264.4, "stddev": 49.3},
+      "pass_rate": { "mean": 0.875, "stddev": 0.144 },
+      "total_tokens": { "mean": 53786, "stddev": 10873 },
+      "duration_seconds": { "mean": 264.4, "stddev": 49.3 },
       "per_eval": [
-        {"eval_name": "full-swarm-all-prds", "pass_rate": 1.0, "assertions_passed": 7, "assertions_total": 7, "tokens": 50555, "duration_s": 218.2},
-        {"eval_name": "selective-spawn-with-override", "pass_rate": 1.0, "assertions_passed": 4, "assertions_total": 4, "tokens": 65928, "duration_s": 259.5},
-        {"eval_name": "implicit-swarm-no-keywords", "pass_rate": 0.6, "assertions_passed": 3, "assertions_total": 5, "tokens": 44875, "duration_s": 315.5}
+        {
+          "eval_name": "full-swarm-all-prds",
+          "pass_rate": 1.0,
+          "assertions_passed": 7,
+          "assertions_total": 7,
+          "tokens": 50555,
+          "duration_s": 218.2
+        },
+        {
+          "eval_name": "selective-spawn-with-override",
+          "pass_rate": 1.0,
+          "assertions_passed": 4,
+          "assertions_total": 4,
+          "tokens": 65928,
+          "duration_s": 259.5
+        },
+        {
+          "eval_name": "implicit-swarm-no-keywords",
+          "pass_rate": 0.6,
+          "assertions_passed": 3,
+          "assertions_total": 5,
+          "tokens": 44875,
+          "duration_s": 315.5
+        }
       ]
     }
   ],

package/skills/tfx-codex-swarm-workspace/iteration-1/full-swarm-all-prds/with_skill/grading.json

@@ -1,11 +1,39 @@
 {
   "expectations": [
-    {"text": "all-7-prds-found", "passed": true, "evidence": "classification.md에 issue 24~30 모두 나열됨"},
-    {"text": "correct-type-classification", "passed": true, "evidence": "25,30=investigate, 24,26,27,28,29=implement 정확"},
-    {"text": "profile-routing-varies", "passed": true, "evidence": "implement→codex53_high, investigate→gpt54_high"},
-    {"text": "worktree-per-task", "passed": true, "evidence": "commands.sh에 git worktree add 7개 확인"},
-    {"text": "psmux-sessions", "passed": true, "evidence": "7개 psmux new-session + send-keys with codex"},
-    {"text": "single-wt-window", "passed": true, "evidence": "wt-new-window 1회 + wt-tab 6회"},
-    {"text": "omx-skill-mapping", "passed": true, "evidence": "implement=$plan→$autopilot, investigate=$plan"}
+    {
+      "text": "all-7-prds-found",
+      "passed": true,
+      "evidence": "classification.md에 issue 24~30 모두 나열됨"
+    },
+    {
+      "text": "correct-type-classification",
+      "passed": true,
+      "evidence": "25,30=investigate, 24,26,27,28,29=implement 정확"
+    },
+    {
+      "text": "profile-routing-varies",
+      "passed": true,
+      "evidence": "implement→codex53_high, investigate→gpt54_high"
+    },
+    {
+      "text": "worktree-per-task",
+      "passed": true,
+      "evidence": "commands.sh에 git worktree add 7개 확인"
+    },
+    {
+      "text": "psmux-sessions",
+      "passed": true,
+      "evidence": "7개 psmux new-session + send-keys with codex"
+    },
+    {
+      "text": "single-wt-window",
+      "passed": true,
+      "evidence": "wt-new-window 1회 + wt-tab 6회"
+    },
+    {
+      "text": "omx-skill-mapping",
+      "passed": true,
+      "evidence": "implement=$plan→$autopilot, investigate=$plan"
+    }
   ]
 }

package/skills/tfx-codex-swarm-workspace/iteration-1/full-swarm-all-prds/without_skill/grading.json

@@ -1,11 +1,39 @@
 {
   "expectations": [
-    {"text": "all-7-prds-found", "passed": true, "evidence": "7개 PRD 모두 발견 및 나열"},
-    {"text": "correct-type-classification", "passed": true, "evidence": "5 implement + 2 investigate 정확"},
-    {"text": "profile-routing-varies", "passed": true, "evidence": "codex53_high/gpt54_high 분리 적용"},
-    {"text": "worktree-per-task", "passed": true, "evidence": "7개 worktree 생성 명령 존재"},
-    {"text": "psmux-sessions", "passed": true, "evidence": "7개 psmux 세션 생성됨"},
-    {"text": "single-wt-window", "passed": true, "evidence": "WT 탭 attach 포함"},
-    {"text": "omx-skill-mapping", "passed": true, "evidence": "autopilot/plan 매핑 존재"}
+    {
+      "text": "all-7-prds-found",
+      "passed": true,
+      "evidence": "7개 PRD 모두 발견 및 나열"
+    },
+    {
+      "text": "correct-type-classification",
+      "passed": true,
+      "evidence": "5 implement + 2 investigate 정확"
+    },
+    {
+      "text": "profile-routing-varies",
+      "passed": true,
+      "evidence": "codex53_high/gpt54_high 분리 적용"
+    },
+    {
+      "text": "worktree-per-task",
+      "passed": true,
+      "evidence": "7개 worktree 생성 명령 존재"
+    },
+    {
+      "text": "psmux-sessions",
+      "passed": true,
+      "evidence": "7개 psmux 세션 생성됨"
+    },
+    {
+      "text": "single-wt-window",
+      "passed": true,
+      "evidence": "WT 탭 attach 포함"
+    },
+    {
+      "text": "omx-skill-mapping",
+      "passed": true,
+      "evidence": "autopilot/plan 매핑 존재"
+    }
   ]
 }

package/skills/tfx-codex-swarm-workspace/iteration-1/implicit-swarm-no-keywords/with_skill/grading.json

@@ -1,9 +1,29 @@
 {
   "expectations": [
-    {"text": "3-paths-recognized", "passed": true, "evidence": "auth-refactor, api-v2, cache-layer 모두 classification.md에 등장"},
-    {"text": "filename-classification", "passed": true, "evidence": "auth-refactor=리팩터링, api-v2=구현, cache-layer=구현"},
-    {"text": "profile-routing-applied", "passed": true, "evidence": "모두 codex53_high 라우팅"},
-    {"text": "worktree-isolation", "passed": true, "evidence": "3개 git worktree add 명령"},
-    {"text": "psmux-and-wt", "passed": true, "evidence": "psmux 세션 + WT 탭 명령 존재"}
+    {
+      "text": "3-paths-recognized",
+      "passed": true,
+      "evidence": "auth-refactor, api-v2, cache-layer 모두 classification.md에 등장"
+    },
+    {
+      "text": "filename-classification",
+      "passed": true,
+      "evidence": "auth-refactor=리팩터링, api-v2=구현, cache-layer=구현"
+    },
+    {
+      "text": "profile-routing-applied",
+      "passed": true,
+      "evidence": "모두 codex53_high 라우팅"
+    },
+    {
+      "text": "worktree-isolation",
+      "passed": true,
+      "evidence": "3개 git worktree add 명령"
+    },
+    {
+      "text": "psmux-and-wt",
+      "passed": true,
+      "evidence": "psmux 세션 + WT 탭 명령 존재"
+    }
   ]
 }

package/skills/tfx-codex-swarm-workspace/iteration-1/implicit-swarm-no-keywords/without_skill/grading.json

@@ -1,9 +1,29 @@
 {
   "expectations": [
-    {"text": "3-paths-recognized", "passed": true, "evidence": "3개 파일 경로 인식"},
-    {"text": "filename-classification", "passed": false, "evidence": "모두 implement로 평탄화, auth-refactor를 리팩터링으로 분류 실패"},
-    {"text": "profile-routing-applied", "passed": false, "evidence": "프로파일 라우팅 없음, 동일 설정 적용 또는 bare codex"},
-    {"text": "worktree-isolation", "passed": true, "evidence": "3개 worktree 생성 (시나리오 C)"},
-    {"text": "psmux-and-wt", "passed": true, "evidence": "psmux + WT 명령 존재 (시나리오 C)"}
+    {
+      "text": "3-paths-recognized",
+      "passed": true,
+      "evidence": "3개 파일 경로 인식"
+    },
+    {
+      "text": "filename-classification",
+      "passed": false,
+      "evidence": "모두 implement로 평탄화, auth-refactor를 리팩터링으로 분류 실패"
+    },
+    {
+      "text": "profile-routing-applied",
+      "passed": false,
+      "evidence": "프로파일 라우팅 없음, 동일 설정 적용 또는 bare codex"
+    },
+    {
+      "text": "worktree-isolation",
+      "passed": true,
+      "evidence": "3개 worktree 생성 (시나리오 C)"
+    },
+    {
+      "text": "psmux-and-wt",
+      "passed": true,
+      "evidence": "psmux + WT 명령 존재 (시나리오 C)"
+    }
   ]
 }

package/skills/tfx-codex-swarm-workspace/iteration-1/selective-spawn-with-override/with_skill/grading.json

@@ -1,8 +1,24 @@
 {
   "expectations": [
-    {"text": "only-2-selected", "passed": true, "evidence": "issue-24, issue-28만 존재, 다른 이슈 없음"},
-    {"text": "xhigh-override", "passed": true, "evidence": "codex53_xhigh, model_reasoning_effort=xhigh"},
-    {"text": "ralph-skill", "passed": true, "evidence": "프롬프트에 $ralph 참조, 반복 실행 지시"},
-    {"text": "worktree-2-only", "passed": true, "evidence": "git worktree add 2개만"}
+    {
+      "text": "only-2-selected",
+      "passed": true,
+      "evidence": "issue-24, issue-28만 존재, 다른 이슈 없음"
+    },
+    {
+      "text": "xhigh-override",
+      "passed": true,
+      "evidence": "codex53_xhigh, model_reasoning_effort=xhigh"
+    },
+    {
+      "text": "ralph-skill",
+      "passed": true,
+      "evidence": "프롬프트에 $ralph 참조, 반복 실행 지시"
+    },
+    {
+      "text": "worktree-2-only",
+      "passed": true,
+      "evidence": "git worktree add 2개만"
+    }
   ]
 }

package/skills/tfx-codex-swarm-workspace/iteration-1/selective-spawn-with-override/without_skill/grading.json

@@ -1,8 +1,20 @@
 {
   "expectations": [
-    {"text": "only-2-selected", "passed": true, "evidence": "24, 28만 선택됨"},
-    {"text": "xhigh-override", "passed": true, "evidence": "xhigh 적용, config.toml 프로파일 참조"},
-    {"text": "ralph-skill", "passed": true, "evidence": "$ralph 참조 존재"},
-    {"text": "worktree-2-only", "passed": true, "evidence": "2개 worktree (create-or-reuse 패턴)"}
+    {
+      "text": "only-2-selected",
+      "passed": true,
+      "evidence": "24, 28만 선택됨"
+    },
+    {
+      "text": "xhigh-override",
+      "passed": true,
+      "evidence": "xhigh 적용, config.toml 프로파일 참조"
+    },
+    { "text": "ralph-skill", "passed": true, "evidence": "$ralph 참조 존재" },
+    {
+      "text": "worktree-2-only",
+      "passed": true,
+      "evidence": "2개 worktree (create-or-reuse 패턴)"
+    }
   ]
 }