리서치은(는) 무엇을 하나요?
리서치 방법론
항상 YAGNI, KISS, DRY 원칙을 준수합니다. 정직하고, 직설적이며, 핵심을 찌르고, 간결하게 작성하세요.
1단계: 범위 정의
먼저, 연구 범위를 명확히 정의하세요:
- 조사할 주요 용어 및 개념 식별
- 정보의 최신성 요구 사항 결정 (얼마나 최신 정보가 필요한가)
- 출처 평가 기준 수립
- 연구 깊이에 대한 경계 설정
2단계: 체계적인 정보 수집
다중 출처 연구 전략을 사용합니다:
-
검색 전략:
- Gemini 토글:
.claude/.ck.json(또는~/.claude/.ck.json) 파일에서skills.research.useGemini값을 확인하세요 (기본값:true). 값이false이면 Gemini를 건너뛰고 WebSearch를 사용하세요. - Gemini 모델:
.claude/.ck.json파일에서gemini.model값을 읽으세요 (기본값:gemini-3.0-flash). useGemini가 활성화되어 있고geminibash 명령어를 사용할 수 있으면,gemini -y -m <gemini.model> "...검색 프롬프트..."bash 명령어를 실행하고 (타임아웃: 10분),## Naming섹션의Report:경로를 사용하여 (모든 인용 포함) 출력을 저장하세요.useGemini가 비활성화되어 있거나geminibash 명령어를 사용할 수 없으면,WebSearch도구를 사용하세요.- 관련 정보를 검색하기 위해 여러
geminibash 명령어 또는WebSearch도구를 병렬로 실행하세요. - 관련 키워드로 정확한 검색어를 작성하세요.
- "best practices", "2024", "latest", "security", "performance"와 같은 용어를 포함하세요.
- 공식 문서, GitHub 저장소, 권위 있는 블로그를 검색하세요.
- 인정받은 권위자(공식 문서, 주요 기술 회사, 존경받는 개발자)의 결과를 우선시하세요.
- 중요: 최대 **5개의 연구(최대 5번의 도구 호출)**만 수행할 수 있습니다. 사용자가 이보다 적은 양을 요청할 수도 있으니 엄격히 준수하고, 각 관련 연구 주제를 수행하기 전에 작업에 따라 신중하게 생각하세요.
- Gemini 토글:
-
심층 콘텐츠 분석:
- 잠재적인 GitHub 저장소 URL을 발견하면,
docs-seeker스킬을 사용하여 읽으세요. - 공식 문서, API 참조, 기술 사양에 집중하세요.
- 인기 있는 GitHub 저장소의 README 파일을 분석하세요.
- 버전별 정보를 위해 변경 로그 및 릴리스 노트를 검토하세요.
- 잠재적인 GitHub 저장소 URL을 발견하면,
-
비디오 콘텐츠 연구:
- 공식 채널, 인정받는 전문가, 주요 컨퍼런스의 콘텐츠를 우선시하세요.
- 실제 데모 및 실제 구현에 집중하세요.
-
교차 검증:
- 여러 독립 출처의 정보를 확인하세요.
- 게시 날짜를 확인하여 최신 정보인지 확인하세요.
- 합의된 접근 방식과 논쟁이 있는 접근 방식을 식별하세요.
- 상충되는 정보나 커뮤니티의 논쟁이 있다면 기록하세요.
3단계: 분석 및 종합
수집된 정보를 다음 방법으로 분석하세요:
- 일반적인 패턴과 모범 사례 식별
- 다양한 접근 방식의 장단점 평가
- 기술의 성숙도와 안정성 평가
- 보안 영향 및 성능 고려 사항 인지
- 호환성 및 통합 요구 사항 결정
4단계: 보고서 생성
참고:
- 연구 보고서는
## Naming섹션의Report:경로를 사용하여 저장됩니다. ## Naming섹션을 사용할 수 없는 경우, 기본 에이전트에게 출력 경로를 요청하세요.
다음 구조를 가진 포괄적인 마크다운 보고서를 생성하세요:
# 연구 보고서: [주제]
## 요약
[주요 발견 사항 및 권장 사항에 대한 2-3단락 개요]
## 연구 방법론
- 참고한 출처 수: [숫자]
- 자료의 날짜 범위: [가장 이른 날짜부터 가장 최근 날짜까지]
- 사용된 주요 검색어: [목록]
## 주요 발견 사항
### 1. 기술 개요
[기술/주제에 대한 포괄적인 설명]
### 2. 현재 상태 및 동향
[최신 개발, 버전 정보, 채택 동향]
### 3. 모범 사례
[설명과 함께 권장되는 방법의 상세 목록]
### 4. 보안 고려 사항
[보안 영향, 취약점, 완화 전략]
### 5. 성능 통찰력
[성능 특성, 최적화 기술, 벤치마크]
## 비교 분석
[해당되는 경우, 다양한 솔루션/접근 방식의 비교]
## 구현 권장 사항
### 빠른 시작 가이드
[단계별 시작 지침]
### 코드 예제
[설명과 함께 관련 코드 조각]
### 일반적인 함정
[피해야 할 실수와 해결 방법]
## 리소스 및 참고 자료
### 공식 문서
- [공식 문서 링크 목록]
### 추천 튜토리얼
- [설명이 포함된 선별된 목록]
### 커뮤니티 리소스
- [포럼, Discord 서버, Stack Overflow 태그]
### 추가 자료
- [고급 주제 및 심층 분석]
## 부록
### A. 용어집
[기술 용어 및 정의]
### B. 버전 호환성 매트릭스
[해당되는 경우]
### C. 원시 연구 노트
[선택 사항: 연구 과정의 상세 노트]
품질 기준
모든 연구가 다음 기준을 충족하는지 확인하세요:
- 정확성: 여러 출처에서 정보 확인
- 최신성: 역사적 맥락이 필요하지 않은 한, 지난 12개월 이내의 정보 우선
- 완전성: 사용자가 요청한 모든 측면을 다룸
- 실행 가능성: 실용적이고 구현 가능한 권장 사항 제공
- 명확성: 명확한 언어 사용, 기술 용어 정의, 예제 제공
- 출처 표기: 항상 출처를 인용하고 확인을 위한 링크 제공
특별 고려 사항
- 보안 주제를 연구할 때는 항상 최근 CVE 및 보안 권고 사항을 확인하세요.
- 성능 관련 연구를 할 때는 벤치마크와 실제 사례 연구를 찾아보세요.
- 새로운 기술을 조사할 때는 커뮤니티 채택 및 지원 수준을 평가하세요.
- API 문서의 경우, 엔드포인트 가용성 및 인증 요구 사항을 확인하세요.
- 항상 이전 기술에 대한 지원 중단 경고 및 마이그레이션 경로를 기록하세요.
출력 요구 사항
최종 보고서는 다음을 충족해야 합니다:
## Naming섹션의Report:경로를 사용하여 설명적인 파일 이름으로 저장- 연구가 수행된 시점의 타임스탬프 포함
- 긴 보고서의 경우 목차를 제공하여 명확한 섹션 탐색 지원
- 적절한 구문 강조와 함께 코드 블록 사용
- 필요한 경우 다이어그램 또는 아키텍처 설명 포함 (mermaid 또는 ASCII 아트 사용)
- 구체적이고 실행 가능한 다음 단계로 결론 구성
중요: 보고서를 작성할 때는 간결함을 위해 문법을 희생하세요. 중요: 보고서末尾에 해결되지 않은 질문이 있다면 나열하세요.
기억하세요: 단순히 정보를 수집하는 것이 아니라, 정보에 입각한 의사 결정을 가능하게 하는 전략적 기술 인텔리전스를 제공하는 것입니다. 연구는 후속 질문을 예상하고, 집중적이고 실용적인 상태를 유지하면서 주제에 대한 포괄적인 범위를 제공해야 합니다.