| name | cross-agent-bridge |
| description | Claude Code, Codex CLI, Gemini CLI/SDK를 하나의 CLI로 오케스트레이션할 때 사용한다. 에이전트 간 리뷰 요청(review/codex-review), 출력 파싱(parse), 환경 진단(doctor), 초기 설정(setup)이 필요할 때 트리거한다. 단일 스킬 설치로 상호 피드백 워크플로우를 재사용할 수 있다. |
Cross Agent Bridge
에이전트 협업을 위한 workflow owner. review, parse, context dispatch의 통합 진입점.
This skill is the family owner
이 skill은 cross-agent family의 orchestrator입니다. 개별 에이전트를 직접 호출하기 전에 이 skill을 먼저 사용하세요.
Specialist delegates
| Task | Delegate | When to use directly |
|---|
| Codex/Gemini/Claude 출력 파싱 | agent-parser | parse-only, bridge.py 없이 scripts/parse.py 직접 호출할 때 |
| Gemini SDK/CLI 리뷰 호출 | gemini-reviewer | Gemini review-only, bridge.py 없이 scripts/evaluate.py 직접 호출할 때 |
| Gemini CLI 비대화형 실행 | gemini-cli-context | raw Gemini CLI execution, bridge.py 우회하고 run_gemini_cli.sh 직접 호출할 때 |
| Codex CLI 비대화형 실행 | codex-user-context | raw Codex CLI execution, bridge.py 우회하고 run_codex_user_context.sh 직접 호출할 때 |
원칙: full workflow (setup → doctor → review/parse → save)가 필요하면 이 skill을 사용. 단일 atomic 작업만 필요하면 delegate를 직접 호출해도 됨.
When to use
Use it when:
- 에이전트 간 리뷰 요청/결과 수집이 필요할 때
- 환경 진단(doctor)이나 초기 설정(setup)이 필요할 때
- review → parse → save 전체 워크플로우를 실행할 때
- 어떤 에이전트를 쓸지 판단이 필요할 때
Do not use it for:
- parse-only →
agent-parser 직접 사용
- Gemini review-only →
gemini-reviewer 직접 사용
- raw CLI execution만 →
gemini-cli-context 또는 codex-user-context 직접 사용
Workflow
setup으로 기본 config/config.json과 .env 템플릿을 준비한다.
doctor로 API key, SDK, CLI, 피드백 파일 상태를 점검한다.
review로 Gemini 리뷰를 호출하거나 codex-review로 Codex 리뷰를 호출한다.
parse로 Codex JSONL / Gemini JSON / Claude transcript를 자동 감지해 요약한다.
- 필요 시
--save로 gemini_feedback.md에 결과를 append한다.
Commands
python3 scripts/bridge.py setup
python3 scripts/bridge.py doctor
python3 scripts/bridge.py review --file README.md --format json
python3 scripts/bridge.py codex-review --file README.md --model gpt-5 --format json
python3 scripts/bridge.py parse --file output.jsonl --agent auto --format summary
Requirements
- Python 3.10+
- Gemini 경로:
google-genai + GEMINI_API_KEY 또는 gemini CLI
- Codex 경로:
codex CLI 로그인 상태