synod-setuplisted
Install: claude install-skill quantsquirrel/claude-synod-debate
# Synod Setup - 초기 설정 및 모델 가용성 테스트
## 설명
Synod를 처음 사용하기 전에 실행하는 초기 설정 ��구입니다. Python 의존성 설치, CLI 도구 구성, 로컬 세션/프록시 검증, 모델 테스트를 한 번에 처리합니다.
## 사용법
```bash
/synod-setup
```
옵션 없이 실행합니다.
## 동작 과정
### Step 0: Python 의존성 확인 및 설치
- `openai`, `httpx` 패키지 설치 여부 확인
- 미설치 시 `pip install --user`로 자동 설치
### Step 1: CLI 도구 설치
- `~/.synod/bin/` 디렉토리에 CLI 래퍼 스크립트 생성
- 대상: `gemini-3`, `openai-cli`, 은퇴한 브리지 `agy-cli`/`cliproxy-cli`, `synod-parser`, `synod-classifier` 등
- 기존에 `~/.local/bin/`에 설치된 경우에도 정상 작동 (하위 호환)
### Step 2: API 키 확인
- `GEMINI_API_KEY` 확인 (`GOOGLE_API_KEY`도 인정) — `pro-latest` = Gemini 3.1 Pro 호출
- `OPENAI_API_KEY` 확인 — `gpt56sol` = gpt-5.6-sol 호출
- 해석 순서: 환경변수 → `~/.synod/.env` → macOS Keychain
### Step 3: MCP 라우팅 호환성 확인
- 사용자의 `~/.claude/CLAUDE.md`에 `CODEX-ROUTING` 또는 `ask_codex`/`ask_gemini` MCP 라우팅 규칙이 포함되어 있는지 확인
- 감지 시 안내 메시지 표시:
- "⚠ MCP 라우팅 감지: Synod는 CLI 실행만 사용합니다. MCP 라우팅이 활성화된 환경에서도 allowed-tools 및 내장 guard 지시문으로 보호됩니다."
- 결과를 `setup-result.json`의 `mcp_routing_detected` 필드에 저장
### Step 4: 모델 응답 시간 테스트
간단한 테스트 프롬프트를 각 모델에 전송하여 응답 시간을 측정합니다.
- 타임아웃: 120초
- 테스트 프롬프트: "Explain the SOLID principles in 3 sentences."
## 출력 형식
테스트 결과는 테이블 형태로 표시되며, 각 모델의 상태를 다음과 같이 분류합니다:
| 상태 | 설명 | 응답 시간 |
|------|------|-----------|
| **recommended** | 권장 사용 | < 10초 |
| **usable** | 사용 가능 | 10초 ~ 60초 |
| **slow** | 느림 (비권장) | 60초 ~ 120초 |
| **timeout** | 타임아웃 | > 120초 |
| **failed** | 실패 (API 키/권한 오류) | - |
## 결과 파일
테스트 결과는 다음 위치에 JSON 형식으로 저장됩니다:
```
~/.synod/setup-re