poemswe/co-researcher

특화된 에이전트 (Agents) 및 멀티 플랫폼 CLI 명령어를 사용하여 엄격한 학술 연구를 수행하기 위한 전문 연구 스위트 (Research Suite)입니다. Claude Code, Gemini CLI, OpenAI Codex, 그리고 OpenCode와 호환됩니다.

옵션 1: 슬래시 명령어 (Slash commands)

/plugin marketplace add poemswe/co-researcher
/plugin install co-researcher

옵션 2: Claude CLI

claude plugin install poemswe/co-researcher
claude plugin install co-researcher

옵션 1: GitHub에서 설치

gemini extension install https://github.com/poemswe/co-researcher

옵션 2: 로컬 디렉토리에서 설치

cd /path/to/co-researcher
gemini extension link .

옵션 1: Codex에게 요청 (에이전트 방식, Agentic)
Codex에게 다음과 같이 말하세요:

Fetch and follow instructions from https://raw.githubusercontent.com/poemswe/co-researcher/main/.codex/INSTALL.md

옵션 2: 수동 설정 (Manual Setup)

# 1. 이 저장소(repo)를 ~/.codex/skills/co-researcher로 클론(Clone)합니다.
# 2. ~/.codex/AGENTS.md에 훅(hook)을 추가합니다.
# 3. 실행:
...

자세한 내용은 .codex/INSTALL.md를 참조하세요.

옵션 1: OpenCode에게 요청 (에이전트 방식, Agentic)
OpenCode에게 다음과 같이 말하세요:

Fetch and follow instructions from https://raw.githubusercontent.com/poemswe/co-researcher/main/.opencode/INSTALL.md

옵션 2: 수동 설정 (Manual Setup)

# 1. 이 저장소(repo)를 클론(Clone)합니다.
# 2. 설치 프로그램을 실행합니다:
./.opencode/install.sh

자세한 내용은 .opencode/INSTALL.md를 참조하세요.

이 스위트는 지원되는 모든 플랫폼에서 네이티브 연구 명령어를 제공합니다:

기능	명령어 (Claude)	슬래시 (Gemini)	스킬 (Codex)
연구 프로젝트 (Research Project)	/research	/research	$research
방법론 (Methodology)	/methodology	/methodology	$methodology
비판적 분석 (Critical Analysis)	/analyze	/analyze	$analyze
참고문헌 (Bibliography)	/bibliography	/bibliography	$bibliography
종합 (Synthesize)	/synthesize	/synthesize	$synthesize
동료 검토 (Peer Review)	/review	/review	$review
윤리적 리스크 (Ethical Risk)	/ethics	/ethics	$ethics
연구비 제안서 (Grant Proposal)	/grant	/grant	$grant

/research

command는 다음과 같은 작업을 자동으로 수행하는 지능형 에이전트 오케스트레이션 (Agent Orchestration) 기능을 갖추고 있습니다:

• 연구 질문 (Research Question) 분석
• 특정 요구 사항에 최적화된 에이전트 (Agents) 선택
• 명확한 단계가 포함된 실행 계획 (Execution Plan) 생성
• 멀티 에이전트 워크플로우 (Multi-agent Workflows) 조정

대화형 모드 (Interactive Mode) (기본값 - 권장):

/research "social media가 청소년 정신 건강에 미치는 영향"

에이전트가 실행되기 전에 실행 계획을 검토하고 승인합니다.

자동 모드 (Auto Mode) (신뢰할 수 있는 워크플로우용):

/research "기후 변화 완화 전략" --auto

확인 절차 없이 계획을 자동으로 실행합니다.

계획 전용 모드 (Plan-Only Mode) (검토용):

/research "AI 윤리 프레임워크" --plan-only

실행 계획을 생성하지만 실행하지는 않습니다.

# 1. 오케스트레이션을 통한 연구 시작
/research "원격 근무가 생산성에 미치는 효과"
# 엔진이 수행할 작업:
...

일반적인 시나리오를 위해 사전 구성된 에이전트 조합:

