Imbad0202/academic-research-skills-codex

Codex-native Academic Research Skills suite for human-in-the-loop academic research workflows

개요

ARS‑Codex는 원래 Claude Code 모델용으로 구축된 Academic Research Skills (ARS) 워크플로우 스위트를 단일 플러그인으로 묶은 Codex 호환 스킬입니다. 동일한 연구 중심 에이전트, 프롬프트, 파이프라인을 재패키징하여 단일 진입점 – $academic‑research‑suite – 을 통해 Codex 세션에서 호출할 수 있게 합니다.

이 패키지에는 새로운 AI 모델이 포함되어 있지 않으며, 단지 기존 프롬프트, 스크립트, 런타임 정책을 Codex 플러그인 시스템에서 작동하도록 적용할 뿐입니다. 설치 후 사용자는 Codex에 체계적 문헌 검토 계획, 논문 초안 작성, 연구에서 논문까지의 전체 파이프라인 실행, 연구 기록 스크리닝, 재현성 실험 설계를 요청할 수 있습니다.

리포지토리 내용

디렉토리	목적
`skills/academic-research-suite/`	핵심 ARS 스킬 – 매니페스트, SKILL.md, 워크플로우를 구동하는 `agents/`, `hooks/`, `scripts/`.
`ars/` 하위 폴더 (`deep‑research/`, `academic‑paper/`, …)	6가지 주요 워크플로우(딥 리서치, 논문 초안, 리뷰어, 파이프라인, 스크리너, 실험) 각각에 대한 프롬프트 템플릿 및 명령 레시피.
`codex/`	Codex별 어댑터 파일: 런타임 매니페스트, 선택적 전체 런타임 토폴로지, 정책 문서(`model‑runtime‑policy.md`, 감사).
`CODEX_FULL_RUNTIME_ADAPTER.md`	고정 에이전트 팀 토폴로지와 훅 팩을 활성화하는 선택적 “전체 런타임” 모드에 대한 문서.
`CHANGELOG.md`, `VERSION`	버전 추적 – 현재 릴리스는 v3.23.0(업스트림 ARS 스위트를 미러링).
설치 스크립트	Codex CLI 또는 Codex Marketplace를 통해 스킬을 직접 설치하기 위한 도우미 스크립트.

실행 방법

Codex Marketplace를 통해 (권장):
```
codex plugin marketplace add Imbad0202/academic-research-skills-codex --ref main
codex plugin add ars-codex@ars-codex
```
이렇게 하면 플러그인이 등록되고 $academic‑research‑suite 스킬을 사용할 수 있습니다.

스킬 직접 설치 (수동 방식을 선호하는 경우):

python3 "$HOME/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py" \
  --repo Imbad0202/academic-research-skills-codex \
  --ref main \
  --path skills/academic-research-suite \
  --method git

설치 후 새 Codex 대화를 시작하고 /skills를 실행하면 academic‑research‑suite(또는 ARS‑Codex)라는 단일 항목이 표시됩니다.

업데이트 – 마켓플레이스 업그레이드 명령을 실행하거나 스킬 폴더를 삭제하고 다시 설치합니다.

주요 기능 (6가지 워크플로우)

워크플로우	사용 시기	Codex에 줄 수 있는 프롬프트 예시
deep‑research	연구 질문을 다듬고, 체계적 문헌 검색, 메타 분석 계획을 수행.	`Use $academic-research-suite to build a systematic review protocol for AI in higher‑education QA.`
academic‑paper	개요, 초록, 섹션 초안 작성, 인용 형식 지정, AI 공개 문구 추가.	`Use $academic-research-suite to turn these notes into an IMRaD paper outline.`
academic‑paper‑reviewer	시뮬레이션된 동료 검토, 결정 서한 생성, 수정 제안.	`Use $academic-research-suite to review this manuscript and produce a journal‑style decision letter.`
academic‑pipeline	무결성 게이트, 수정 루프, 최종 검사를 갖춘 종단 간 “연구-논문” 프로세스.	`Use $academic-research-suite to run an end‑to‑end pipeline from topic to revised manuscript.`
sr‑screener	사전 정의된 프로토콜에 대한 제목/초록 또는 전문 스크리닝; 감사 보고서 생성.	`Use $academic-research-suite: sr‑screener ta‑screen these records against my confirmed protocol.`
experiment‑agent	코드 실험 계획, 통계 분석 정의, 재현성 확인.	`Use $academic-research-suite to plan a code experiment and define reproducibility checks.`

각 워크플로우는 단일 스킬 항목을 통해 호출되며, 라우터는 요청의 표현에 따라 실행할 내부 모드를 결정합니다.

일반적인 상호작용 패턴

목표와 현재 자산을 진술 – 예:

Use $academic-research-suite.
Goal: write a journal article on AI adoption in higher education.
Current materials: literature matrix, rough findings, no outline.
Constraints: English, APA 7, policy‑maker audience.

라우터가 적절한 워크플로우를 선택하도록 함 (질문이 모호한 경우 종종 deep‑research가 먼저).
특정 모드로 후속 조치 – 예: 질문을 좁힌 후 ars‑outline 또는 academic‑paper로 개요를 요청.
내장 무결성 게이트 사용 – 파이프라인은 인용 유효성 확인, 검증되지 않은 진술 플래그 지정, 리뷰어 스타일 검사 적용을 자동으로 수행할 수 있습니다.

하지 않는 일

어떤 모델도 학습하거나 미세 조정하지 않습니다.
독립형 웹 UI를 제공하지 않습니다 – 상호작용은 Codex 대화 내에서 또는 CLI codex exec 샌드박스를 통해 이루어집니다.
선택적 전체 런타임 어댑터(에이전트 팀 토폴로지, 훅)는 기본적으로 비활성화; 일반적인 사용은 Codex의 기본 하위 에이전트 처리를 사용합니다.

누구에게 유용할까요?

대학원생 또는 연구자 – 자체 프롬프트 라이브러리를 구축하지 않고 문헌 검토, 초안 작성, 동료 검토 시뮬레이션을 구조화된 AI 지원 방식으로 관리하려는 경우.
이미 Codex를 사용하는 연구 실험실 – 학술 작성 파이프라인용 플러그 앤 플레이 스킬이 필요한 경우.
도구 개발자 – 다른 LLM 플랫폼에 적용할 수 있는 다단계 연구 워크플로우의 참조 구현을 찾는 경우.

빠른 시작 체크리스트

플러그인 설치 (Marketplace 또는 수동).
새 Codex 채팅 열기.
/skills 실행 – 단일 ARS 항목 확인.

다음과 같은 요청 실행:

Use $academic-research-suite.
I want to write a paper on AI governance in universities. I don’t have a clear question yet.

소크라테스식 질문을 따르고, 필요에 따라 ars‑outline 또는 academic‑pipeline으로 이동.

위의 모든 세부 사항은 리포지토리의 README에서 직접 가져온 것이며, 추가 기능은 추론되지 않았습니다.