TL;DR

이 패키지는 Claude Code용 Academic Research Skills(ARS)를 Codex에 맞춰 단일 스킬로 번들링하여 연구 기획·문헌 검토·원고 작성·동료 검토·실험 설계 워크플로를 한 번의 설치로 제공한다. 내부적으로 vendored upstream 콘텐츠와 분리된 패키지 버전(VERSION, manifest의 adapter_version)을 함께 배포하며 Codex 어댑터가 사용자 프롬프트를 다섯 개의 워크플로로 라우팅하고 role/phase prompts를 사용해 단계별 작업을 수행한다. 추가로 optional full-runtime adapter와 planner 템플릿을 codex/에 포함하되 기본 비활성화 상태로 제공하고, 교차 모델 검증은 명시적 제공자 설정과 사용자 동의가 있을 때만 외부 호출을 허용하도록 설계되어 보안·무결성 경계를 유지한다.

주요 기능

• 프롬프트를 다섯 개의 ARS 워크플로(deep-research, academic-paper, academic-paper-reviewer, academic-pipeline, experiment-agent)로 라우팅한다.
• Claude Code용 ARS 콘텐트를 vendoring하여 Codex 스킬 레이아웃으로 패키지화하고 버전·매니페스트를 분리 관리한다.
• /ars-* 명령 의도는 단일 $academic-research-suite 스킬 내의 aliases로 에뮬레이션되어 Codex에서 동일한 워크플로 접근을 가능하게 한다.
• 옵션인 full-runtime adapter 프로파일과 planner·agent-team 템플릿을 codex/ 경로에 포함하되 기본적으로 비활성화 상태로 둔다.
• 교차 모델 검증은 명시적 제공자 구성과 사용자 동의가 있을 때만 외부 API로 호출되도록 안전 경계를 유지한다.

어떻게 동작하는가

사용자 프롬프트는 Codex 어댑터가 $academic-research-suite 스킬로 라우팅하고 내부 매니페스트와 SKILL.md에 정의된 역할·단계를 따라 적절한 워크플로에 배분된다. 패키지는 upstream ARS 콘텐츠를 vendoring 방식으로 포함하여 role/phase prompts, 명령 레시피, 검사 관문과 같은 실행 자료를 그대로 보존하며 선택적 full-runtime adapter를 통해 planner와 agent-team 템플릿을 제공한다. 교차 모델 호출과 민감한 도구 접근은 명시적 설정과 사용자 동의를 필요로 하여 least-privilege 원칙을 유지한다.

해결 문제

이 레포지토리는 Claude Code용으로 개발된 Academic Research Skills(ARS)를 Codex 런타임에서 직접 사용하도록 포팅하는 문제를 해결한다. 단일 Codex-native 스킬로 ARS 콘텐츠를 번들링하여 복수의 upstream 스킬을 설치할 필요 없이 한 번의 플러그인/스킬 설치로 연구 기획·문서 작성·동료 검토·실험 설계 등의 연속적 워크플로를 실행할 수 있다. 또한 vendored 소스와 매니페스트를 통해 upstream 버전 추적과 품질 게이트를 유지하여 재현성과 무결성을 보장한다.

지금 주목받는 이유

ARS-Codex는 v0.1.21로 패키지화되어 Codex 환경에서 Claude Code 기반의 포괄적인 학술 연구 워크플로를 단일 스킬로 제공한다는 점에서 관심을 끌고 있다.

차별점

• 원본 Claude Code ARS를 수정하지 않고 vendoring 방식으로 Codex 전용 패키지를 제공하여 원본 개발 이력을 보존한 채 Codex 환경에 맞춘 별도 매니페스트와 버전 관리 체계를 유지한다.
• 단일 academic-research-suite 스킬로 /ars-* 명령 의도를 aliases로 에뮬레이션하므로 Codex에서 여러 개의 자동 검색되는 스킬을 설치할 필요가 없어 설치·관리 복잡도를 낮춘다.
• full-runtime adapter와 planner 템플릿을 codex/ 디렉터리에 포함하되 기본 비활성화로 제공하여 필요한 사용 사례에서만 활성화하도록 설계해 표준 설치의 안전성과 경량성을 유지한다.

사용 사례

• 연구 질문 정제와 체계적 문헌 검토를 위한 deep-research 워크플로를 사용하여 연구 범위와 검색 전략을 설계하는 작업.
• 초록·아웃라인·원고 초안을 구조화하고 인용 포맷 및 AI 공개 문구를 포함한 학술 논문 초안 작성 흐름을 academic-paper 모드로 수행하는 상황.
• 저널 제출 전의 동료 심사 스타일 리포트와 편집 결정 서신을 생성하려는 manuscript review 및 re-review 과정.
• 실험 계획, 인간 연구 프로토콜 및 재현성 검증 체크포인트를 포함한 experiment-agent 워크플로로 코드 실험과 통계 해석 준비를 하는 시나리오.

시작하기

Codex 마켓플레이스에 리포지토리를 추가한 뒤 codex plugin marketplace add와 codex plugin add 명령으로 ars-codex 플러그인을 설치하면 플러그인 루트가 plugins/ars-codex/로 배치되어 skills/ 내에 academic-research-suite 스킬이 나타난다. 설치 후 Codex에서 새 대화를 열고 $academic-research-suite를 호출하거나 ars-plan 같은 alias 프롬프트를 입력하면 라우터가 적절한 워크플로로 요청을 배분한다. 직접 스킬을 설치하려면 제공된 install-skill-from-github.py 스크립트를 python3로 실행하여 skills/academic-research-suite 경로를 지정하면 된다.

요구사항

• Codex 런타임 또는 Codex Desktop 환경이 필요하다.
• 직접 설치 시 Python 3 실행 환경(python3 명령 접근)이 요구된다.
• 교차 모델 검증을 사용하려면 해당 제공자의 API 키와 별도 구성(예: OPENAI_API_KEY 및 ARS_CROSS_MODEL 환경변수)이 필요하다.