name: multi-ai-review
description: Claude + Gemini CLI + Codex CLI 멀티-AI 리뷰. 3단계 파이프라인으로 Initial Opinions → Cross-Review → Chairman Synthesis 수행. CLI 방식으로 추가 API 비용 없이 실행.
trigger: "council 소집", "여러 AI 의견 물어봐", "심층 리뷰", "컨센서스 리뷰"
version: 3.3.0
updated: 2026-03-07

Multi-AI Review 스킬 (CLI 기반)

🔥 Heavy-Hitter (즉시 실행)

"리뷰해줘" | "council 소집해줘" | "여러 AI 의견 들어보자"

3-Stage Pipeline: Initial Opinions (병렬) → Cross-Review (반박) → Chairman Synthesis (종합)
비용: CLI 구독 플랜만으로 실행 (추가 API 비용 없음)

v3.3.0: Chairman Protocol - 미해결 쟁점 시 추가 Cross-Review 라운드 자동 판단
v3.2.0: Cross-Review 자동화 - Stage 2에서 멤버 간 상호 비평 자동 실행
v3.1.0: Long Context 최적화 - H2O 패턴으로 핵심 정보 상단 배치
v3.0.0: MCP 의존성 제거, agent-council 패턴 적용, CLI 직접 호출

⚡ Quick Start (최우선)

사용법

# 스킬 호출 (호스트 에이전트)
"리뷰해줘" | "council 소집해줘" | "Gemini랑 Codex 의견 들어보자"

# 스크립트 직접 실행
./skills/multi-ai-review/scripts/council.sh "리뷰 요청 내용"

전제 조건

command -v claude  # Claude Code (호스트) ✅
command -v gemini  # Gemini CLI (선택사항)
command -v codex   # Codex CLI (선택사항)

개요

Claude(오케스트레이터) + Gemini CLI + Codex CLI가 완전 자동화된 리뷰를 수행합니다.

3-Stage Pipeline

Stage 1: Initial Opinions (병렬 실행)
├── Gemini CLI → opinion.md (창의적 관점)
└── Codex CLI → opinion.md (기술적 관점)

Stage 2: Cross-Review (반박 단계)
├── Gemini가 Codex 의견 검토
└── Codex가 Gemini 의견 검토

Stage 3: Chairman Synthesis (의장 종합)
└── Claude가 모든 의견 종합 → 추가 리뷰 진행 여부 검토 → (Yes)추가 리뷰 진행, (No)최종 리포트

CLI 요구사항

# CLI 설치 확인
command -v claude  # Claude Code (호스트)
command -v gemini  # Gemini CLI
command -v codex   # Codex CLI

# 설치 방법
# Gemini CLI: https://github.com/google-gemini/gemini-cli
# Codex CLI: https://github.com/openai/codex

사용법

호스트 에이전트를 통한 사용

"리뷰해줘"
"council 소집해줘"
"여러 AI 의견 물어봐"
"Gemini랑 Codex 의견 들어보자"

스크립트 직접 실행

# 원샷 실행
JOB_DIR=$(./skills/multi-ai-review/scripts/council.sh start "리뷰 요청 내용")
./skills/multi-ai-review/scripts/council.sh wait "$JOB_DIR"
./skills/multi-ai-review/scripts/council.sh results "$JOB_DIR"
./skills/multi-ai-review/scripts/council.sh clean "$JOB_DIR"

# 또는 간단히
./skills/multi-ai-review/scripts/council.sh "리뷰 요청 내용"

수동 정리 (Cleanup)

# 고아 프로세스/잡 디렉토리 정리
./skills/multi-ai-review/scripts/cleanup.sh

자동 정리: council.sh 실행 시 자동으로 1시간 이상 된 고아 잭을 정리합니다.

설정 파일

council.config.yaml에서 멤버 구성:

council:
    members:
        - name: gemini
          command: "gemini"
          emoji: "💎"
          color: "GREEN"

        - name: codex
          command: "codex exec"
          emoji: "🤖"
          color: "BLUE"

    chairman:
        role: "auto" # 호스트 CLI 자동 감지
        description: "모든 의견을 종합하여 최종 추천 제시"

    settings:
        timeout: 120
        exclude_chairman_from_members: true

리뷰 유형

실행 흐름

1. CLI 존재 확인: command -v로 각 CLI 설치 여부 검증
2. 멤버 필터링: 설치된 CLI만 members에 포함
3. 병렬 실행: 각 멤버에게 동시에 리뷰 요청
4. 결과 수집: 응답을 포맷팅하여 표시
5. 의장 종합: Claude가 최종 판정 및 리포트 생성

🎯 Chairman Protocol (Stage 3 — 필수 준수)

Stage 1 + Stage 2 결과를 받은 후, Chairman(Claude)은 다음 프로토콜을 따른다:

Step 1: 합의 평가

Cross-Review 결과를 분석하여 다음을 판단:

• 합의 도달: 멤버들이 대체로 동의하거나, 이견이 있어도 명확히 정리됨
• 미해결 쟁점: 핵심 이슈에 대해 상반된 의견이 충돌하며 추가 논의 필요

Step 2: 추가 라운드 결정

IF 미해결 쟁점 존재 AND 추가 논의가 가치 있음:
    → 추가 Cross-Review 실행 (최대 2회까지)
    → 쟁점을 명확히 한 focused question으로 재질의
ELSE:
    → 최종 종합으로 진행

Step 3: 추가 Cross-Review 실행 (필요시)

# JOB_DIR은 이전 Stage의 디렉토리
./skills/multi-ai-review/scripts/council.sh cross-review "$JOB_DIR"

Focused Question 예시:

"A는 X 접근법을, B는 Y 접근법을 주장합니다. 각각의 trade-off를 구체적으로 비교하고, 프로덕션 환경에서 어떤 것이 더 적합한지 근거를 제시하세요."

Step 4: 최종 종합

모든 라운드 완료 후, 다음 형식으로 한국어로 종합:

## 🏛️ Chairman's Synthesis

### 핵심 결론

[1-2문장 요약]

### 합의 사항

- [멤버들이 동의한 포인트들]

### 이견 및 해소

- [쟁점] → [Chairman 판단 + 근거]

### 권고 사항

1. [우선순위 높은 액션]
2. [추가 고려사항]

### 리뷰 메타

- Rounds: [Stage 1 + Cross-Review 횟수]
- Consensus Level: [Strong/Moderate/Divergent]

제약 조건

• 최대 라운드: Cross-Review는 최대 3회 (Stage 2 + 추가 2회)
• 추가 라운드 기준: 단순 의견 차이가 아닌, 결정에 영향을 주는 핵심 쟁점만
• 무한 루프 방지: 3회 후에도 미해결이면 "의견 분분" 으로 정리하고 Chairman 판단 제시

파일 구조

skills/multi-ai-review/
├── SKILL.md                    # 이 파일
├── council.config.yaml         # 멤버 설정
├── scripts/
│   ├── council.sh              # 메인 실행 스크립트
│   ├── council-job.sh          # Job runner
│   ├── council-job.js          # Job 구현
│   └── council-job-worker.js   # 멤버별 워커
├── templates/
│   ├── review-prompt.md        # 리뷰 프롬프트 템플릿
│   └── report.md               # 최종 리포트 템플릿
└── references/
    ├── overview.md             # 상세 개요
    ├── config.md               # 설정 가이드
    ├── examples.md             # 사용 예시
    └── requirements.md         # 요구사항

참조

• references/overview.md — 워크플로우 상세
• references/config.md — 멤버 설정 가이드
• references/examples.md — 사용 예시
• ../agent-council-overview.md — agent-council 원본 참조