documentation-lookup

---
name: documentation-lookup
description: Use up-to-date library and framework docs via Context7 MCP instead of training data. Activates for setup questions, API references, code examples, or when the user names a framework (e.g. React, Next.js, Prisma).
origin: ECC
---

# 문서 조회 (Context7)

사용자가 라이브러리, 프레임워크, 또는 API에 대해 질문할 때, 학습 데이터에 의존하지 않고 Context7 MCP (도구 `resolve-library-id`와 `query-docs`)를 통해 최신 문서를 가져오세요.

## 핵심 개념

- **Context7**: 라이브 문서를 제공하는 MCP 서버; 라이브러리와 API에 대해 학습 데이터 대신 사용.
- **resolve-library-id**: 라이브러리 이름과 쿼리로부터 Context7 호환 라이브러리 ID(예: `/vercel/next.js`)를 반환.
- **query-docs**: 주어진 라이브러리 ID와 질문에 대한 문서와 코드 스니펫을 가져옴. 유효한 라이브러리 ID를 얻기 위해 항상 resolve-library-id를 먼저 호출.

## 사용 시기

다음과 같은 경우 활성화:

- 설정 또는 구성 질문 (예: "Next.js 미들웨어를 어떻게 구성하나요?")
- 라이브러리에 의존하는 코드 요청 ("Prisma 쿼리를 작성해주세요...")
- API 또는 참조 정보 필요 ("Supabase 인증 방법은 무엇인가요?")
- 특정 프레임워크 또는 라이브러리 언급 (React, Vue, Svelte, Express, Tailwind, Prisma, Supabase 등)

라이브러리, 프레임워크, 또는 API의 정확하고 최신 동작에 의존하는 요청일 때마다 이 스킬을 사용하세요. Context7 MCP가 구성된 하네스(예: Claude Code, Cursor, Codex)에 적용됩니다.

## 작동 방식

### 1단계: 라이브러리 ID 확인

**resolve-library-id** MCP 도구를 다음과 함께 호출:

- **libraryName**: 사용자의 질문에서 가져온 라이브러리 또는 제품 이름 (예: `Next.js`, `Prisma`, `Supabase`).
- **query**: 사용자의 전체 질문. 결과의 관련성 순위를 개선합니다.

문서를 쿼리하기 전에 Context7 호환 라이브러리 ID (형식 `/org/project` 또는 `/org/project/version`)를 얻어야 합니다. 이 단계의 유효한 라이브러리 ID 없이 query-docs를 호출하지 마세요.

### 2단계: 최적 매치 선택

확인 결과에서 다음을 사용하여 하나의 결과 선택:

- **이름 매치**: 사용자가 요청한 것과 정확하거나 가장 가까운 매치 선호.
- **벤치마크 점수**: 높은 점수는 더 나은 문서 품질을 나타냄 (100이 최고).
- **출처 평판**: 가능한 경우 High 또는 Medium 평판 선호.
- **버전**: 사용자가 버전을 지정한 경우 (예: "React 19", "Next.js 15"), 나열된 경우 버전별 라이브러리 ID 선호 (예: `/org/project/v1.2.0`).

### 3단계: 문서 가져오기

**query-docs** MCP 도구를 다음과 함께 호출:

- **libraryId**: 2단계에서 선택한 Context7 라이브러리 ID (예: `/vercel/next.js`).
- **query**: 사용자의 구체적인 질문 또는 작업. 관련 스니펫을 얻기 위해 구체적으로.

제한: 질문당 query-docs (또는 resolve-library-id)를 3회 이상 호출하지 마세요. 3회 호출 후에도 답이 불명확하면, 불확실성을 명시하고 추측하지 말고 가진 최선의 정보를 사용하세요.

### 4단계: 문서 사용

- 가져온 최신 정보를 사용하여 사용자의 질문에 답변.
- 도움이 되는 경우 문서의 관련 코드 예시 포함.
- 중요한 경우 라이브러리 또는 버전 인용 (예: "Next.js 15에서는...").

## 예시

### 예시: Next.js 미들웨어

1. **resolve-library-id**를 `libraryName: "Next.js"`, `query: "How do I set up Next.js middleware?"`로 호출.
2. 결과에서 이름과 벤치마크 점수로 최적 매치 선택 (예: `/vercel/next.js`).
3. **query-docs**를 `libraryId: "/vercel/next.js"`, `query: "How do I set up Next.js middleware?"`로 호출.
4. 반환된 스니펫과 텍스트를 사용하여 답변; 관련된 경우 문서의 최소 `middleware.ts` 예시 포함.

### 예시: Prisma 쿼리

1. **resolve-library-id**를 `libraryName: "Prisma"`, `query: "How do I query with relations?"`으로 호출.
2. 공식 Prisma 라이브러리 ID 선택 (예: `/prisma/prisma`).
3. 해당 `libraryId`와 쿼리로 **query-docs** 호출.
4. 문서의 짧은 코드 스니펫과 함께 Prisma Client 패턴 (예: `include` 또는 `select`) 반환.

### 예시: Supabase 인증 방법

1. **resolve-library-id**를 `libraryName: "Supabase"`, `query: "What are the auth methods?"`로 호출.
2. Supabase 문서 라이브러리 ID 선택.
3. **query-docs** 호출; 인증 방법을 요약하고 가져온 문서의 최소 예시 표시.

## 모범 사례

- **구체적으로**: 더 나은 관련성을 위해 가능한 경우 사용자의 전체 질문을 쿼리로 사용.
- **버전 인식**: 사용자가 버전을 언급하면 resolve 단계에서 가능한 경우 버전별 라이브러리 ID 사용.
- **공식 출처 선호**: 여러 매치가 있을 때 커뮤니티 포크보다 공식 또는 주요 패키지 선호.
- **민감한 데이터 금지**: Context7에 전송되는 쿼리에서 API 키, 비밀번호, 토큰, 기타 비밀 정보를 삭제. resolve-library-id 또는 query-docs에 전달하기 전에 사용자의 질문에 비밀 정보가 포함될 수 있다고 가정.