cx-skills 1.0.0 → 1.3.0

package/README.ko.md

@@ -23,6 +23,14 @@
 npm install -g cx-skills
 ```
 
+### 설치 스코프
+
+| 스코프 | 플러그인 설치 | npm 설치 | 적용 범위 |
+|--------|-------------|----------|----------|
+| **유저** (기본값) | `/plugin install cx-skills` | `npm install -g cx-skills` | 모든 프로젝트 |
+| **프로젝트** | `/plugin install cx-skills --scope project` | `npm install cx-skills` | 현재 프로젝트만 |
+| **일회성** | — | `npx cx-skills doctor` | 설치 없이 실행 |
+
 **Step 2: 사용**
 ```bash
 # 자동 모드 — AI가 분류 + 분해

package/README.md

@@ -25,6 +25,14 @@
 npm install -g cx-skills
 ```
 
+### Installation Scope
+
+| Scope | Plugin | npm | Applies To |
+|-------|--------|-----|------------|
+| **User** (default) | `/plugin install cx-skills` | `npm install -g cx-skills` | All projects |
+| **Project** | `/plugin install cx-skills --scope project` | `npm install cx-skills` | Current project only |
+| **One-off** | — | `npx cx-skills doctor` | Run without installing |
+
 **Step 2: Use**
 ```bash
 # Auto mode — AI classifies + decomposes

package/bin/cx-skills.mjs

@@ -1,6 +1,6 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 // cx-skills CLI — setup, doctor, version
-import { copyFileSync, existsSync, readFileSync, mkdirSync, chmodSync } from "fs";
+import { copyFileSync, existsSync, readFileSync, mkdirSync, chmodSync, readdirSync } from "fs";
 import { join, dirname } from "path";
 import { homedir } from "os";
 import { execSync } from "child_process";
@@ -89,6 +89,40 @@ function cmdSetup() {
     "hud-qos-status.mjs"
   );
 
