Skip to main content

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

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

Note

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

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

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

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

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

또한 사용자로서 GitHub에서 Copilot Chat과 나누는 대화에 적용되는 개인 사용자 지정 지침을 만들 수도 있습니다. 이는 단일 리포지토리의 컨텍스트에서 대화에 적용되는 리포지토리 사용자 지정 지침과 다릅니다. 개인 지침에 대한 자세한 내용은 GitHub Copilot에 대한 개인 사용자 지정 지침 추가을(를) 참조하세요.

필수 조건

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

리포지토리 사용자 지정 지침 파일 만들기

  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' 파일을 보여 주는 확장된 참조 목록의 스크린샷

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

Note

개인 사용자 지정 지침은 리포지토리 사용자 지정 지침보다 우선하지만 둘 다 Copilot Chat에 제공되는 최종 프롬프트에 통합됩니다. 가능하면 개인 및 리포지토리 지침이 충돌하지 않도록 해야 합니다. 응답 품질이 우려되는 경우 리포지토리 지침을 일시적으로 사용하지 않도록 선택할 수도 있습니다. 자세한 내용은 GitHub Copilot에 대한 리포지토리 사용자 지정 지침 추가을(를) 참조하세요.

리포지토리 사용자 지정 지침 사용 또는 사용 안 함

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

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

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