Education Tutor Research

---
name: education-tutor-research
description: |
  학습 질문을 받으면 공식 문서와 최신 웹 자료를 웹검색으로 병렬 조사해, 출처가 검증된 최신 학습 근거를 종합해 드립니다. 개인 튜터가 자료를 미리 조사해 오는 역할입니다.
  다음과 같은 요청 시 사용하세요:
  - "claude cowork의 Skills와 Sub-agents 차이를 최신 정보로 조사해줘"
  - "이 개념 정확한 최신 내용으로 알려줘"
  - "여러 자료 병렬로 조사해서 가르쳐줘"
  - "공식 문서랑 웹 최신 내용 같이 찾아줘"
  - "React 19 use훅 공식 문서 기준으로 설명 준비해줘"
  - "튜터처럼 이 주제 깊이 조사해줘"
  질문을 리서치 축으로 분해해 공식 문서(WebSearch로 찾아 WebFetch로 본문 확인)와 최신 웹 자료(WebSearch)를 병렬 조사하고, 출처를 교차검증한 뒤 education-learning-material로 넘길 종합본을 만듭니다.
  [책임 경계] vs moai-tutor:education-research-assistant: 이 스킬=개인 학습용 최신 정보 빠른 조사, 저 스킬=학술 논문용 문헌 검토와 인용 관리.
version: "1.1.0"
---

# 튜터 리서치 (Tutor Research)

## 개요

학습 질문을 받아 **여러 경로를 병렬로 조사**해 신뢰할 수 있는 최신 학습 근거를 종합한다. 두 축을 동시에 가동한다: ① **공식 문서 축** — WebSearch로 라이브러리·SDK·프레임워크·CLI의 공식 문서 URL을 찾아 WebFetch로 본문을 확인, ② **최신 정보 축** — WebSearch로 최신 변경사항·튜토리얼·개념 비교·실무 사례를 조사. 출처를 교차검증해 환각을 차단하고, `education-learning-material`이 바로 쓸 수 있는 구조화된 종합본을 만든다.

## 트리거 키워드

조사, 리서치, 최신 정보, 공식 문서, 병렬 조사, 정확한 내용, 알려줘, 비교, 차이, 어떻게 동작

## 워크플로우

### 1단계: 질문 분석 → 리서치 축 도출

질문을 답하기 위한 하위 축으로 분해한다.

- **공식 문서 축**: 특정 라이브러리·SDK·도구·API가 등장하는가? (예: React 19, Next.js, claude code CLI, FastAPI) → 공식 문서 사이트·URL 후보 도출
- **최신 정보 축(WebSearch 대상)**: 개념·트렌드·비교·"언제 무엇을 쓰나"·최근 변경 → 검색 쿼리 2-4개
- **코드베이스 축(선택)**: 사용자 프로젝트 내부 코드를 학습 대상에 포함하는 경우 — 환경이 서브에이전트(`Agent(Explore)`)를 지원하면 사용, 아니면 직접 파일을 읽어 조사

### 2단계: 병렬 리서치 실행

[HARD] 독립적인 조사는 **한 턴에 병렬로** 실행한다(직렬 금지). 다음을 동시에 호출한다.

- 공식 문서: WebSearch로 공식 문서 URL을 찾고 → WebFetch로 해당 페이지 본문을 확인
- WebSearch: 도출한 쿼리 2-4개 (최신 변경·비교·튜토리얼)
- (광범위 주제일 때, 환경이 서브에이전트를 지원하면) `Agent(Explore)`/`Agent(general-purpose)` 리서처를 하위 축마다 **병렬 fan-out**한다. 서브에이전트를 지원하지 않는 환경(예: Claude Cowork Desktop)에서는 WebSearch를 축별로 직접 병렬 실행한다.

광범위·다면적 주제(소스 교차검증이 핵심)이고 환경이 `/deep-research`를 지원하면 번들된 `/deep-research <질문>` 워크플로우를 제안할 수 있다(토큰 비용이 단발 검색보다 크다는 점을 먼저 알린다). 지원하지 않으면 WebSearch 다중 쿼리로 직접 교차검증한다.

```
[한 턴 안에서 병렬 호출]
  ├─ WebSearch: "<라이브러리> 공식 문서 <핵심 토픽>" → WebFetch: <공식 문서 URL>
  ├─ WebSearch: "<주제> 2026 최신"
  ├─ WebSearch: "<개념 A> vs <개념 B> 차이 언제 사용"
  └─ (선택, 서브에이전트 지원 시) Agent(Explore): 사용자 프로젝트 내 관련 코드 패턴 — 미지원 시 직접 파일 읽기
```