+  // 스킬 동기화 (~/.claude/skills/{name}/SKILL.md)
+  const skillsSrc = join(PKG_ROOT, "skills");
+  const skillsDst = join(CLAUDE_DIR, "skills");
+  if (existsSync(skillsSrc)) {
+    let skillCount = 0;
+    let skillTotal = 0;
+    for (const name of readdirSync(skillsSrc)) {
+      const src = join(skillsSrc, name, "SKILL.md");
+      const dst = join(skillsDst, name, "SKILL.md");
+      if (!existsSync(src)) continue;
+      skillTotal++;
+
+      const dstDir = dirname(dst);
+      if (!existsSync(dstDir)) mkdirSync(dstDir, { recursive: true });
+
+      if (!existsSync(dst)) {
+        copyFileSync(src, dst);
+        skillCount++;
+      } else {
+        const srcContent = readFileSync(src, "utf8");
+        const dstContent = readFileSync(dst, "utf8");
+        if (srcContent !== dstContent) {
+          copyFileSync(src, dst);
+          skillCount++;
+        }
+      }
+    }
+    if (skillCount > 0) {
+      ok(`스킬: ${skillCount}/${skillTotal}개 업데이트됨`);
+    } else {
+      ok(`스킬: ${skillTotal}개 최신 상태`);
+    }
+  }
+
   console.log(`\n${DIM}설치 위치: ${CLAUDE_DIR}${RESET}\n`);
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cx-skills",
-  "version": "1.0.0",
+  "version": "1.3.0",
   "description": "CLI-first multi-model orchestrator for Claude Code — route tasks to Codex, Gemini, and Claude",
   "type": "module",
   "bin": {
@@ -9,6 +9,7 @@
   "files": [
     "bin",
     "skills",
+    "!**/failure-reports",
     "scripts",
     "hooks",
     "hud",

package/scripts/cli-route.sh

@@ -3,7 +3,8 @@
 # v1.0: 기본 라우팅 (Codex/Gemini/Claude 분기)
 # v1.1: stderr 분리, 출력 필터링, 타임아웃, MCP 프로필 지원
 # v1.2: effort 동적 라우팅, bg/fg 모드, Opus 직접 수행, Gemini 모델 분기, 실행 로그
-VERSION="1.2"
+# v1.3: architect/critic Codex 이관, 리뷰어 exec review 전환, multi_agent 활성화
+VERSION="1.3"
 #
 # 설치: cp scripts/cli-route.sh ~/.claude/scripts/cli-route.sh
 #
@@ -24,6 +25,10 @@ PROMPT="${2:?프롬프트 필수}"
 MCP_PROFILE="${3:-auto}"
 USER_TIMEOUT="${4:-}"
 
+# ── CLI 경로 해석 (Windows npm global 대응) ──
+CODEX_BIN="${CODEX_BIN:-$(command -v codex 2>/dev/null || echo codex)}"
+GEMINI_BIN="${GEMINI_BIN:-$(command -v gemini 2>/dev/null || echo gemini)}"
+
 # ── 상수 ──
 MAX_STDOUT_BYTES=51200  # 50KB — Claude 컨텍스트 절약
 TIMESTAMP=$(date +%s)
@@ -46,13 +51,13 @@ route_agent() {
   case "$agent" in
     # ─── 구현 레인 ───
 
-    # Codex — 코드 구현 (effort: high, 300s, fg — 후속 태스크가 의존)
+    # Codex — 코드 구현 (effort: high, 360s, fg — 후속 태스크가 의존)
     executor)
       CLI_TYPE="codex"
       CLI_CMD="codex"
       CLI_ARGS="exec ${codex_base}"
       CLI_EFFORT="high"
-      DEFAULT_TIMEOUT=300
+      DEFAULT_TIMEOUT=360
       RUN_MODE="fg"
       OPUS_OVERSIGHT="false"
       ;;
@@ -82,22 +87,22 @@ route_agent() {
       CLI_CMD="codex"
       CLI_ARGS="--profile xhigh exec ${codex_base}"
       CLI_EFFORT="xhigh"
-      DEFAULT_TIMEOUT=900
+      DEFAULT_TIMEOUT=1200
       RUN_MODE="bg"
       OPUS_OVERSIGHT="true"
       ;;
 
     # ─── 설계/분석 레인 ───
 
-    # Claude Opus — 아키텍처 (직접 수행 — 설계 품질이 전체 좌우)
+    # Codex — 아키텍처 (effort: xhigh, 900s, bg — Opus가 설계 품질 검증)
     architect)
-      CLI_TYPE="claude-native"
-      CLI_CMD=""
-      CLI_ARGS=""
-      CLI_EFFORT="opus"
-      DEFAULT_TIMEOUT=900
+      CLI_TYPE="codex"
+      CLI_CMD="codex"
+      CLI_ARGS="--profile xhigh exec ${codex_base}"
+      CLI_EFFORT="xhigh"
+      DEFAULT_TIMEOUT=1200
       RUN_MODE="bg"
-      OPUS_OVERSIGHT="false"
+      OPUS_OVERSIGHT="true"
       ;;
     # Codex — 태스크 분해 (effort: xhigh, 900s, fg — Opus가 검증)
     planner)
@@ -105,19 +110,19 @@ route_agent() {
       CLI_CMD="codex"
       CLI_ARGS="--profile xhigh exec ${codex_base}"
       CLI_EFFORT="xhigh"
-      DEFAULT_TIMEOUT=900
+      DEFAULT_TIMEOUT=1200
       RUN_MODE="fg"
       OPUS_OVERSIGHT="true"
       ;;
-    # Claude Opus — 비판적 검토 (직접 수행 — 비판은 최고 모델이 해야 의미)
+    # Codex — 비판적 검토 (effort: xhigh, 900s, bg — Opus가 비판 품질 검증)
     critic)
-      CLI_TYPE="claude-native"
-      CLI_CMD=""
-      CLI_ARGS=""
-      CLI_EFFORT="opus"
-      DEFAULT_TIMEOUT=900
+      CLI_TYPE="codex"
+      CLI_CMD="codex"
+      CLI_ARGS="--profile xhigh exec ${codex_base}"
+      CLI_EFFORT="xhigh"
+      DEFAULT_TIMEOUT=1200
       RUN_MODE="bg"
-      OPUS_OVERSIGHT="false"
+      OPUS_OVERSIGHT="true"
       ;;
     # Codex — 요구사항 분석 (effort: xhigh, 900s, fg — Opus가 검증)
     analyst)
@@ -125,38 +130,38 @@ route_agent() {
       CLI_CMD="codex"
       CLI_ARGS="--profile xhigh exec ${codex_base}"
       CLI_EFFORT="xhigh"
-      DEFAULT_TIMEOUT=900
+      DEFAULT_TIMEOUT=1200
       RUN_MODE="fg"
       OPUS_OVERSIGHT="true"
       ;;
 
     # ─── 리뷰 레인 ───
 
-    # Codex — 코드 리뷰 (effort: thorough, 600s, bg — 병렬 리뷰)
+    # Codex — 코드 리뷰 (exec review, effort: thorough, 600s, bg — 전용 리뷰 커맨드)
     code-reviewer)
       CLI_TYPE="codex"
       CLI_CMD="codex"
-      CLI_ARGS="--profile thorough exec ${codex_base}"
+      CLI_ARGS="--profile thorough exec ${codex_base} review"
       CLI_EFFORT="thorough"
       DEFAULT_TIMEOUT=600
       RUN_MODE="bg"
       OPUS_OVERSIGHT="false"
       ;;
-    # Codex — 보안 리뷰 (effort: thorough, 600s, bg — Opus 검증 권장)
+    # Codex — 보안 리뷰 (exec review, effort: thorough, 600s, bg — Opus 검증 권장)
     security-reviewer)
       CLI_TYPE="codex"
       CLI_CMD="codex"
