Jakeschincariol/arena-skill

Arena 스킬 – 더 나은 답변을 위한 Claude-code 토너먼트

기능 설명

• 이 스킬은 동일한 프롬프트에 대해 여러 개의 Claude 하위 에이전트를 토너먼트 형태로 실행할 수 있습니다. 각 하위 에이전트는 동일한 작업을 수행하지만, 서로 다른 "전략 카드"(추론 모드, 워크플로우, 전략)를 부여받습니다. 이후 이들은 공격, 방어, 그리고 서로를 평가하며, 결국 하나의 답변만 남을 때까지 진행됩니다.
• 최종 출력은 생존한 답변과 그가 견뎌낸 공격, 사용한 카드, 그리고 몇 라운드를 거쳤는지 포함합니다.

왜 존재하는가

• Claude는 때때로 만족스럽지 않은 답변을 줄 수 있습니다. 다양한 추론 방식을 가진 여러 변형을 생성함으로써, 프롬프트를 반복해서 수정하지 않고도 더 견고하고 완전한 답변을 도출하고자 합니다.

사용 방법

1. Claude Code에 스킬을 설치합니다 (arena 폴더를 ~/.claude/skills/에 복사하거나 플러그인으로 추가).
2. 슬래시 명령어를 실행합니다. 예시:

   /arena --agents 32 fix the flaky test in tests/test_api.py
   

   • --agents N은 경쟁자 수를 설정합니다 (기본값 100).
   • --quick는 일상 사용을 위한 작은 16에이전트 토너먼트를 실행합니다.
   • --seed S는 카드 배분을 결정론적으로 만듭니다.
   • --wave W는 동시에 시작되는 하위 에이전트 수를 변경합니다.
3. 스킬은 숨겨진 .arena/ 디렉터리를 생성하고, 각 하위 에이전트의 작업을 JSON 파일에 기록하며, 순수 Python 스크립트인 bracket.py 상태 기계를 사용해 토너먼트를 조율합니다.
4. 토너먼트 종료 시, 승리한 답변과 간단한 보고서를 받게 됩니다.

핵심 구성 요소

• bracket.py – 토너먼트 트리, 에이전트 쌍, 공격 기록, 승자 결정을 추적하는 표준 라이브러리 Python 스크립트.
• strategies.json – 15개의 추론 모드, 12개의 워크플로우, 12개의 전략 (총 2,160개의 고유 카드 가능). 딜러는 중복 없이 카드를 배분합니다.
• rubric.md – 평가 에이전트가 사용하는 평가 기준 (정확성, 완전성, 견고성, 구체성, 명확성).
• 테스트 – 모의 하위 에이전트를 사용해 100에이전트 토너먼트를 완전히 실행하는 유닛 테스트 스위트로, 브래킷 로직을 검증합니다.

비용

• 스킬 자체는 무료이며 MIT 라이선스입니다. 모든 하위 에이전트 호출에 대해 Claude 토큰 사용료가 발생합니다 (예: 100에이전트 전체 실행 시 595회 호출). --quick 또는 에이전트 수를 줄여 비용을 낮출 수 있습니다.

제한 사항

• Claude Code 내부에서만 작동합니다. 하위 에이전트를 생성하기 위해 Agent 툴에 의존하기 때문입니다.
• Claude Code의 동시성 제한(기본값 10개 동시 도구 호출)을 초과한 병렬 처리는 불가능합니다. 더 큰 웨이브를 사용하려면 CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY를 높여야 합니다.
• 토너먼트는 프로젝트 파일에 접근하지 않습니다. 모든 중간 데이터는 .arena/에 저장됩니다.
• 최종 답변은 가장 많이 생존한 답변이지만, 정확성 보장은 아닙니다.

제작자

• Jake Schincariol (opusjake.ai)

라이선스

• MIT – 수정 및 재배포 가능합니다.

---

Arena 스킬은 진정한, Claude 중심의 AI 에이전트 오케스트레이션 도구로, 병렬적인 추론 경로를 활용하여 답변 품질을 향상시킬 수 있습니다.