GitHub Copilot 명령 줄 인터페이스 (CLI)에 사용자 지정 지침을 추가하는 방법입니다.

Copilot에게 프로젝트를 이해하는 방법과 변경 사항을 빌드, 테스트 및 검증하는 방법에 대한 추가적인 맥락을 제공합니다.

이 기사에서

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

사용자 지정 지침 유형

GitHub Copilot 명령 줄 인터페이스 (CLI)는 다음과 같은 유형의 사용자 지정 지침을 지원합니다.

리포지토리 전체 사용자 지정 지침

이러한 요청은 리포지토리의 컨텍스트에서 수행한 모든 요청에 적용됩니다.

이는 리포지토리의 루트에 있는 copilot-instructions.md 디렉터리의 .github 파일에 지정됩니다. 리포지토리 전체 사용자 지정 지침 생성하기를 참조하세요.

경로별 사용자 지정 지침

지정된 경로와 일치하는 파일 컨텍스트에서 수행한 요청에 적용됩니다.

이러한 파일은 리포지토리의 루트에 있는 NAME.instructions.md 디렉터리 내 또는 아래에 있는 하나 이상의 .github/instructions 파일 또는 현재 작업 디렉터리의 .github/instructions 디렉터리 내 또는 아래에 지정됩니다. 경로별 사용자 지정 지침 생성하기를 참조하세요.

이러한 지침에 지정한 경로가 Copilot이(가) 작업 중인 파일과 일치하고 리포지토리 전체의 사용자 지정 명령 파일도 있는 경우 두 파일의 지침이 모두 사용됩니다. Copilot에서 상충하는 명령 중 어느 것을 따를지 비결정적으로 선택하므로, 명령 간 잠재적 충돌을 피해야 합니다.

에이전트 지침

다양한 AI 에이전트에서 사용됩니다.

하나 이상의 AGENTS.md 파일을 만들 수 있습니다. 이러한 디렉터리는 리포지토리의 루트 디렉터리, 현재 작업 디렉터리 또는 환경 변수의 쉼표로 구분된 경로 목록으로 지정된 디렉터리에 있을 수 있습니다 COPILOT_CUSTOM_INSTRUCTIONS_DIRS .

루트 디렉터리에 있는 파일의 AGENTS.md 지침(있는 경우)은 기본 지침으로 처리됩니다. AGENTS.md 파일과 .github/copilot-instructions.md 파일이 모두 리포지토리의 루트에 있는 경우 두 파일의 지침이 모두 사용됩니다.

다른 AGENTS.md 파일에 있는 지침은 추가 지침으로 처리됩니다. 발견된 주요 지침은 추가 지침보다 Copilot의 응답에 더 큰 영향을 미칠 가능성이 높습니다.

자세한 내용은 agentsmd/agents.md 리포지토리를 참조하세요.

다른 방법으로, CLAUDE.md 및 GEMINI.md 파일을 사용할 수 있습니다. 리포지토리의 루트에 위치해야 합니다.

로컬 지침

이는 특정 로컬 환경 내에서 적용됩니다.

          `$HOME/.copilot/copilot-instructions.md` 파일을 생성하여 사용자 고유의 홈 디렉터리 내에 지침을 지정할 수 있습니다.

환경 변수를 COPILOT_CUSTOM_INSTRUCTIONS_DIRS 쉼표로 구분된 디렉터리 목록으로 설정할 수도 있습니다. 코파일럿 CLI는 각 디렉터리에서 AGENTS.md 파일과 모든 .github/instructions/**/*.instructions.md 파일을 찾습니다.

리포지토리 전체 사용자 지정 지침 생성하기

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

    아직 없는 경우 .github 디렉터리를 만듭니다.

  2. 파일에 자연어 지침을 Markdown 형식으로 추가하세요

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

    효과적인 사용자 지정 지침을 작성하는 방법에 대한 도움말은 GitHub Copilot 응답을 사용자 지정하는 방법에 대한 정보을 참조하세요.