-      CLI_ARGS="--profile thorough exec ${codex_base}"
+      CLI_ARGS="--profile thorough exec ${codex_base} review"
       CLI_EFFORT="thorough"
       DEFAULT_TIMEOUT=600
       RUN_MODE="bg"
       OPUS_OVERSIGHT="true"
       ;;
-    # Codex — 품질 리뷰 (effort: thorough, 600s, bg — 병렬 리뷰)
+    # Codex — 품질 리뷰 (exec review, effort: thorough, 600s, bg — 전용 리뷰 커맨드)
     quality-reviewer)
       CLI_TYPE="codex"
       CLI_CMD="codex"
-      CLI_ARGS="--profile thorough exec ${codex_base}"
+      CLI_ARGS="--profile thorough exec ${codex_base} review"
       CLI_EFFORT="thorough"
       DEFAULT_TIMEOUT=600
       RUN_MODE="bg"
@@ -165,23 +170,33 @@ route_agent() {
 
     # ─── 리서치 레인 ───
 
-    # Codex — 데이터/리서치 (effort: thorough, 900s, bg — 웹 검색 폴백 체인)
+    # Codex — 일반 리서치 (effort: high, 480s, bg — 빠른 검색+요약)
     scientist)
+      CLI_TYPE="codex"
+      CLI_CMD="codex"
+      CLI_ARGS="exec ${codex_base}"
+      CLI_EFFORT="high"
+      DEFAULT_TIMEOUT=480
+      RUN_MODE="bg"
+      OPUS_OVERSIGHT="false"
+      ;;
+    # Codex — 심층 리서치 (effort: thorough, 1200s, bg — 논문 심층 분석)
+    scientist-deep)
       CLI_TYPE="codex"
       CLI_CMD="codex"
       CLI_ARGS="--profile thorough exec ${codex_base}"
       CLI_EFFORT="thorough"
-      DEFAULT_TIMEOUT=900
+      DEFAULT_TIMEOUT=1200
       RUN_MODE="bg"
       OPUS_OVERSIGHT="false"
       ;;
-    # Codex — 문서 조사 (effort: high, 900s, bg — 웹 검색 폴백 체인)
+    # Codex — 문서 조사 (effort: high, 480s, bg — 웹 검색 폴백 체인)
     document-specialist)
       CLI_TYPE="codex"
       CLI_CMD="codex"
       CLI_ARGS="exec ${codex_base}"
       CLI_EFFORT="high"
-      DEFAULT_TIMEOUT=900
+      DEFAULT_TIMEOUT=480
       RUN_MODE="bg"
       OPUS_OVERSIGHT="false"
       ;;
@@ -311,7 +326,7 @@ get_mcp_hint() {
       echo "context7으로 라이브러리 문서를 조회하세요. 웹 검색이 필요하면 brave-search를 우선 사용하고, 실패 시 exa를 시도하세요. exa/tavily가 402 에러를 반환하면 즉시 brave-search로 전환하세요."
       ;;
     analyze)
-      echo "context7으로 관련 문서를 조회하세요. 웹 검색은 다음 우선순위로 사용: 1) brave-search (무료, 우선), 2) tavily (실패 시), 3) exa (최후 수단). 402 에러 발생 시 해당 도구를 재시도하지 말고 즉시 다음 도구로 전환하세요. 모든 검색 도구가 실패하면 playwright로 직접 웹페이지를 방문하여 정보를 수집하세요."
+      echo "context7으로 관련 문서를 조회하세요. 웹 검색은 다음 우선순위로 사용: 1) brave-search (무료, 우선), 2) tavily (실패 시), 3) exa (최후 수단). 402 에러 발생 시 해당 도구를 재시도하지 말고 즉시 다음 도구로 전환하세요. 모든 검색 도구가 실패하면 playwright로 직접 웹페이지를 방문하여 정보를 수집하세요. 주의: URL 크롤링은 최대 3개까지만. 논문 전문 대신 제목/초록/핵심 수치만 정리하세요. 검색 깊이를 제한하고 결과를 빠르게 요약하세요."
       ;;
     review)
       echo "sequential-thinking으로 체계적으로 분석하세요."
@@ -407,6 +422,12 @@ truncate_output() {
 main() {
   route_agent "$AGENT_TYPE"
 
+  # CLI 경로 해석 (bare command → 절대경로)
+  case "$CLI_CMD" in
+    codex) CLI_CMD="$CODEX_BIN" ;;
+    gemini) CLI_CMD="$GEMINI_BIN" ;;
+  esac
+
   # 사용자 지정 타임아웃이 없으면 에이전트별 기본값 사용
   if [[ -n "$USER_TIMEOUT" ]]; then
     TIMEOUT_SEC="$USER_TIMEOUT"
@@ -430,7 +451,6 @@ main() {
     # 에이전트별 모델 결정
     local model="sonnet"
     case "$AGENT_TYPE" in
-      architect|critic) model="opus" ;;
       explore) model="haiku" ;;
       verifier|test-engineer|qa-tester) model="sonnet" ;;
     esac