AI로 작업할 때는 맥락이 중요합니다. 모든 코드베이스에는 고유한 내부 규칙이 있습니다. 컴포넌트를 어떻게 구성하는지, 어떤 스크립트를 실행하는지, 그리고 어떤 프레임워크와 파일 유형에 어떤 컨벤션이 적용되는지 등입니다.
Copilot은 프로젝트 전반의 변경 작업을 도울 수 있지만, 그러한 규칙들을 Copilot이 알고 있을 때 가장 잘 작동합니다. 이러한 지식의 상당 부분을 저장소 안에 담아둘 수 있으므로, 새로운 작업을 시작할 때마다 동일한 표준, 스크립트, 워크플로를 일일이 설명할 필요 없이 Copilot이 자동으로 이를 파악할 수 있습니다.
이 GitHub Copilot 초보자용 앱 시리즈의 이번 편에서는 Copilot이 여러분의 프로젝트와 작동하는 방식을 맞춤화하는 네 가지 방법을 살펴봅니다:
- 사용자 지정 지침은 Copilot이 따라야 할 규칙을 전달합니다.
- 에이전트 스킬은 반복 가능한 절차를 패키지로 담습니다.
- 커스텀 에이전트는 더 큰 작업에 전문화된 지침을 제공합니다.
- MCP(Model Context Protocol) 서버는 Copilot을 외부 도구 및 데이터 소스에 연결하여 Copilot이 할 수 있는 일의 범위를 넓혀줍니다.
각각이 어떻게 작동하는지, 그리고 서로 어떻게 함께 작동할 수 있는지 살펴보겠습니다.
사용자 지정 지침으로 시작하기
애플리케이션에 사용자 지정 페이지 크기를 추가하라고 Copilot에 요청한다고 가정해 보세요. 변경을 적용하는 것은 작업의 일부일 뿐입니다. 새 코드는 팀이 이미 사용하는 패턴도 따라야 합니다.
저장소 사용자 지정 지침 해당 기본 컨텍스트를 Copilot에 제공하세요. 다음을 추가하세요. .github/copilot-instructions.md 저장소 전체에 적용되는 지침, 예를 들어 선호하는 아키텍처, 네이밍 규칙, 테스트 및 검증에 대한 기대치 등을 정의하기 위한 파일입니다.
안에 경로별 지시 파일을 생성할 수도 있습니다 .github/instructions. 이 파일들은 applyTo 필드를 사용하여 Copilot에 해당 지침이 언제 관련이 있는지 알려줍니다.
Copilot이 일치하는 파일에서 작업할 때는 저장소 전체 지침과 더 구체적인 안내를 모두 사용할 수 있습니다. 덕분에 모든 파일 유형을 같은 틀에 맞추지 않고도 폭넓은 규칙을 한곳에 유지할 수 있습니다.
반복 가능한 절차를 에이전트 스킬로 패키징하세요
커스텀 지침은 여러 작업에 적용되어야 하는 표준에 유용합니다. 하지만 어떤 지침은 Copilot이 품질 검사 실행, 릴리스 준비, 실패한 워크플로 디버깅과 같은 특정 절차를 수행할 때에만 중요합니다.
그것이 바로 에이전트 스킬 들어올 수 있습니다. 스킬(skill)은 지침을 담고 있는 폴더로, 선택적으로 스크립트 및 기타 리소스를 포함할 수 있으며 Copilot이 관련성이 있을 때 이를 불러올 수 있습니다. 프로젝트 수준의 스킬은 다음 위치에 둘 수 있습니다. .github/skills, 각 스킬은 자체 하위 폴더에 있습니다.
예를 들어, .github/skills/quality-checks 폴더에는 다음이 포함될 수 있습니다 SKILL.md 설명하는 파일:
- Copilot가 스킬을 사용해야 하는 시점.
- 프로젝트의 테스트와 린팅을 실행하는 스크립트입니다.
- 각 스크립트가 검사하는 항목.
- 일반적인 고장을 해결하는 방법.
의 설명은 SKILL.md Copilot이 해당 스킬이 언제 적용되는지 판단하는 데 도움을 줍니다. 인터페이스를 업데이트한 후에는 Copilot이 quality-checks 스킬을 로드하고 어떤 명령을 실행해야 할지 추측하는 대신 프로젝트에서 정립된 테스트 및 린팅 프로세스를 따를 수 있습니다.
더 광범위하고 전문적인 작업에는 커스텀 에이전트 사용
일부 작업은 단일 절차보다 큽니다. 예를 들어 접근성 검토는 Copilot이 여러 파일에 걸쳐 컴포넌트, 템플릿, 스타일, 상호작용을 검사해야 할 수 있습니다.
커스텀 에이전트 를 사용하면 이런 작업을 위한 특화된 버전의 Copilot을 만들 수 있습니다. 리포지토리 수준의 에이전트 프로필은 .github/agents 에 위치하며 에이전트의 목적, 지침, 도구, 관련 프로젝트 컨텍스트를 정의할 수 있습니다.
반복적으로 발생하는 유형의 작업이 전용 역할이나 관점의 도움을 받을 수 있다면, 특히 작업이 여러 파일에 걸치고 여러 도구나 컨텍스트 소스를 활용해야 할 때 커스텀 에이전트를 사용하세요.
MCP 서버로 Copilot을 외부 도구에 연결
지침, 스킬, 에이전트는 Copilot이 프로젝트 내에서 작업하는 방법을 이해하도록 돕습니다. MCP 서버는 리포지토리 너머에서 접근하고 수행할 수 있는 범위를 확장합니다.
MCP 서버 는 Copilot을 외부 도구, 데이터 소스, 서비스에 연결합니다. 문서화 서버는 프레임워크 가이드에 대한 접근을 제공할 수 있고, Playwright 같은 서버는 브라우저에서 애플리케이션을 열고 상호작용할 수 있게 해줍니다.
Copilot 앱에서 사용 가능한 MCP 서버를 탐색하거나 사용자 지정 서버를 추가할 수 있습니다. Playwright가 구성되면 다음과 같이 요청할 수 있습니다: Playwright MCP 서버를 사용하여 기능을 수동으로 테스트해줘.
그러면 Copilot은 Playwright를 사용하여 브라우저에서 애플리케이션을 열고 여러분이 하듯이 상호작용할 수 있습니다. 이를 통해 코드가 자동화된 검사를 통과할 뿐만 아니라 업데이트된 인터페이스가 기대대로 동작하는지도 검증할 수 있습니다.
적절한 사용자 지정 유형 선택하기
이러한 사용자 지정은 서로 다른 문제를 해결하지만, 결합하면 더욱 유용해집니다:
- 사용자 지정 지침(Custom instructions) 은(는) Copilot이 저장소 전체 또는 특정 파일에 대해 따라야 할 규칙을 정의합니다.
- 에이전트 스킬(Agent skills) 은(는) 관련성이 있을 때 Copilot이 불러올 수 있는 반복 가능한 절차를 패키지화합니다.
- 사용자 지정 에이전트(Custom agents) 는(은) 더 넓은 작업을 위한 집중된 전문 지식과 안내를 제공합니다.
- MCP 서버(MCP servers) 는(는) Copilot을 외부 도구, 서비스, 데이터 소스에 연결하여 Copilot이 할 수 있는 일을 확장합니다.
함께 가져가세요
Copilot에 유용한 프로젝트 컨텍스트를 제공하는 것은 네 가지 질문에서 시작됩니다:
- 내가 계속 설명하게 되는 프로젝트 규칙은 무엇인가?
- 내가 반복하는 다단계 절차는 무엇인가?
- 어떤 복잡한 작업이 전용 사용자 지정 에이전트의 도움을 받을 수 있는가?
- Copilot에 필요한 외부 도구나 소스는 무엇인가?
어디서 시작해야 할지 모르겠나요? 커뮤니티가 바로 사용할 수 있는 지침, 스킬, 에이전트 등을 Awesome Copilot을 통해 공유했습니다. 이미 반복하고 있는 워크플로를 다루는 것을 찾아, 내용을 검토하고, 여러분의 저장소 도구와 표준에 맞게 조정해 보세요.
작게 시작하세요: 계속 설명하게 되는 규칙 하나를 골라 .github/copilot-instructions.md에 추가하고, Copilot이 다음 작업에 이를 어떻게 적용하는지 확인해 보세요.
이 글 GitHub Copilot 초보자용 앱: Copilot에게 코드베이스를 가르치는 방법 은(는) 다음에서 처음 게시되었습니다: The GitHub Blog.