GitHub Copilot 대한 사용자 지정 지침

Copilot 응답 사용자 지정에 대한 정보

GitHub Copilot 는 선호도, 팀 작동 방식, 사용하는 도구 및 프로젝트의 세부 사항에 맞게 조정된 응답을 제공할 수 있습니다. 프롬프트에 동일한 컨텍스트를 반복적으로 추가하는 대신, Copilot에 이 정보를 자동으로 제공하는 사용자 지정 지침을 만들어 Copilot가 더 높은 품질의 응답을 생성할 수 있도록 할 수 있습니다.

프롬프트 파일은 작업별 지침 및 컨텍스트를 제공하는 Copilot 또 다른 방법을 제공합니다. 사용자 지정 지침과 달리 채팅에서 이를 사용할 시기를 선택합니다. 자세한 내용은 GitHub Copilot용 프롬프트 파일을(를) 참조하세요.

사용 가능한 사용자 지정 명령의 유형과 Copilot 이를 사용하는 기능은 클라이언트 및 환경(GitHub.com, Visual Studio Code, Visual Studio, JetBrains IDEs, Xcode 및 Eclipse)에 따라 달라집니다. 환경에서 지원하는 유형을 확인하려면 다양한 유형의 사용자 지정 지침 지원을 참조하세요. 지원되는 IDE 및 버전은 Copilot 기능 매트릭스을 참조하세요.

참고

AI의 비결정론적 특성으로 인해 Copilot은(는) 매번 정확히 같은 방식으로 사용자 지정 지침을 따르지 않을 수 있습니다.

사용자 지정 지침 유형

사용자 지정 지침은 다양한 수준에 적용될 수 있습니다.

Type	Scope	예제 사용
개인 지침	Copilot와의 대화	선호 언어 또는 응답 스타일과 같은 개인별 기본 설정을 지정합니다.
리포지토리 사용자 지정 지침	리포지토리, 프로젝트, 경로 또는 지원되는 에이전트의 컨텍스트에서 수행된 Copilot와의 대화	프로젝트에 사용되는 언어, 프레임워크, 도구, 아키텍처 및 코딩 규칙을 설명하세요.
조직 사용자 지정 지침	Copilot와의 대화, 조직의 맥락에서 사용되는 경우	조직 전체 언어, 보안, 규정 준수 또는 대응 지침을 제공합니다.

일부 클라이언트(JetBrains IDEs 및 Xcode)는 추가 전역, 작업 영역 또는 프로젝트 지침 메커니즘을 제공합니다. 이러한 메커니즘이 항상 GitHub에서 개인, 리포지토리 및 조직의 지침에 직접 매핑되는 것은 아닙니다.

개인 지침 정보

GitHub.com에 구성된 개인 지침은 GitHub Copilot Chat in GitHub에 적용됩니다. Copilot CLI와 같은 다른 클라이언트는 개인 지침에 로컬 파일을 사용합니다. 에 대한 사용자 지정 지침 추가 GitHub Copilot CLI을(를) 참조하세요.

개인 지침을 추가하여 Copilot Chat에서 GitHub.com가 사용자에게 응답하는 방식을 사용자 지정할 수 있습니다. 이러한 지침은 사용자에게만 적용됩니다. 예를 들어 원하는 언어, 원하는 세부 정보 수준 또는 응답을 구성하는 방법을 지정할 수 있습니다. GitHub Copilot에 대한 개인 사용자 지정 지침 추가을(를) 참조하세요.

리포지토리 사용자 지정 지침 정보

리포지토리 사용자 지정 지침은 프로젝트별 컨텍스트 및 지침을 제공합니다. 예를 들어 리포지토리의 용도, 사용하는 프레임워크 및 도구, 기여자가 따라야 하는 코딩 또는 테스트 규칙을 설명할 수 있습니다.

리포지토리 사용자 지정 지침에는 세 가지 주요 유형이 있습니다.

          **리포지토리 전체 사용자 지정 지침**은 리포지토리 컨텍스트에서 이루어진 모든 요청에 적용됩니다.

이러한 항목은 리포지토리의 .github 디렉터리에 있는 copilot-instructions.md 파일에 지정됩니다.

```
          **경로별 맞춤 지침**은 지정된 경로와 일치하는 파일과 관련된 요청에 적용됩니다.
```
리포지토리 내의 .github/instructions 디렉터리 또는 그 하위에 있는 하나 이상의 NAME.instructions.md 파일에 지정됩니다.

