Skip to main content

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

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

Note

  • 이 기능은 현재 공개 미리 보기 버전이며 변경될 수 있습니다.

  • 사용자 지정 지침은 현재 Visual Studio, VS Code, GitHub 웹 사이트의 Copilot Chat에서 지원됩니다.

    이 문서의 버전은 GitHub 웹 사이트의 사용자 지정 지침에 대한 것입니다. 다른 환경에서 사용자 지정 지침을 사용하는 방법에 대한 자세한 내용은 위의 탭을 클릭합니다.

Note

  • 이 기능은 현재 공개 미리 보기 버전이며 변경될 수 있습니다.

  • 사용자 지정 지침은 현재 Visual Studio, VS Code, GitHub 웹 사이트의 Copilot Chat에서 지원됩니다.

    이 문서의 버전은 VS Code의 사용자 지정 지침을 사용하기 위한 것입니다. 다른 환경에서 사용자 지정 지침을 사용하는 방법에 대한 지침은 위의 탭을 클릭합니다.

Note

  • 이 기능은 현재 공개 미리 보기 버전이며 변경될 수 있습니다.

  • 사용자 지정 지침은 현재 Visual Studio, VS Code, GitHub 웹 사이트의 Copilot Chat에서 지원됩니다.

    이 문서의 버전은 Visual Studio의 사용자 지정 지침을 사용하기 위한 것입니다. 다른 환경에서 사용자 지정 지침을 사용하는 방법에 대한 지침은 위의 탭을 클릭합니다.

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

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

필수 조건

  • 아래 지침에서 사용자 지정 지침 파일을 참조하세요.
  • 설정에서 Enable custom instructions 옵션을 활성화해야 합니다. 이 옵션은 기본적으로 사용하지 않도록 설정되어 있습니다. 이 문서의 뒷부분에 있는 사용자 지정 지침 사용 또는 사용 안 함을 참조하세요.

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

  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에서 사용할 수 있습니다. 지침 파일이 포함된 리포지토리와 관련된 채팅 프롬프트에 전체 지침 집합이 자동으로 추가됩니다.

몰입형 모드( https://github.com/copilot 페이지)에서 지침 파일이 포함된 리포지토리를 첨부 파일로 추가하여 사용자 지정 지침을 사용하는 대화를 시작할 수 있습니다.

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

어두운 주황색 윤곽선으로 강조 표시된 'copilot-instructions.md' 파일을 보여 주는 확장된 참조 목록의 스크린샷

참조를 클릭하여 파일을 열 수 있습니다.

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

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

어두운 주황색 윤곽선으로 강조 표시된 'copilot-instructions.md' 파일을 보여 주는 확장된 참조 목록의 스크린샷

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

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

어두운 주황색 윤곽선으로 강조 표시된 'copilot-instructions.md' 파일을 보여 주는 참조 팝업의 스크린샷

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

채팅 질문에 사용자 지정 지침을 추가할지 여부를 선택할 수 있습니다.

  1. 채팅 패널의 위쪽 또는 몰입형 페이지의 오른쪽 위에 있는 단추를 클릭합니다.
  2. Disable custom instructions 또는 Enable custom instructions를 클릭합니다.

선택한 내용은 변경할 때까지 유지됩니다.

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

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

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

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