경로별 사용자 지정 지침 만들기

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

  2. 필요에 따라 .github/instructions의 하위 디렉터리를 만들어 명령 파일을 체계적으로 정리할 수 있습니다.

  3. 하나 이상의 NAME.instructions.md 파일을 만드세요. 여기서 NAME은 지침의 목적을 나타냅니다. 파일 이름은 .instructions.md로 끝나야 합니다.

  4. 파일의 시작 부분에, applyTo 키워드를 포함하는 프론트매터 블록을 만드세요. glob 구문을 사용하여 지침이 적용될 파일이나 디렉터리를 지정합니다.

    예시:

    ---
applyTo: "app/models/**/*.rb"
---

    쉼표로 여러 패턴을 구분하여 지정할 수 있습니다. 예를 들어, 리포지토리의 모든 TypeScript 파일에 지침을 적용하려면, 다음과 같은 프론트매터 블록을 사용할 수 있습니다.

    ---
applyTo: "**/*.ts,**/*.tsx"
---

    Glob 예제:

    •      `*` - 현재 디렉터리의 모든 파일과 일치합니다.

    •      `**` 또는 `**/*` - 모든 디렉터리에 있는 모든 파일과 일치합니다.

    •      `*.py` - 현재 디렉터리의 모든 `.py` 파일과 일치합니다.

    •      `**/*.py` - 모든 디렉터리에 있는 모든 `.py` 파일을 재귀적으로 일치합니다.

    •      `src/*.py` - `.py` 디렉터리 내 모든 `src` 파일을 일치시킵니다. 예를 들어, `src/foo.py` 와 `src/bar.py` 그러나 _아니_`src/foo/bar.py`.

    •      `src/**/*.py` - 디렉터리의 모든 `.py` 파일 `src` 과 재귀적으로 일치합니다. 예: `src/foo.py`, `src/foo/bar.py`및 `src/foo/bar/baz.py`.

    •      `**/subdir/**/*.py` - 모든 `.py` 디렉터리의 깊은 곳에 있는 모든 `subdir` 파일을 재귀적으로 일치시킵니다. 예를 들어 `subdir/foo.py`, `subdir/nested/bar.py`, `parent/subdir/baz.py`, `deep/parent/subdir/nested/qux.py`와 같은 경우에는 사용되지만, _디렉터리_`foo.py`가 포함되지 않은 `subdir` 경로에서는 사용되지 않습니다.

  5. 파일이 Copilot 코딩 도우미 또는 Copilot 코드 검토에 의해 사용되는 것을 방지하려면, 프런트매터 블록의 앞부분에 excludeAgent 키워드를 추가하십시오. 또는 "code-review"``"coding-agent".를 사용합니다.

    예를 들어 다음 파일은 Copilot 코딩 도우미에서만 읽힙니다.

    ---
applyTo: "**"
excludeAgent: "code-review"
---

    키워드가 excludeAgent 프론트 머터블록에 포함되지 않은 경우, Copilot 코드 검토와 Copilot 코딩 도우미는 둘 다 귀하의 지침을 사용합니다.

  6. Markdown 형식을 사용하여 자연어로 사용자 지정 지침을 추가합니다. 지침 사이의 공백은 무시되므로 지침을 새 줄에 각각 단일 단락으로 작성하거나 가독성을 위해 빈 줄로 구분할 수 있습니다.

리포지토리에 사용자 지정 지침 파일을 성공적으로 추가했나요?

          <a href="https://docs.github.io/success-test/yes.html" target="_blank" class="btn btn-outline mt-3 mr-3 no-underline">
          <span>예</span></a><a href="https://docs.github.io/success-test/no.html" target="_blank" class="btn btn-outline mt-3 mr-3 no-underline"><span>아니오</span></a>

사용 중인 사용자 지정 지침

파일의 지침은 파일을 저장하는 즉시 Copilot가 사용할 수 있습니다. 제출한 요청에 지침이 Copilot자동으로 추가됩니다.

CLI 세션 중에 사용자 지정 지침을 변경하면 다음에 현재 또는 향후 세션에서 프롬프트를 제출할 때 Copilot에서 변경 내용을 사용할 수 있습니다.

추가 읽기

  •         [AUTOTITLE](/copilot/reference/custom-instructions-support)

  •         [AUTOTITLE](/copilot/tutorials/customization-library/custom-instructions) - 큐레이팅된 예제 컬렉션

  •         [AUTOTITLE](/copilot/tutorials/use-custom-instructions)