docs: strengthen web-search query guidance

This commit is contained in:
happybell80 2026-03-23 19:22:17 +09:00
parent 0ca3baafb9
commit ddc32bd607

View File

@ -1,24 +1,43 @@
---
name: web-search
description: 실시간 웹 검색. 날씨, 주가, 환율, 시세, 미세먼지, 뉴스 검색, 회사/기술/제품 정보 등 인터넷에서 찾아야 하는 실시간 정보 요청에 사용.
description: 실시간 웹 검색. 날씨, 주가, 환율, 시세, 미세먼지, 뉴스 검색, 회사/기술/제품 정보 등 인터넷에서 찾아야 하는 실시간 정보 요청에 사용합니다. 검색 전에는 사용자 의미를 보존한 검색 주제와 실제 검색 엔진용 최적화 쿼리를 구분하고, 정정 신호와 보호 표현을 반영해야 합니다.
---
# Web Search
Serper.dev API를 통한 Google 검색 + LLM 요약.
## 상위 원칙
- [Writing Principles](https://github.com/happybell80/0_VALUE/blob/main/20_Governance/writing-principles.md)
- [프로젝트 아티팩트 SSOT](https://github.com/happybell80/0_VALUE/blob/main/20_Governance/project-artifacts-ssot.md)
## Trigger
- 날씨/기온/미세먼지: "서울 날씨 어때?", "부산 미세먼지"
- 주가/환율/시세: "삼성전자 주가", "달러 환율", "비트코인 시세", "금 시세"
- 회사/기술 정보: "테슬라 최근 소식", "캔탈롭 회사 정보", "파이썬 3.12 새 기능"
- 일반 검색: "최신 아이폰 가격", "올해 공휴일", "스타트업 투자 트렌드"
- 정정 후 재검색: "아니 그거 말고", "다시 검색해봐", "했잖아"
- 보호 표현 포함 검색: "fear & greed 지수", "S&P 500", "NASDAQ Composite"
## Do
- 사용자 발화의 의미를 보존한 검색 주제와 실제 검색 실행용 최적화 쿼리를 구분한다.
- `optimized_search_query`가 있으면 그 값을 실제 검색 실행에 우선 사용한다.
- `fear & greed`, `S&P 500` 같은 보호 표현은 일반 단어로 분해하지 않는다.
- 사용자가 힌트나 정정 표현을 주면, 직전 잘못된 검색 주제를 버리고 새 쿼리를 재작성한다.
- Serper API로 검색 후 LLM이 요약
- 출처를 Slack 링크 형식으로 3개까지 첨부
## Do Not
- 검색 없이 추측으로 답하지 않는다.
- 자기지시 표현(`내 이름`, `내가 누구`)을 웹 검색으로 먼저 보내지 않는다.
- `이 뭐야`, `가 뭐야` 같은 광범위 표현만 보고 무조건 검색하지 않는다.
- 사용자가 준 힌트를 버린 채 원문만 반복 검색하지 않는다.
## 관련 문서
- [Self Inspect](../self-inspect/SKILL.md)
- [web_search_query_rewrite_workflow](../../workflow/01_conversation/web_search_query_rewrite_workflow.md)