스크립트 기반 문서 검색
개요
스크립트 우선 방식으로 llms.txt 표준을 사용한 문서 검색을 수행합니다.
스크립트를 실행하여 전체 워크플로우를 처리하므로 수동 URL 구성이 필요하지 않습니다.
기본 워크플로우
항상 다음 순서로 스크립트를 실행하세요:
# 1. 질의 유형 감지 (주제별 vs 일반)
node scripts/detect-topic.js "<사용자 질의>"
# 2. 스크립트 출력을 사용하여 문서 가져오기
node scripts/fetch-docs.js "<사용자 질의>"
# 3. 결과 분석 (여러 URL이 반환된 경우)
cat llms.txt | node scripts/analyze-llms-txt.js -
스크립트는 URL 구성, 폴백 체인, 오류 처리를 자동으로 처리합니다.
스크립트
detect-topic.js - 질의 유형 분류
- 주제별 질의와 일반 질의를 구분합니다.
- 라이브러리 이름 + 주제 키워드를 추출합니다.
- JSON 반환:
{topic, library, isTopicSpecific} - 제로-토큰 실행
fetch-docs.js - 문서 검색
- context7.com URL을 자동으로 구성합니다.
- 폴백 처리: 주제 → 일반 → 오류
- llms.txt 내용 또는 오류 메시지 출력
- 제로-토큰 실행
analyze-llms-txt.js - llms.txt 처리
- URL을 분류합니다 (중요/보조/부가).
- 에이전트 분산 전략을 추천합니다 (1개 에이전트, 3개 에이전트, 7개 에이전트, 단계별).
- 전략이 포함된 JSON 반환
- 제로-토큰 실행
워크플로우 참조
주제별 검색 - 가장 빠른 경로 (10-15초)
일반 라이브러리 검색 - 포괄적 범위 (30-60초)
저장소 분석 - 폴백 전략
참조
context7-patterns.md - URL 패턴, 알려진 저장소
errors.md - 오류 처리, 폴백 전략
advanced.md - 엣지 케이스, 버전 관리, 다국어
실행 원칙
- 스크립트 우선 - 수동 URL 구성 대신 스크립트를 실행하세요.
- 제로-토큰 오버헤드 - 스크립트는 컨텍스트 로딩 없이 실행됩니다.
- 자동 폴백 - 스크립트가 주제 → 일반 → 오류 체인을 처리합니다.
- 점진적 공개 - 워크플로우 및 참조는 필요할 때만 로드하세요.
- 에이전트 분산 - 스크립트가 병렬 에이전트 전략을 추천합니다.
빠른 시작
주제 질의: "shadcn에서 date picker를 어떻게 사용하나요?"
node scripts/detect-topic.js "<질의>" # → {topic, library, isTopicSpecific}
node scripts/fetch-docs.js "<질의>" # → 2-3개 URL
# WebFetch로 URL 읽기
일반 질의: "Next.js 문서"
node scripts/detect-topic.js "<질의>" # → {isTopicSpecific: false}
node scripts/fetch-docs.js "<질의>" # → 8개 이상 URL
cat llms.txt | node scripts/analyze-llms-txt.js - # → {totalUrls, distribution}
# 추천에 따라 에이전트 배포
환경 설정
스크립트는 .env 파일을 다음 순서로 로드합니다: process.env > .claude/skills/docs-seeker/.env > .claude/skills/.env > .claude/.env
구성 옵션은 .env.example을 참조하세요.