Skip to main content

GitHub Copilot에 대한 사용자 지정 지침 추가

Copilot Chat에 묻는 모든 질문에 정보를 자동으로 추가하는 파일을 만들 수 있습니다.

Note

  • 이 기능은 현재 공개 미리 보기 버전이며 변경될 수 있습니다.
  • 사용자 지정 지침은 현재 VS Code 및 Visual Studio의 Copilot Chat에서만 지원됩니다.

GitHub Copilot에 대한 사용자 지정 지침 정보

GitHub Copilot은 충분한 컨텍스트를 제공하는 경우 팀 작동 방식, 사용하는 도구 또는 프로젝트의 세부 사항에 맞게 조정된 채팅 응답을 제공할 수 있습니다. 채팅 질문에 이 상황별 세부 정보를 반복적으로 추가하는 대신 이 정보를 자동으로 추가하는 파일을 만들 수 있습니다. 추가 정보는 채팅에 표시되지 않지만 더 높은 품질의 응답을 생성할 수 있도록 Copilot에서 사용할 수 있습니다.

필수 조건

  • 아래 지침에서 사용자 지정 지침 파일을 참조하세요.

  • 설정에서 지침 파일 사용(VS Code) 또는 사용자 지정 지침 사용(Visual Studio) 옵션을 사용해 보세요. 이 문서의 뒷부분에 있는 "사용자 지정 지침 사용 또는 사용 안 함"을 참조하세요.

    Note

    이 설정은 기본적으로 VS Code에서는 사용하도록 설정되며 Visual Studio에서는 기본적으로 사용하지 않도록 설정됩니다.

사용자 지정 지침 파일 만들기

  1. 리포지토리의 루트에서 이름이 .github/copilot-instructions.md인 파일을 만듭니다.

    .github 디렉터리가 아직 없는 경우, 새로 만듭니다.

  2. 파일에 자연어 지침을 Markdown 형식으로 추가합니다.

    지침 사이의 공백은 무시되므로 지침을 새 줄에 각각 단일 단락으로 작성하거나 가독성을 위해 빈 줄로 구분할 수 있습니다.

샘플 지침

.github/copilot-instructions.md 파일의 이러한 예제에는 모든 채팅 질문에 추가될 세 가지 지침이 포함되어 있습니다.

We use Bazel for managing our Java dependencies, not Maven, so when talking about Java packages, always give me instructions and code samples that use Bazel.

We always write JavaScript with double quotes and tabs for indentation, so when your responses include JavaScript code, please follow those conventions.

Our team uses Jira for tracking items of work.

효과적인 사용자 지정 지침 작성

.github/copilot-instructions.md 파일에 추가하는 지침은 사용자의 채팅 질문을 보완하기 위해 컨텍스트 또는 관련 정보를 추가하는 짧고 자체 포함 문이어야 합니다.

다음 유형의 지침은 원하는 대로 작동하지 않을 수 있으며 Copilot의 다른 영역에 문제가 발생할 수 있습니다.

  • 응답 작성 시 외부 리소스 참조 요청
  • 특정 스타일로 답변하기 위한 지침
  • 항상 특정 수준의 세부 정보로 응답해 달라는 요청

따라서 다음 지침은 의도한 결과를 얻지 못할 가능성이 높습니다.

Always conform to the coding styles defined in styleguide.md in repo my-org/my-repo when generating code.

Use @terminal when answering questions about Git.

Answer all questions in the style of a friendly colleague, using informal language.

Answer all questions in less than 1000 characters, and words of no more than 12 characters.

사용 중인 사용자 지정 지침

.github/copilot-instructions.md 파일의 지침은 파일을 저장하는 즉시 Copilot Chat에서 사용할 수 있습니다. 전체 지침 집합은 VS Code 및 Visual Studio의 Copilot Chat 보기 또는 인라인 채팅에서 제출하는 요청에 자동으로 첨부됩니다.

사용자 지정 지침은 채팅 보기 또는 인라인 채팅에 표시되지 않지만 응답의 참조 목록을 확인하여 Copilot에서 이 지침이 사용되고 있는지 여부를 확인할 수 있습니다. 사용자 지정 지침이 모델에 전송된 프롬프트에 추가된 경우 .github/copilot-instructions.md 파일이 참조로 나열됩니다. 참조를 클릭하여 파일을 열 수 있습니다.

copilot-instructions.md 파일의 참조가 포함된 VS Code의 Copilot Chat 보기 스크린샷

사용자 지정 지침 사용 또는 사용 안 함

채팅 질문에 사용자 지정 지침을 추가할지 여부를 선택할 수 있습니다. 이렇게 하려면 Copilot 확장 설정에서 옵션을 선택하거나 선택 취소합니다.

VS Code에서

  1. 바로 가기 키 Command+,(Mac) / Ctrl+,(Linux/Windows)을 사용하여 설정 편집기를 엽니다.
  2. 검색 상자에 instruction file를 입력합니다.
  3. Code Generation: Use Instruction Files 아래 확인란을 선택하거나 선택 취소합니다.

Visual Studio에서

  1. Visual Studio 도구 모음의 [도구] 아래에서 옵션을 클릭합니다.

    데이터 변수 Visual Studio 메뉴 표시줄의 스크린샷입니다. "도구" 메뉴가 확장되고 "옵션" 항목이 주황색 윤곽선으로 강조 표시됩니다.

  2. "Options" 대화 상자에서 검색 상자에 custom instructions를 입력합니다.

  3. (미리 보기) 사용자 지정 지침을 .github/copilot-instructions.md 파일에서 로드하고 요청에 추가할 수 있도록 설정 확인란을 선택하거나 선택 취소합니다.