ref-web-search

웹 검색을 수행하고 결과를 마크다운으로 저장하는 스킬.

목적

• 웹 검색 자동화
• 검색 결과 정리 및 저장
• 기술 레퍼런스 수집

사용법

/ref-web-search "FastAPI authentication best practices 2026"
/ref-web-search "Python async patterns" --domain stackoverflow.com

프로세스

/ref-web-search [query]
    |
    v
[Step 1] WebSearch 실행
    |-- 검색 쿼리 실행
    |-- 결과 수집
    |
    v
[Step 2] 결과 필터링
    |-- 관련성 높은 결과 선별 (상위 5-10개)
    |-- 중복 제거
    |
    v
[Step 3] 마크다운 변환
    |-- 구조화된 형식으로 정리
    |-- 소스 URL 기록
    |
    v
[Step 4] 파일 저장
    |-- docs/references/search-{query-slug}.md
    |
    v
완료

출력 템플릿

# {검색 쿼리} - 웹 검색 결과

> **검색일**: {YYYY-MM-DD}
>
> **쿼리**: {query}

---

## 검색 결과 요약

{AI 생성 요약 - 핵심 인사이트 3-5줄}

---

## 상세 결과

### 1. {제목 1}
- **URL**: {url}
- **발췌**: {snippet}
- **관련성**: 높음

### 2. {제목 2}
- **URL**: {url}
- **발췌**: {snippet}
- **관련성**: 높음

...

---

## 핵심 인사이트

- {인사이트 1}
- {인사이트 2}
- {인사이트 3}

---

## 참고 자료

- [{제목 1}]({url1})
- [{제목 2}]({url2})

예제

User: /ref-web-search "FastAPI JWT authentication 2026"

Claude:
=== 웹 검색 실행 ===

쿼리: "FastAPI JWT authentication 2026"

[1/3] WebSearch 실행 중...
  - 10개 결과 수집

[2/3] 결과 분석 중...
  - 관련성 높은 결과: 7개
  - 기술 문서: 4개
  - 튜토리얼: 2개
  - Stack Overflow: 1개

[3/3] 문서 생성 중...

=== 완료 ===

파일: docs/references/search-fastapi-jwt-authentication.md

### 핵심 인사이트

1. python-jose 대신 PyJWT 권장 (보안 업데이트)
2. OAuth2PasswordBearer + Depends 패턴 표준
3. 토큰 갱신은 별도 엔드포인트 권장

다음 단계: /ref-url-fetcher로 상세 문서 수집

관련 스킬

스킬명	관계	설명
[@skills/ref-url-fetcher/SKILL.md]	관련	특정 URL 상세 수집
[@skills/prd-workflow/SKILL.md]	부모	레퍼런스 수집 단계

Changelog

날짜	변경 내용
2026-01-21	초기 스킬 생성