/research "주제" --template=quick # 빠른 문헌 스캔 (Literature Scan)
/research "주제" --template=rigorous # 전체 체계적 문헌 고찰 (Systematic Review)
/research "주제" --template=comprehensive # 심층 다중 방법론 분석 (Multi-method Analysis)

이 스위트 (Suite)에는 박사급 (PhD-level) 연구 기술이 포함되어 있으며, 각 기술은 체계적 정직성 (Systemic Honesty) 원칙에 의해 관리됩니다.

critical-analysis (비판적 분석): 엄격한 논리 검증 및 오류 (fallacy) 탐지
ethics-review (윤리 검토): IRB (기관생명윤리위원회) 준수 및 개인정보 보호 위험 평가
grant-writing (연구비 신청서 작성): 자금 조달 전략 및 제안서 개발
hypothesis-testing (가설 검증): 변수 매핑 및 실험 설계
academic-writing (학술적 글쓰기): 연구 산문에서 AI 특유의 말투 (AI-isms) 제거
lateral-thinking (수평적 사고): 교차 도메인 유추 및 제1원리 추론 (first-principles reasoning)
literature-review (문헌 검토): 체계적 검색 및 인용 분석
multi-source-investigation (다중 소스 조사): 다양한 출처 간의 교차 검증 (cross-validation)
peer-review (동료 검토): 원고 비평 및 방법론 검토
qualitative-research (질적 연구): 주제 분석 (thematic analysis) 및 코딩
quantitative-analysis (양적 분석): 통계적 검정력 (statistical power) 및 효과 크기 (effect size) 해석
research-manager (연구 관리자): 동적 작업 스캐폴딩 (task scaffolding) 및 다국어 세션 지속성
research-methodology (연구 방법론): 설계 선택 및 검증
research-synthesis (연구 종합): 불확실성 정량화를 포함한 서사적 종합 (narrative synthesis)
systematic-review (체계적 문헌고찰): PRISMA 표준 체계적 문헌고찰 가이드라인
using-co-researcher (co-researcher 사용법): Claude가 스위트 내의 모든 가용 기술을 활용하도록 안내합니다. 전체 프로토콜 세트를 활성화하려면 세션당 한 번 실행하십시오.

v2.0 벤치마크 시스템으로 에이전트 성능을 검증하십시오:

cd evals
python run_eval.py all -j 4 --model "codex:gpt-5.2 high"

Parallel Runner (병렬 실행기): -j (jobs) 플래그를 사용한 멀티스레드 실행
Dynamic Rubrics (동적 루브릭): 에이전트 기술에 맞춘 6개의 전문 루브릭
Extended Targeting (확장된 타겟팅): 특정 버전 및 추론 수준 지원
Persistent Indexing (지속적 인덱싱): 재구축 가능한 latest/index.md

summary (요약)

확장성과 투명성을 위한 2개 파일 아키텍처:

Dashboard Data (대시보드 데이터) (benchmark_overview.json, ~900B):

• 경량화된 실행 메타데이터 및 요약 통계
• 빠른 대시보드 로딩 시간 (10-50배 개선)

Test Details (테스트 세부 정보) (test_results_detail/{run_id}.json, ~500KB):

• 에이전트의 전체 출력물 및 판사 (judge) 평가
• 루브릭별 점수 세부 내역
• 필수 포함 분석 및 근거 (justifications)

Arena Dashboard:
coresearcher.poemswe.com에서 실시간 인터랙티브 대시보드를 확인하세요.

또는 로컬에서 실행하세요:

open evals/index.html

주요 기능: 모델 리더보드 (Model leaderboards), 역량 매트릭스 (Capability matrices), 점수 추세 (Score trends), 그리고 성능 등급 (Excellent/Good/Fair/Poor)이 포함된 상세 테스트 분석.

skills/
: 특화된 연구 기술 (Markdown).

commands/
: 통합 플랫폼 명령 (Claude용 .md, Gemini용 .toml).

.codex/skills/
: Codex를 위한 네이티브 리포지토리 기술.

evals/
: 22개의 테스트 케이스 및 Python 러너 (Runner).

• manifests:
  gemini-extension.json,
  AGENTS.md,
  GEMINI.md.

MIT