GitHub Copilot CLI를 통한 연구

/research 슬래시 명령을 사용하여 복잡한 토픽을 조사하고 코드베이스, GitHub의 리포지토리 및 웹 소스에서 인용된 보고서를 생성합니다.

누가 이 기능을 사용할 수 있나요?

GitHub Copilot CLI 는 모든 Copilot 계획에서 사용할 수 있습니다. 조직으로부터 Copilot를 수신하는 경우, 조직의 설정에서 Copilot CLI 정책이 사용하도록 설정되어야 합니다.

이 기사에서

연구 정보 소개 Copilot CLI

/research 슬래시 명령은 특수 연구 에이전트를 호출합니다. 토픽을 조사하고 인용된 Markdown 보고서를 생성합니다. 에이전트는 로컬 코드베이스, 조직 전체의 공용 및 액세스 가능한 프라이빗 리포지토리 및 웹에서 정보를 수집할 수 있습니다.

리서치는 심층 조사가 필요한 복잡한 질문에 최적화되어 있습니다. Copilot 표면 전반의 연구에 대한 개요는 에이전트를 사용한 연구을 참조하세요.

연구 조사 수행

  1. 대화형 Copilot CLI 세션에서 다음을 입력합니다:

    Copilot prompt
    /research TOPIC

TOPIC를 조사하려는 내용에 대한 자연어 설명으로 대체합니다.

  1. 요청되면 에이전트에 필요한 권한을 검토하고 승인합니다. 예를 들어 에이전트는 연구를 정리하는 동안 데이터를 저장할 디렉터리를 만들 수 있는 권한을 요청할 수 있습니다.
  2. 연구가 완료될 때까지 기다리세요. Copilot 는 주요 결과 요약을 표시합니다. 또한 전체 Markdown 보고서에 대한 링크를 제공합니다.
  3. 보고서 출처 및 문서화된 가정을 포함하여 보고서를 검토합니다.

효과적인 연구 프롬프트 작성

질문, 범위 및 원하는 응답 유형을 명시합니다. 관련된 경우 조사할 리포지토리, 구성 요소, 기술, 제약 조건 또는 기간을 포함합니다.

연구 에이전트는 질문에 맞게 보고서를 조정합니다.

  • 절차 관련 질문은 일반적으로 단계별 지침을 제공합니다.
  • 개념적 질문은 일반적으로 설명과 장단점을 생성합니다.
  • 기술 심층 분석에서는 아키텍처 다이어그램 및 코드 예제를 포함할 수 있습니다.

다음은 몇 가지 예제 연구 프롬프트와 그들이 잘 작동하는 이유에 대한 설명입니다.

코드베이스 아키텍처

Copilot prompt
/research What is the architecture of this codebase?

잘 작동하는 이유: 연구 에이전트는 현재 작업 디렉터리 범위로 지정된 grep, glob, 그리고 view 도구에 액세스할 수 있습니다. 전체 프로젝트 트리를 탐색하고, 키 파일을 읽고, 아키텍처 개요를 합성할 수 있습니다. 일반적인 채팅 응답은 피상적으로만 수행할 수 있습니다. 에이전트는 일반적으로 아키텍처 다이어그램, 구성 요소 분석 및 데이터 흐름 설명을 생성합니다.

특정 기술의 작동 방식

Copilot prompt
/research How does React implement concurrent rendering?

잘 작동하는 이유: 에이전트는 특수 도구를 사용하여 인터넷에서 정보를 가져오고 실제 React 소스 코드를 확인합니다 GitHub. 설명서보다 코드의 우선 순위를 지정하고 파일 경로에 줄 번호를 제공하도록 지시됩니다.

내부 구현 패턴 이해

Copilot prompt
/research How are feature flags implemented at our organization?

잘 작동하는 이유: 에이전트는 "항상 공용/오픈 소스 대안보다 내부/프라이빗 구현의 우선 순위를 지정"하고 쿼리를 사용하여 org:ORGNAME 조직의 리포지토리를 먼저 검색하도록 명시적으로 지시됩니다. 다음과 같은 -hub``-service``-client내부 명명 패턴을 찾는 것을 알고 있습니다.

기술 또는 접근 방식 비교

Copilot prompt
/research What's the difference between JWT and session-based authentication?

잘 작동하는 이유: 에이전트는 이야기가 있는 설명, 장단점 및 디자인 결정을 통해 "개념적/설명적 질문"에 대한 응답을 조정합니다. 일반적으로 테이블을 사용하여 세 개 이상의 항목을 비교합니다.

프로세스/방법 질문

Copilot prompt
/research How do I add an endpoint to the API?

잘 작동하는 이유: 에이전트는 쿼리 유형을 검색하고 프로세스/방법 입력 질문에 대한 관련 문서, 연락처 및 시스템에 대한 링크와 함께 단계별 지침을 제공하도록 학습됩니다.

특정 코드베이스 구성 요소에 대한 심층 분석

Copilot prompt
/research How is the session management system implemented in this repo?

잘 작동하는 이유: 로컬 도구(grep, glob, view)를 에이전트의 지침과 결합하여 "가져오기, 호출 및 형식 참조 추적" 및 "종속성 준수"는 높은 수준의 답변을 제공하는 것이 아니라 실제 구현을 안내한다는 것을 의미합니다.

연구 보고서 보기 및 공유

연구가 완료되면 표시된 링크를 사용하여 기본 Markdown 편집기에서 전체 보고서를 열기 위해 엽니다. 또는 Ctrl+Y 를 눌러 현재 세션에서 가장 최근의 연구 보고서를 엽니다.

참고

Ctrl+Y에서 사용하는 편집기는 해당 순서대로 COPILOT_EDITOR, VISUAL, 또는 EDITOR 환경 변수에 의해 결정됩니다. Linux 및 macOS에서 이러한 변수가 설정되지 않은 경우 Copilot CLI는 vi를 사용합니다.

연구 보고서가 포함된 GitHub gist를 만들려면 다음을 입력합니다.

Copilot prompt
/share gist research

보고서를 파일로 저장하려면 다음을 입력합니다.

Copilot prompt
/share file research [PATH]

[PATH]를 생략하면 보고서는 연구 항목을 기반으로 하는 파일 이름을 사용하여 현재 작업 디렉터리에 저장됩니다.

화살표 키와 Enter 키를 사용하여 현재 세션 중에 만든 보고서를 선택합니다. Copilot CLI 그런 다음, gist의 URL 또는 저장된 파일의 경로를 표시합니다.

Considerations

  • 리서치 보고서는 세션에 속합니다: 보고서 선택기 및 Ctrl+Y 바로 가기는 현재 세션의 보고서만 표시합니다. ~/.copilot/session-state/SESSION-ID/research/에서 이전 세션의 보고서에 계속 액세스할 수 있습니다.
  • 리서치는 전용 모델을 사용합니다. 리서치 에이전트는 주 세션에 대해 선택한 모델에 관계없이 구성된 모델을 사용합니다. /model로는 리서치 모델을 변경할 수 없습니다.
  • 연구는 일반 채팅보다 오래 걸립니다. 에이전트는 여러 원본을 검색하고 자세한 보고서를 생성합니다. 빠르게 답할 수 있는 범위가 좁은 질문에 대한 일반 프롬프트를 사용합니다.
  • 연구는 코드를 변경하지 않습니다. 연구 워크플로는 프로젝트를 수정하는 대신 결과를 생성합니다. 변경 내용을 구현할 준비가 되면 일반 에이전트 작업을 시작하거나 다시 시작합니다.