경로별 지침을 사용하면 특정 파일 유형이나 디렉터리에만 적용되는 정보로 인해 저장소 전체 지침이 과도하게 복잡해지는 것을 방지할 수 있습니다.
에이전트 지침은 리포지토리 전체 사용자 지정 지침과 유사하지만 현재 모든 Copilot 기능에서 지원되지 않습니다.

이러한 항목은 AGENTS.md, CLAUDE.md, 또는 GEMINI.md라는 파일에 지정됩니다.

이러한 각 유형의 저장소 맞춤 지침이 다양한 Copilot 기능에서 어떻게 지원되는지에 대한 자세한 내용은 다양한 유형의 사용자 지정 지침 지원을 참조하세요.

큐레이팅된 예제 컬렉션은 사용자 지정 지침을 참조하세요.

이러한 에이전트 지침 파일 AGENTS.md은 지원되는 AI 에이전트에 대한 지침을 제공합니다. 특수 에이전트 및 해당 구성을 정의하는 .github/agents에 저장된 사용자 지정 에이전트 정의 파일과는 다릅니다. Copilot에서 인식하는 에이전트 명령 파일 이름에 대해서는 다양한 유형의 사용자 지정 지침 지원을 참조하세요.

클라이언트 및 인터페이스 전반의 리포지토리 사용자 지정 지침

사용할 수 있는 리포지토리 사용자 지정 지침 유형(리포지토리 전체, 경로별 또는 에이전트 지침)은 사용자 환경 및 작업(예: 채팅, 클라우드에서 작업 또는 끌어오기 요청 검토)에 따라 달라집니다. 예를 들어 환경은 한 작업에 대한 경로별 지침을 지원할 수 있지만 다른 작업에는 지원하지 않을 수 있습니다. 사용 중인 설정에 대한 지원을 확인하려면 다양한 유형의 사용자 지정 지침 지원을 참조하세요. 지원되는 IDE 및 버전은 Copilot 기능 매트릭스을 참조하세요.

조직 맞춤 지침에 대한 정보

참고

지원: 조직 사용자 지정 지침은 현재 GitHub 웹사이트(클라우드 샌드박스 또는 GitHub Actions에서 실행되는 세션)와 Copilot code review의 경우 지원됩니다. 로컬 클라이언트 세션에서는 지원되지 않습니다.

조직 소유자는 Copilot를 조직의 요구 사항 및 기본 설정에 맞추기 위한 지침을 추가할 수 있습니다. 이러한 지침은 해당 조직으로부터 Copilot 구독을 받는지 여부에 관계없이 조직의 모든 구성원에게 사용됩니다.

조직 사용자 지정 지침은 Copilot Enterprise 또는 Copilot Business 구독이 있는 조직에 대해서만 구성할 수 있습니다.

예를 들어 조직 지침은 다음을 수행할 수 있습니다.

응답에 사용해야 하는 언어를 지정합니다.
조직 전체의 보안 또는 규정 준수 지침을 제공합니다.
코드 블록을 생성하지 않는 것과 같은 선호하는 응답 형식을 지정합니다.
특정 항목에 대한 내부 기술 자료 또는 지원 채널로 사람들을 안내합니다.

조직 지침을 추가하는 방법에 대한 자세한 내용은 GitHub Copilot에 대한 조직 사용자 지정 지침 추가을 참조하세요.

사용자 지정 지침의 우선 순위

우선 순위는 클라이언트 및 기능에 따라 달라집니다. Copilot CLI, Visual Studio Code 및 Visual Studio를 포함한 대부분의 환경과 클라이언트는 일반적인 우선순위 순서를 정의하지 않고 적용 가능한 지침 파일을 결합합니다.

Copilot Chat에서 GitHub.com의 경우 모든 관련 지침이 Copilot 제공됩니다. 우선순위는 높은 순서부터 다음과 같습니다.

개인 지침
리포지토리 사용자 지정 지침:
1. .github/instructions/**/*.instructions.md이 포함된 해당 **** 파일
2. 리포지토리 전체 지침.github/copilot-instructions.md에서
3. ** AGENTS.md 파일의 지침과 같은 에이전트 지침**
조직 사용자 지정 지침

가능하면 충돌하는 지침 집합을 제공하지 않도록 합니다. 응답 품질이 우려되는 경우 리포지토리 지침을 일시적으로 사용하지 않도록 설정할 수 있습니다. GitHub Copilot 대한 리포지토리 사용자 지정 지침 추가을(를) 참조하세요.

사용자 지정 지침 사용

사용자 지정 지침은 자연어 명령으로 구성되며, 짧고 자체적으로 완결된 문장일수록 효과적입니다. 개인, 리포지토리 또는 조직 수준에서 추가할지 여부를 결정하기 전에 지침을 적용하려는 범위를 고려하세요.

