Communitygithub.com

Deafened-vascularstructure846/pageindex-rag

임베딩이나 벡터 스토어 없이 추론 기반 검색과 답변 생성을 지원하는 벡터리스 RAG를 구축합니다.

pageindex-rag란 무엇인가요?

이 스킬은 기존의 임베딩과 벡터 데이터베이스에 의존하지 않는 벡터리스 RAG(Retrieval-Augmented Generation) 시스템을 구축하는 방법을 제공합니다. 핵심 아이디어는 문서를 페이지 인덱스 기반으로 구조화하고, 쿼리에 대해 추론 기반의 검색을 수행하여 관련 내용을 찾은 후 LLM을 통해 답변을 생성하는 것입니다. 이 접근 방식은 임베딩 생성 비용과 벡터 스토어 관리 복잡성을 제거하므로, 소규모 또는 프라이빗 환경에서 빠르게 RAG를 구현해야 하는 개발자에게 유용합니다. Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있으며, 주로 문서를 분할하여 인덱싱한 후 키워드 매칭이나 간단한 추론 규칙으로 검색을 수행합니다. SKILL.md 문서에는 구체적인 구현 방법, 파일 구조, 사용 예시, 그리고 환경 변수 설정 등이 포함되어 있어 개발자가 바로 따라 할 수 있도록 안내합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add Deafened-vascularstructure846/pageindex-rag

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

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

문서

pageindex-rag은(는) 무엇을 하나요?

임베딩이나 벡터 스토어 없이 추론 기반 검색과 답변 생성을 지원하는 벡터리스 RAG를 구축합니다.

개요

이 스킬은 전통적인 임베딩과 벡터 데이터베이스 없이 작동하는 RAG(Retrieval-Augmented Generation) 시스템을 구현합니다. 문서는 페이지 단위로 인덱싱되고, 쿼리는 간단한 추론 규칙(예: 키워드 매칭, 빈도 분석)을 사용하여 가장 관련성 높은 페이지를 검색합니다. 검색된 내용은 LLM에 컨텍스트로 제공되어 최종 답변이 생성됩니다.

작동 방식

  1. 문서 인덱싱: 문서를 페이지(또는 청크)로 분할하고 각 페이지에 고유 인덱스를 할당합니다.
  2. 쿼리 처리: 사용자 쿼리를 분석하여 관련 키워드를 추출합니다.
  3. 페이지 검색: 키워드 매칭이나 간단한 TF-IDF 유사도를 사용하여 가장 관련성 높은 페이지 인덱스를 찾습니다.
  4. 답변 생성: 검색된 페이지 내용을 LLM에 컨텍스트로 전달하여 답변을 생성합니다.

지원 플랫폼

  • Claude Code
  • Cursor
  • Codex
  • 기타 AI 에이전트 플랫폼

사용 예시

# 스킬 활성화 (Claude Code 예시)
claude use Deafened-vascularstructure846/pageindex-rag

환경 변수

변수명설명기본값
DOCUMENT_DIR문서가 위치한 디렉토리 경로./docs
INDEX_FILE페이지 인덱스 파일 경로./page_index.json
LLM_MODEL사용할 LLM 모델 이름gpt-4

설치

  1. 저장소를 클론합니다.
  2. 필요한 의존성을 설치합니다 (예: pip install -r requirements.txt).
  3. 환경 변수를 설정합니다.
  4. 문서를 DOCUMENT_DIR에 배치합니다.
  5. 스킬을 실행합니다.

라이센스

MIT

관련 스킬