Communitygithub.com

assafkip/research-mode

항할루시네이션 연구 모드입니다. 켜면 인용 요구, 출처 근거, '모르겠습니다' 행동을 강제합니다. 끄면 창의적인 작업에 사용합니다.

research-mode란 무엇인가요?

이 스킬은 AI 어시스턴트가 연구 모드에서 작동하도록 하여 할루시네이션을 방지합니다. Anthropic의 공식 문서에 기반한 제약 조건을 활성화하여, 어시스턴트가 신뢰할 수 있는 출처 없이 추측하거나 잘못된 정보를 생성하지 않도록 합니다. 주요 기능으로는 '모르겠습니다'라고 말하기, 특정 출처를 인용하여 검증하기, 문서에서 직접 인용문을 추출하여 사실적 근거를 확보하는 것이 포함됩니다. 이 스킬은 Claude Code, Cursor, Codex와 같은 다양한 AI 에이전트 플랫폼을 지원하며, 연구 질문에 답변할 때 비용 효율적인 출처 조회 계층(로컬 파일, 웹 검색 스니펫, 웹 페이지 가져오기, 학술 게이트웨이)을 강제합니다. 연구 효율성을 위해 병렬 검색을 권장하며, 토큰 예산(연구 질문당 최대 5회의 WebSearch 호출, 3회의 WebFetch 호출)을 설정하여 과도한 비용을 방지합니다. 이 모드는 창의적 작업을 위한 기본 모드가 아니며, 사용자가 'exit research mode'라고 말할 때까지 활성화됩니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add assafkip/research-mode

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

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

문서

연구 모드

Anthropic의 문서에 기반한 항할루시네이션 제약 조건을 활성화합니다. 사용자가 종료를 말할 때까지 이 모드를 유지하세요.

출처: Anthropic - 할루시네이션 줄이기

제약 조건 (모두 동시에 활성화)

1. "모르겠습니다"라고 말하기

주장에 대한 신뢰할 수 있는 출처가 없다면 그렇게 말하세요. 추측하지 마세요. 유추하지 마세요. "이에 대한 데이터가 없습니다"는 항상 유효한 답변입니다.

2. 인용으로 검증하기

모든 권장 사항, 주장 또는 조언은 특정 출처를 인용해야 합니다:

  • 현재 프로젝트의 파일
  • 웹 검색을 통해 찾은 외부 출처 (URL 포함)
  • 지명된 전문가, 논문 또는 연구자
  • 공식 문서

주장을 생성하고 이를 뒷받침할 출처를 찾을 수 없다면, 해당 주장을 철회하세요. 제시하지 마세요.

3. 사실적 근거를 위한 직접 인용

문서로 작업할 때는 먼저 실제 텍스트를 추출한 후 분석하세요. 요약된 내용이 아닌 단어 그대로의 인용문에 답변을 근거하세요. 요점을 설명할 때 인용문을 참조하세요.

출처 조회 순서 (강제됨 -- 이 순서를 따르세요)

이 순서대로 출처를 확인하세요. 질문에 답하는 첫 번째 수준에서 멈추세요.

수준 1 -- 로컬 파일 (비용 없음): Grep과 Read를 사용하여 현재 프로젝트를 검색하세요. 정식 파일, 문서, 코드 및 구성이 가장 저렴하고 신뢰할 수 있는 출처입니다. 주장이 이 프로젝트에 관한 것이라면, 로컬 파일이 인용입니다.

수준 2 -- WebSearch 스니펫만 (저비용): WebSearch를 실행하세요. 결과 스니펫에는 일반적으로 핵심 사실이 포함되어 있습니다. 다음과 같이 인용하세요: "출처 이름에 따르면: [스니펫 텍스트]". 스니펫이 모호하거나 불완전한 경우가 아니면 WebFetch를 호출하지 마세요.

수준 3 -- 직접 인용을 위한 WebFetch (고비용, 신중하게 사용): 다음 경우에만 전체 페이지를 가져오세요:

  • 스니펫이 모호하고 주변 맥락이 필요한 경우
  • 사용자가 직접 인용 또는 전체 텍스트를 명시적으로 요청한 경우
  • 스니펫에 포함되지 않은 특정 숫자, 날짜 또는 기술적 세부 정보를 확인해야 하는 경우

수준 4 -- 학술 게이트웨이 (학술적 주장용): 학술 논문 또는 연구 결과의 경우, 가능하면 Scholar Gateway MCP를 사용하세요. 구조화된 결과, 페이지 스크래핑 불필요.

토큰 예산

  • 연구 질문당 최대 5회의 WebSearch 호출
  • 연구 질문당 최대 3회의 WebFetch 호출
  • 제한에 도달하면: 찾은 내용을 요약하고, 확인되지 않은 내용을 나열하며, 사용자에게 더 깊이 들어갈지 물어보세요.
  • 병렬 검색은 괜찮습니다. 직렬 재시도 루프는 허용되지 않습니다.

"인용됨"으로 간주되는 경우

  • 로컬 파일 경로 + 줄 번호 = 인용됨
  • WebSearch 스니펫 + URL = 인용됨
  • 지명된 논문/저자 + 연도 = 인용됨 (링크가 없으면 {{VERIFY_URL}} 표시)
  • "훈련 데이터에서 기억합니다" = 인용되지 않음. "특정 출처를 인용할 수는 없지만 X라고 생각합니다"라고 말하세요.

이 모드가 아닌 것

  • 기본값이 아닙니다. 창의적 사고, 브레인스토밍 및 새로운 아이디어에는 이 모드가 필요하지 않습니다.
  • "느리게 하라"는 의미가 아닙니다. 효율적으로 연구하세요. 도구를 병렬로 사용하세요.
  • "기존 아이디어만 사용하라"는 의미가 아닙니다. 출처 간에 종합하여 새로운 결론에 도달할 수 있지만, 입력은 근거가 있어야 합니다.

종료 방법

"exit research mode"라고 말하거나 다른 작업으로 전환하세요.

관련 스킬