일반 사용 사례는 다음과 같습니다.

응답 기본 설정. 선호하는 언어, 응답 구조, 톤 또는 설명 수준을 지정합니다.
프로젝트 문맥. 리포지토리의 목적, 아키텍처 또는 도메인을 설명합니다.
언어 및 프레임워크. 프로젝트에서 사용하는 언어, 라이브러리, 프레임워크 및 버전을 식별합니다.
코딩 및 테스트 규칙. 이름 지정, 서식 지정, 테스트, 오류 처리 또는 설명서 표준에 대해 설명합니다.
검토 및 보안 지침. 지원 역할이 코드를 검토하거나 변경할 때 특히 주의해야 하는 문제를 식별합니다.
조직 요구 사항. 조직 전체의 언어 관련, 보안, 규정 준수 또는 지원 지침을 제공합니다.

다음은 그 예입니다.

개인 지침: Always respond in Portuguese.
개인 지침: Explain a single concept per line. Be clear and concise.
리포지토리 지침: Use Vue with the PrimeVue library.
리포지토리 지침: Use early returns whenever possible.
조직 지침: For questions related to security, use the Security Docs Knowledge Base.
조직 지침: Do not generate code blocks in responses.

테스트, 커밋 메시지 또는 코드 검토에 대한 지침은 유용한 컨텍스트를 제공할 수 있습니다. 그러나 Copilot 특정 명령을 사용하는 기능은 클라이언트와 환경에 따라 다르며 사용자 지정 지침은 생성된 콘텐츠가 정책을 준수한다고 보장하지 않습니다.

참고

Copilot는 풀 리퀘스트를 검토할 때 기본 분기가 아니라 헤드 분기(변경 내용이 있는 분기)에서 리포지토리별 사용자 지정 지침, 에이전트 지침, 그리고 에이전트 스킬을 읽습니다. 예를 들어 my-feature-branch을 main에 병합할 때 Copilot는 my-feature-branch의 지침과 기술을 사용하므로, 이를 먼저 병합하지 않고도 동일한 풀 리퀘스트에서 해당 변경 사항을 테스트할 수 있습니다.

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

사용자 지정 명령 파일에 추가하는 지침은 이 리포지토리에서 작동하는 데 도움이 되는 관련 정보를 제공하는 Copilot 짧고 자체 포함된 문이어야 합니다. 지침은 모든 채팅 메시지와 함께 전송되므로 리포지토리의 컨텍스트에서 수행할 대부분의 요청에 광범위하게 적용할 수 있어야 합니다.

지침 파일에 사용하는 정확한 구조는 프로젝트 및 필요에 따라 다르지만 다음 지침은 적절한 시작점을 제공합니다.

목적, 목표 및 관련 배경 정보를 포함하여 작업 중인 프로젝트에 대한 개요를 제공합니다.
명명 규칙, 서식 규칙 및 모범 사례와 같이 따라야 하는 코딩 표준 및 규칙을 지정합니다.
관련 버전 번호 또는 구성과 함께 프로젝트에 사용되는 특정 도구, 라이브러리 또는 프레임워크를 포함합니다.

다음 지침 파일은 작동 중인 이러한 사례의 예입니다.

# Project Overview

This project is a web application that allows users to manage their tasks and to-do lists. It is built using React and Node.js, and uses MongoDB for data storage.

## Libraries and Frameworks

- React and Tailwind CSS for the frontend.
- Node.js and Express for the backend.
- MongoDB for data storage.

## Coding Standards

- Use semicolons at the end of each statement.
- Use single quotes for strings.
- Use function based components in React.
- Use arrow functions for callbacks.

## UI guidelines

- A toggle is provided to switch between light and dark mode.
- Application should have a modern and clean design.

또한 리포지토리의 크기와 복잡성도 고려해야 합니다. 다음 유형의 지침은 소수의 참가자만 있는 소규모 리포지토리에서 작동할 수 있지만 크고 다양한 리포지토리의 경우 문제가 발생할 수 있습니다.

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

예를 들어, 다음 지침은 의도한 결과를 얻지 못할 수 있습니다.

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.

이 기사에서

Copilot 응답 사용자 지정에 대한 정보

사용자 지정 지침 유형

개인 지침 정보

리포지토리 사용자 지정 지침 정보

클라이언트 및 인터페이스 전반의 리포지토리 사용자 지정 지침

조직 맞춤 지침에 대한 정보

사용자 지정 지침의 우선 순위

사용자 지정 지침 사용

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

다음 단계

추가 읽기

이 문서가 도움이 되었나요?

계속 도움이 필요하세요?