VoltAgent/awesome-codex-subagents

이 프로젝트란?

awesome-codex-subagents는 OpenAI의 Codex 도구에 추가할 수 있는 175개 이상의 사전 구축 설정 파일(서브 에이전트라고 함) 모음입니다. 각 서브 에이전트는 백엔드 코드 작성, 보안 검토, Docker 설정 구축 등 특정 개발 작업에 특화된 전문 AI 어시스턴트입니다. 처음부터 시작하는 대신 이 파일들을 Codex 설정에 복사하고 필요할 때 호출하기만 하면 됩니다.

작동 방식

각 서브 에이전트는 TOML(간단한 구성 형식)로 작성된 텍스트 파일이며 다음을 포함합니다.

• 이름 – 에이전트를 부르는 이름.
• 설명 – 사용 시점.
• 모델 – 작업을 처리할 AI 모델(아래 참조).
• 샌드박스 모드 – 파일을 읽기만 할 수 있는지, 쓰기도 가능한지.
• 지침 – AI의 동작을 지시하는 상세 프롬프트(체크리스트, 패턴, 가이드라인 등).

서브 에이전트는 13개 카테고리로 구성됩니다. README에는 핵심 개발, 언어 전문가, 인프라, 품질 및 보안, 데이터 및 AI, 개발자 경험의 6개가 표시됩니다. 나머지는 이 발췌문에 나열되지 않았지만 모든 카테고리에서 175개 이상입니다.

주요 설계 선택

• 스마트 모델 라우팅 – 각 서브 에이전트는 작업의 복잡성에 따라 세 가지 AI 모델 중 하나가 할당됩니다.
  • gpt-5.6-sol – 심층 추론용(보안 감사 또는 아키텍처 검토 등).
  • gpt-5.6-terra – 구현 및 다단계 전문 작업용(테스트 또는 데이터 분석 등).
  • gpt-5.6-luna – 가벼운 작업용(검색, 추출, 초안 작성 등).
• 샌드박스 모드 – 검토자와 감사자는 read-only(파일 변경 없음), 개발자는 workspace-write(파일 생성/편집 가능)를 사용합니다.

설치 및 사용 방법

1. 리포지토리를 클론합니다.
2. 원하는 .toml 파일을 다음 중 하나에 복사합니다.
   • ~/.codex/agents/ – 서브 에이전트를 모든 프로젝트에서 사용할 수 있게 합니다(전역).
   • 특정 프로젝트 내의 .codex/agents/ – 해당 프로젝트에서만 사용할 수 있게 합니다(이름 충돌 시 우선).
3. Codex 세션을 다시 시작하거나 새로 고칩니다.
4. 서브 에이전트를 사용하려면 프롬프트에서 명시적으로 언급하세요. Codex는 자동으로 시작하지 않습니다.

복사 명령 예시:

mkdir -p ~/.codex/agents
cp categories/01-core-development/backend-developer.toml ~/.codex/agents/

중요성

자체 상세 AI 프롬프트를 처음부터 작성하는 대신, Codex 공식 문서에 부합하는 테스트된 작업별 프롬프트를 얻을 수 있습니다. 시간을 절약하고 일반적인 코딩 작업에 대해 세밀하게 조정된 동작을 제공합니다.