Community연구 & 데이터 분석github.com

KimJaehee0725/research-history-tracker

연구 이력, BM25S 검색, 에이전트 핸드오프 캡슐을 위한 Codex/Claude 스킬

research-history-tracker란 무엇인가요?

이 스킬은 AI 에이전트(Codex, Claude 등)가 연구/탐색 과정에서 생성된 기록을 추적하고, BM25S 알고리즘을 이용해 과거 기록을 효율적으로 검색하며, 필요시 다른 에이전트로 작업을 전환(핸드오프)할 수 있는 캡슐(capsule) 시스템을 제공합니다. BM25S 기반 검색은 단순 키워드 매칭을 넘어서 관련성 있는 이전 연구 맥락을 빠르게 찾아주어 연속적인 작업 흐름을 유지하는 데 유용합니다. Codex나 Claude 환경에서 동작하며, 핸드오프 캡슐을 통해 에이전트 간 상태 전달이 가능해 복잡한 멀티 에이전트 시나리오에 적합합니다. SKILL.md 문서에는 실제 사용 예시와 설정 방법이 포함되어 있어 개발자가 즉시 적용할 수 있습니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add KimJaehee0725/track-research-history

Installed? Explore more 연구 & 데이터 분석 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

research-history-tracker은(는) 무엇을 하나요?

Codex/Claude 환경에서 연구 이력 추적, BM25S 기반 검색, 그리고 에이전트 핸드오프를 위한 캡슐 스킬입니다.

개요

이 스킬은 연구/작업 과정에서 발생하는 기록들을 자동으로 저장하고, BM25S 알고리즘을 이용해 관련 기록을 검색하며, 다른 에이전트로 작업을 전환(핸드오프)할 수 있는 캡슐을 제공합니다.

주요 기능

  • 연구 이력 추적: 에이전트가 수행한 작업, 조사한 내용, 결정 사항 등을 자동으로 기록합니다.
  • BM25S 검색: 과거 기록 중 관련성 높은 내용을 BM25S 알고리즘으로 빠르게 검색합니다.
  • 핸드오프 캡슐: 에이전트 간 상태(context)를 전달하는 표준화된 캡슐 포맷을 제공합니다.

사용 방법

  1. 스킬을 활성화합니다.

    codex skill activate KimJaehee0725/research-history-tracker
    
  2. 연구 이력을 기록합니다.

    skill: track-research-history --action save --topic "Transformer 아키텍처 분석" --content "..."
    
  3. 관련 이력을 검색합니다.

    skill: track-research-history --action search --query "attention mechanism"
    
  4. 핸드오프 캡슐을 생성하여 다른 에이전트로 전달합니다.

    skill: track-research-history --action handoff --target "agent-b" --capsule "..."
    

환경 변수

  • RESEARCH_HISTORY_DB_PATH: 기록 데이터베이스 저장 경로 (기본값: ./research_history.db)
  • BM25S_INDEX_PATH: BM25S 인덱스 저장 경로 (기본값: ./bm25s_index)

참고

  • BM25S는 Apache 2.0 라이선스의 오픈소스 라이브러리입니다.
  • 핸드오프 캡슐은 JSON 포맷으로 직렬화됩니다.

관련 스킬