> **GLM 백엔드 주의**: `moai glm` 또는 `moai cg`의 GLM 페인에서는 WebSearch·WebFetch가 z.ai MCP 도구로 라우팅된다. `.claude/rules/moai/core/glm-web-tooling.md`의 라우팅 표를 따른다.

### 3단계: 교차검증 + 종합

- **출처 검증**: WebSearch 결과 URL은 WebFetch로 실재·내용을 확인한 것만 인용한다. 검색 결과에 없는 URL은 생성하지 않는다(반환각 정책).
- **상충 처리**: 공식 문서와 웹 자료가 다르면 **공식 문서(공식 사이트)를 우선**하고, 웹 자료는 보조·맥락으로 표기한다. 버전 차이로 인한 상충은 버전을 명시한다.
- **수준 맞춤**: education-learning-project의 학습자 수준에 맞춰 용어 난이도를 조정한다(입문이면 전제 개념부터).

### 4단계: 종합본 출력 (education-learning-material 입력 규격)

`education-learning-material`이 바로 소비할 수 있는 구조화된 Markdown을 만든다.

```markdown
## 리서치 종합: <주제>
- 학습자 수준: <입문/초급/중급/고급>

### 핵심 개념 (요약)
- 개념 1 — 한 줄 정의 + 근거 출처
- ...

### 도식 후보 (mermaid 소스 초안)
- 개념 관계도 / 플로우 / 시퀀스 중 적합한 것 1-2개 초안

### 예제·코드 (출처·버전 표기)
- 공식 문서 기준 최소 예제

### 자주 헷갈리는 점 / 비교
- A vs B, 언제 무엇을 쓰나

### 출처
- 공식 문서: <공식 사이트 URL·버전>
- 웹: <검증된 URL 목록>
```

## 산출물

- 구조화된 리서치 종합본 (Markdown, 출처 포함)
- mermaid 도식 소스 초안 (education-learning-material로 전달)
- 검증된 출처 목록 (공식 문서 + 웹 URL)

## 사용 예시

**예시 1**: "claude code 서브에이전트 동작 방식 최신 정보로 조사해줘"
→ WebSearch+WebFetch(claude code 공식 문서) + WebSearch(최신 변경) 병렬 → 종합본 + 시퀀스 도식 초안

**예시 2**: "React 19 use 훅, 공식 문서 기준으로 설명 준비해줘"
→ WebSearch+WebFetch(React 19 공식 문서) 중심 + WebSearch(실무 예) → 예제·비교 종합

**예시 3**: "영어 가정법 과거완료, 정확한 규칙과 예문 조사해줘"
→ WebSearch(문법 규칙·예문) 병렬 → 규칙 표 + 예문 종합 (라이브러리 무관 → 공식 문서 축 생략)

## 주의사항

- **출처 없는 단정 금지**: 확인되지 않은 내용은 "확인 필요"로 표기한다.
- **WebSearch 사용 시 Sources 섹션 필수** — 검증된 URL만 마크다운 링크로 포함한다.
- **공식 문서 조회**: 공식 문서는 WebSearch로 URL을 확인한 뒤 WebFetch로 본문을 직접 조회한다(검색 결과에 없는 URL 생성 금지).
- **사용자에게 직접 질문하지 않는다**: 추가 정보가 필요하면 종합본에 "확인 필요" 항목으로 남기고, 결정은 오케스트레이터가 AskUserQuestion으로 처리한다.

## 관련 스킬

- **moai-tutor:education-learning-project**: 마일스톤 핵심 질문이 이 스킬의 입력이 된다
- **moai-tutor:education-learning-material**: 이 스킬의 종합본을 도식·HTML 학습자료로 변환

## 이 스킬을 사용하지 말아야 할 때

- **학술 논문용 문헌 검토·인용 관리** → `moai-tutor:education-research-assistant`
- **시장·비즈니스 조사** → `moai-consultant:consult-market`
- **깊은 다중 소스 교차검증 리포트(단일 질문, 비학습)** → 환경이 지원하면 번들 `/deep-research` 워크플로우, 아니면 WebSearch 다중 쿼리 직접 조사