메뉴
gemini와 codex 두 agent를 parallel로 실행하여 편향 없는 다각도 분석. code review, documentation validation, architecture verification 등 프로젝트 전체 검증이 필요할 때 사용. 동일한 instruction을 두 agent에게 독립적으로 실행시켜 결과를 교차 검증.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | multi-agent-with-codex-gemini |
| description | gemini와 codex 두 agent를 parallel로 실행하여 편향 없는 다각도 분석. code review, documentation validation, architecture verification 등 프로젝트 전체 검증이 필요할 때 사용. 동일한 instruction을 두 agent에게 독립적으로 실행시켜 결과를 교차 검증. |
| version | 1.0.0 |
gemini와 codex를 parallel로 실행하여 single-agent bias 제거 및 diverse perspective 확보
& 사용 금지)동일한 분석 작업을 gemini와 codex에 독립적으로 실행 후 결과 aggregation
절대 규칙: Task tool로 3개 subagent를 병렬 실행해야 한다.
Bash로 직접 CLI를 호출하면 순차 실행된다!
main agent (Claude)
├─ Task 1 (parallel, run_in_background=true)
│ └─ Opus subagent: 직접 분석 수행
├─ Task 2 (parallel, run_in_background=true)
│ └─ subagent: Bash로 `codex exec "prompt"` 호출
└─ Task 3 (parallel, run_in_background=true)
└─ subagent: Bash로 `gemini -p "prompt"` 호출
→ 3개 완료 후, 필요시 main agent가 추가 검토
main agent (Claude)
├─ Bash: codex exec "prompt" ← 완료까지 대기
└─ Bash: gemini -p "prompt" ← 그 다음 실행
하나의 응답에서 Task tool 3개를 동시 호출한다:
Task 1 (Opus): subagent_type="general-purpose", run_in_background=true
Task 2 (Codex): subagent_type="general-purpose", run_in_background=true
codex exec with this prompt: [review instruction]"Task 3 (Gemini): subagent_type="general-purpose", run_in_background=true
gemini -p with this prompt: [review instruction]"핵심: 3개 Task를 한 번의 응답에서 동시에 호출 → 병렬 실행 → 완료 후 main agent가 결과 aggregation (필요시 추가 검토)
세 agent 모두 동일한 instruction 제공
[Task Description]
### 1. Context
- !git log --oneline -10
- !git diff --cached
- @README.md @todos/TODO_*.md
### 2. Exploration
- @component1/README.md @component2/README.md
- Explore beyond specified files to understand full project
### 3. Analysis Points
1. Issue Type A
2. Issue Type B
3. Issue Type C
### 4. Output
파일:라인 - 문제 유형 - 상세 설명
If no issues: "검토 완료: 이상 없음"
@path/to/file.md - file content include@./ - current directory include!git diff - shell command 실행세 agent의 결과를 비교하여 종합:
main agent가 한 번의 응답에서 3개 Task를 동시 호출:
Task 1 - Opus:
Task 2 - Codex:
Task 3 - Gemini:
→ 3개 완료 후 main agent가 결과 aggregation, 필요시 추가 검토
Review the implementation for Issue #22.
### Context
@README.md
@operator/README.md
!git log --oneline -10
!git diff HEAD~3..HEAD
### Check
1. Logic errors
2. Performance issues
3. Code vs documentation mismatch
### Output
파일:라인 - 문제 - 설명
If no issues: "검토 완료: 이상 없음"
gemini -p "Review README files for consistency.
### Check
1. Code vs doc mismatches
2. Broken links
3. 5W1H violations
### Files
@README.md @operator/README.md @client/README.md
Explore beyond these to understand full structure.
Output: 파일:라인 - 문제 - 설명"
codex exec "[... same prompt ...]"
gemini -p "Review recent changes.
### Context
!git log --oneline -10
!git diff HEAD~3..HEAD
### Check
- Logic errors
- Performance issues
- Anti-patterns
- Missing error handling
Output: 파일:라인 - 문제 - 설명"
codex exec "[... same prompt ...]"
gemini -p "Verify TrialBatch implementation.
### Background
@docs/done_TODO_2025-11-06_trialbatch-refactor-unified.md
### Check
1. @operator/README.md: incorrect status markers
2. @operator/internal/controller/trialbatch_controller.go: actual logic
3. Code vs doc mismatch
Output: 파일:라인 - 문제 - 설명"
codex exec "[... same prompt ...]"
TaskOutput tool로 모든 task 완료 대기 → 1번만 취합
block=true: task 완료까지 blocking 대기 (기본값)block=false: 즉시 현재 상태 반환 (non-blocking)timeout: 최대 대기 시간 (ms, 기본 30000, 최대 600000)3개 Task 실행 후, 3개 TaskOutput을 동시 호출:
Step 1: Task 3개 동시 실행 (run_in_background=true)
├─ Task 1 (Opus) → task_id_1 반환
├─ Task 2 (Codex) → task_id_2 반환
└─ Task 3 (Gemini) → task_id_3 반환
Step 2: TaskOutput 3개 동시 호출 (block=true)
├─ TaskOutput(task_id_1, block=true, timeout=600000)
├─ TaskOutput(task_id_2, block=true, timeout=600000)
└─ TaskOutput(task_id_3, block=true, timeout=600000)
→ 3개 모두 완료될 때까지 대기
Step 3: 결과 취합 (딱 1번만!)
→ 3개 결과를 한꺼번에 받아서 aggregation
# 잘못된 예시 1: sleep 사용
Bash: sleep 60 ← 불필요한 대기, 비효율적
# 잘못된 예시 2: 순차적 TaskOutput
TaskOutput(task_id_1) → 취합 ← 중간 취합 금지!
TaskOutput(task_id_2) → 취합 ← 중간 취합 금지!
TaskOutput(task_id_3) → 취합 ← 3번이나 취합함
# 올바른 예시: TaskOutput 3개 동시 호출
TaskOutput(task_id_1) ─┐
TaskOutput(task_id_2) ─┼→ 모두 완료 후 1번만 취합
TaskOutput(task_id_3) ─┘
timeout=600000 (10분)timeout=300000 (5분)사용자가 자동화하려는 작업을 Skill, Command, MCP, Subagent 중 적절한 도구로 분류하고 추천. 사용자가 "X 자동화 만들고 싶어", "이런 작업 자동화해줘", "도구 뭐 써야해?", "skill로 만들까 command로 만들까?" 같은 질문을 할 때 사용.
코드 작성/수정, 리팩토링 시 자동 활성화. Robert C. Martin Clean Code 원칙(명명, 함수 크기, 주석, 포맷팅, DRY, SRP) 검증 및 제안. 함수 20줄 초과, 인자 3개 초과, 중복 코드, 불명확한 변수명, 과도한 주석 발견 시 가독성 개선 방향 제시.
코드 작성/수정, 리팩토링, TODO 작성 시 자동 활성화. 복잡도 증가, 조건문 남발, 중복 코드 발견 시 적절한 디자인 패턴 제안. OO 설계 원칙(개방-폐쇄, 단일책임, 의존성역전) 위반 감지하고 Strategy, Observer, Decorator, Factory 등으로 리팩토링 방향 제시. 긴 if-else, switch문, 상속 남용, 새 기능 추가 시 기존 코드 수정 필요 등 code smell 발견 시 사용.
git bisect로 특정 코드가 추가/제거된 commit을 자동으로 찾기. file content 변경 시점, function 추가/제거, feature 도입 시점을 찾을 때 사용. binary search로 자동 검색하며 manual good/bad marking 불필요.
i18n 키 누락/미사용 자동 검증 skill. 코드에서 사용하는 키와 JSON 정의 간 불일치를 스크립트로 자동 감지. TypeScript 타입 안정성 확보, pre-push 훅 자동화 지원. Next.js (next-intl), React (react-i18next) 프로젝트에서 i18n 작업 시 자동 트리거.
GitLab/GitHub issue 정보를 glab/gh CLI로 가져오기. issue description, comments, 관련 MR/PR (description, comments, branch names), linked issues, parent epic 정보를 JSON 또는 markdown 형식으로 출력. issue 상세 정보가 필요할 때 사용.