research-agent-optimization
리서치 에이전트 안정성 개선
리서치 에이전트는 할당량을 낭비하고, 진행 상황을 숨기며, 사용하기 어려운 소스 데이터를 반환할 수 있습니다. 이 스킬은 Claude, Codex 또는 Claude Code가 실용적인 백엔드 및 프론트엔드 개선을 수행하도록 안내합니다.
스킬 ZIP 다운로드
Claude에서 업로드
설정 → 기능 → 스킬 → 스킬 업로드로 이동
토글을 켜고 사용 시작
에이전트가 읽기 쉬운 리소스
AI 에이전트, 크롤러, 스크립트가 전체 페이지 대신 정리된 컨텍스트만 필요할 때 이 링크를 사용하세요.
테스트해 보기
"research-agent-optimization" 사용 중입니다. 사용자가 리서치 결과에 여전히 raw source data가 표시되는 이유를 묻습니다.
예상 결과:
어시스턴트는 응답 파싱 및 렌더링 경로를 식별한 다음, 아티클 카드와 중복 제거가 포함된 Sources 섹션을 권장합니다.
"research-agent-optimization" 사용 중입니다. 개발자가 아티클 분석 중 빈번한 할당량 오류를 보고합니다.
예상 결과:
어시스턴트는 graceful 429 handling, 더 짧은 재시도 기간, 할당량 경고, Gemini 분석을 건너뛰는 선택적 모드를 제안합니다.
"research-agent-optimization" 사용 중입니다. 프로덕트 팀이 장시간 실행되는 검색 진행 상황을 더 명확히 원합니다.
예상 결과:
어시스턴트는 각 검색 및 아티클 읽기 작업을 타임스탬프와 소요 시간이 포함된 구체적인 스트리밍 메시지로 매핑합니다.
보안 감사
낮은 위험Static analysis reported shell execution, weak cryptography, and reconnaissance patterns, but the reviewed file is Markdown guidance. The shell findings are inline code paths or examples, and no executable script, cryptographic primitive, or system reconnaissance command was found. A low warning remains because the skill asks the agent to use an external code-search tool for API verification.
낮은 위험 문제 (3)
품질 점수
만들 수 있는 것
에이전트 리서치 워크플로 안정화
체크리스트를 사용해 중복 호출을 줄이고, 할당량 실패를 처리하며, 리서치 세션의 응답성을 유지합니다.
스트리밍 검색 피드백 개선
도구 활동을 명확한 진행 이벤트로 매핑하여 긴 검색 중 사용자가 에이전트의 작업 내용을 볼 수 있게 합니다.
리서치 소스를 명확하게 표시
raw 응답 데이터를 검색 방법별로 그룹화된 읽기 쉬운 소스 카드로 대체합니다.
이 프롬프트를 사용해 보세요
이 스킬을 기준으로 내 리서치 에이전트를 검토하세요. 누락된 rate-limit, 검색, 스트리밍, 소스 렌더링 변경 사항을 식별하세요.
rate-limit 처리 계획을 적용하세요. graceful 429 handling, exponential backoff, quota logging, user-safe errors를 추가하세요.
각 도구 호출이 이름, 쿼리, 결과 수, 소요 시간을 보고하도록 웹 검색 도구와 스트리밍 이벤트를 업데이트하세요.
전체 최적화 체크리스트를 구현한 다음 caching, DuckDuckGo search, SSE progress, source cards, error scenarios를 검증하세요.
모범 사례
- 검색 도구 초기화를 변경하기 전에 현재 DuckDuckGo 패키지 API를 검증하세요.
- 사용자 대상 오류 메시지는 명확하게 유지하고 stack traces 노출은 피하세요.
- 반복 쿼리를 테스트하여 캐싱과 소스 중복 제거가 작동하는지 확인하세요.
피하기
- 할당량 실패를 무기한 재시도하거나 원인을 사용자에게 숨기지 마세요.
- 최종 리서치 경험으로 raw JSON source blocks를 렌더링하지 마세요.
- 활성 도구나 쿼리 컨텍스트를 생략하는 스트리밍 메시지를 추가하지 마세요.