| 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을 만든다.
## 리서치 종합: <주제>
- 학습자 수준: <입문/초급/중급/고급>
### 핵심 개념 (요약)
- 개념 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 다중 쿼리 직접 조사
