스크립트 기반 문서 검색
개요
스크립트 우선 방식으로 llms.txt 표준을 사용한 문서 검색.
수동 URL 구성 없이 스크립트가 전체 워크플로우를 처리합니다.
기본 워크플로우
항상 다음 순서로 스크립트를 실행하세요:
# 1. 쿼리 유형 감지 (주제별 vs 일반)
node scripts/detect-topic.js "<user query>"
# 2. 스크립트 출력을 사용하여 문서 가져오기
node scripts/fetch-docs.js "<user query>"
# 3. 결과 분석 (여러 URL이 반환된 경우)
cat llms.txt | node scripts/analyze-llms-txt.js -
스크립트가 URL 구성, 폴백 체인, 오류 처리를 자동으로 처리합니다.
스크립트
detect-topic.js - 쿼리 유형 분류
- 주제별 vs 일반 쿼리 식별
- 라이브러리 이름 + 주제 키워드 추출
- 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 "<query>" # → {topic, library, isTopicSpecific}
node scripts/fetch-docs.js "<query>" # → 2-3개 URL
# WebFetch로 URL 읽기
일반 쿼리: "Next.js 문서"
node scripts/detect-topic.js "<query>" # → {isTopicSpecific: false}
node scripts/fetch-docs.js "<query>" # → 8개 이상 URL
cat llms.txt | node scripts/analyze-llms-txt.js - # → {totalUrls, distribution}
# 권장에 따라 에이전트 배포
환경
스크립트가 .env를 로드합니다: process.env > .opencode/skills/docs-seeker/.env > .opencode/skills/.env > .opencode/.env
설정 옵션은 .env.example을 참조하세요.