GitHub Copilot용 플러그인

플러그인은 관련 사용자 지정을 패키지로 묶어 각각 개별적으로 설정하는 대신 함께 설치하고 관리할 수 있습니다. 예를 들어 테스트 플러그인은 테스트 실행 스킬, 코드 검토용 에이전트 및 테스트 보고 서비스에 대한 MCP 서버를 결합할 수 있습니다.

플러그 인을 사용할 수 있는 위치

플러그 인은 다음 Copilot 표면에서 사용할 수 있습니다.

Visual Studio Code; 채팅 쪽 패널 또는 에이전트 창에서 사용자 지정에서 플러그인을 찾아보거나 설치합니다. VS Code 플러그 인 형식 세부 정보는 에이전트 플러그 인 작성 참조를 참조하세요.
GitHub Copilot CLI; 등록된 마켓플레이스에서 플러그 인을 찾아 설치합니다.
GitHub Copilot app. 사용자 지정에서 플러그 인을 찾아 설치합니다.
Copilot in the cloud; 리포지토리 설정을 통해 플러그 인을 구성합니다.

플러그 인에는 특정 영역에서만 작동하는 구성 요소가 포함될 수 있습니다. 플러그 인이 사용자가 사용하는 표면을 지원하는지 확인합니다. 예를 들어 이 범주에 설명된 LSP 서버 구성은 Copilot CLI용입니다. 자세한 내용은 플러그 인 및 마켓플레이스 참조을(를) 참조하세요.

플러그 인에 포함된 항목

플러그 인은 이러한 구성 요소의 일부 또는 전부를 패키지할 수 있습니다. 사용 가능한 구성 요소 및 해당 위치는 플러그 인 형식 및 표면에 따라 달라집니다.

사용자 지정 에이전트 - 특수 AI 도우미(*.agent.md파일)agents/
스킬 — 작업별 지침, 스크립트 및 리소스(SKILL.md 내의 스킬 하위 디렉터리이며, 각 디렉터리에는 skills/ 파일이 포함됨)
후크 — 에이전트 작업에 응답하는 이벤트 처리기(플러그인 루트의 파일 또는 에 있는 파일)
확장 — 도구 및 슬래시 명령과 같은 기능을 추가하는 Surface 전용 코드
MCP 서버 구성 - 모델 컨텍스트 프로토콜 통합(에이전트 플러그 인 1.0의 루트 mcp.json )
LSP 서버 구성 - 지원되는 화면에서 언어 서버 프로토콜 통합

에이전트 플러그 인은 호환되는 환경에서 플러그 인 매니페스트, 스킬 및 MCP 서버 구성을 공유하는 형식입니다. 에이전트 플러그인 1.0 플러그인은 plugin.json에서 정식 스키마를 선언합니다. 해당 스키마 및 구성 요소 위치는 모든 환경에서 동일한 방식으로 지원되지 않습니다. Copilot CLI 는 레거시 Copilot 플러그 인 형식도 지원합니다. CLI에서 에이전트 플러그 인 스키마가 없는 매니페스트는 이 레거시 형식을 사용합니다.

호환되는 화면에서 스킬 및 MCP 서버를 공유하려는 경우 Agent Plugins을 선택합니다. 구성 가능한 구성 요소 경로가 필요하거나 기존 Copilot 관련 플러그 인을 유지 관리하는 경우 레거시 CLI 형식을 사용합니다.

새 플러그 인의 경우 구성 가능한 구성 요소 경로가 필요하지 않은 경우 에이전트 플러그 인 1.0을 사용합니다. 레거시 형식은 주로 기존 레거시 플러그 인에 사용합니다.

플러그 인의 구조화 방법

플러그 인은 특정 구조와 매니페스트 파일이 있는 디렉터리입니다 plugin.json . 에이전트 플러그 인 1.0에는 플러그 인 루트의 매니페스트가 필요합니다. 레거시 플러그 인은 추가 매니페스트 위치를 지원합니다. 매니페스트는 플러그 인에 이름과 메타데이터를 제공합니다. 형식에 따라 구성 요소를 가리킬 수도 있습니다. 매니페스트와 함께 디렉터리에는 에이전트, 기술, 후크, MCP 서버 구성 및 LSP 서버 구성이 포함될 수 있습니다.

에이전트 플러그 인 1.0 구조체

에이전트 플러그 인 1.0은 호환되는 클라이언트가 검색할 수 있도록 기술 및 MCP 서버를 표준 위치에 저장합니다. 에이전트, 후크, 명령 및 LSP 서버를 비롯한 다른 구성 요소는 클라이언트별로 다릅니다. Copilot는 com.github.copilot 디렉터리에서 이러한 구성 요소를 읽습니다. 다른 클라이언트는 이 디렉터리를 무시하므로 동일한 플러그 인이 공유 기술과 MCP 서버를 특정 구성 요소와 Copilot결합할 수 있습니다.

에이전트 플러그 인 1.0 디렉터리가 다음과 같이 표시됩니다.

my-plugin/
├── plugin.json               # Required manifest
├── skills/                   # Skills (optional)
│   └── deploy/
│       └── SKILL.md
├── mcp.json                  # MCP server config (optional)
└── com.github.copilot/       # Copilot components (optional)
    ├── agents/
    │   └── helper.agent.md
    ├── commands/
    ├── rules/
    ├── hooks/
    │   └── hooks.json
    └── lsp.json

매니페스트에는 에이전트 플러그 인 1.0 $schema이 포함되어야 합니다. 지원되는 최상위 매니페스트 필드, 이름 요구 사항 및 구성 요소 위치는 에이전트 플러그 인 1.0 매니페스트 필드를 참조하세요.

레거시 플러그 인 구조

레거시 Copilot 플러그 인 디렉터리 모양은 다음과 같습니다.

my-plugin/
├── plugin.json           # Required manifest
├── agents/               # Custom agents (optional)
│   └── helper.agent.md
├── skills/               # Skills (optional)
│   └── deploy/
│       └── SKILL.md
├── hooks.json            # Hook configuration (optional)
├── .mcp.json             # MCP server config (optional)
└── lsp.json              # LSP server config (optional)

매니페스트에 포함할 수 있는 전체 필드 집합은 GitHub Copilot CLI 플러그 인 참조을 참조하세요. 플러그 인 작성에 대한 단계별 지침은 에 대한 플러그 인 만들기 GitHub Copilot CLI을 참조하세요.

플러그 인을 사용하는 이유

플러그 인은 다음과 같은 이점을 제공합니다.

프로젝트 간 재사용 가능성
리포지토리 간 공유 Copilot 구성
도메인 전문 지식 공유(예: Rails 전문가 또는 Kubernetes 전문가의 기술 제공)
복잡한 MCP 서버 설정 캡슐화

플러그인이 어디에서 오는지

기본 제공 마켓플레이스는 Visual Studio Code, Copilot CLI, 그리고 GitHub Copilot app의 awesome-copilot입니다. 플러그 인을 사용하려면 먼저 다른 마켓플레이스를 추가해야 합니다.

마켓플레이스를 추가하면 플러그 인을 찾아볼 수 있습니다. 설치하거나 활성화하지 않습니다. 플러그인의 식별자는 플러그인 이름과 마켓플레이스 이름을 결합한 것이 PLUGIN-NAME@MARKETPLACE-NAME입니다. 마켓플레이스 이름은 리포지토리 이름이 아니라 name 파일의 marketplace.json 필드에서 가져옵니다.

플러그인이 활성화되는지 여부를 결정하는 요소

플러그인은 사용 가능, 설치됨 또는 사용 설정됨 상태일 수 있습니다. 마켓플레이스를 추가하면 플러그 인을 찾아볼 수 있습니다. 플러그 인을 설치하면 surface에 추가되고 이를 사용하도록 설정하면 해당 surface의 세션에서 해당 구성 요소를 사용할 수 있습니다. 공유 구성은 기본값을 설정하거나 플러그인이 활성화되는지 여부를 강제할 수 있습니다.

구성 소스	Effect	멤버가 플러그인을 비활성화할 수 있나요?
엔터프라이즈 관리 설정	지원되는 환경에서 플러그 인을 요구하거나 차단합니다.	No. 관리형 정책은 항상 우선 적용됩니다.
엔터프라이즈 팀에서 관리되는 설정	엔터프라이즈 기준 위에 계층화된 엔터프라이즈 팀 파일에 `enabledPlugins`을 통해 필요한 플러그인을 추가합니다.	No. 이러한 항목은 정책에 의해 관리됩니다.
리포지토리 기본값	리포지토리에서 작업하는 모든 사용자에게 플러그 인을 사용하도록 설정합니다.	예. 해당 화면이 로컬 재정의를 지원하는 경우입니다.

리포지토리 기본값은 플러그 인을 필수로 만들지 않습니다. 관리형 정책이 차단하는 플러그인을 사용하도록 설정하거나 정책이 허용하지 않는 마켓플레이스를 사용할 수 없습니다. 선택적 플러그인은 관리되는 설정으로 기본적으로 활성화할 수 없습니다. 해당 항목은 플러그인만 요구하거나 차단합니다.

엔터프라이즈 팀 파일 항목은 엔터프라이즈 기준선에 관리되는 enabledPlugins 항목을 추가합니다. 멤버는 필수 플러그 인을 끌 수 없습니다. 엔터프라이즈 팀에 대한 엔터프라이즈 관리 설정 재정의을(를) 참조하세요.

리포지토리 기본값은 .github/copilot/settings.json를 사용합니다. 구성 및 표면별 로컬 재정의는 GITHUB COPILOT CLI 구성 디렉터리 문서를 참조하세요.

엔터프라이즈 관리자는 추가로 필요한 마켓플레이스와 플러그인 또는 차단할 마켓플레이스와 플러그인을 지정할 수 있습니다. 엔터프라이즈 관리 설정으로 플러그인 마켓플레이스 및 플러그인 관리을(를) 참조하세요.

플러그 인 마켓플레이스의 작동 방식

플러그 인 마켓플레이스는 찾아보고 설치할 수 있는 플러그 인의 레지스트리입니다. 마켓플레이스는 GitHub.com의 리포지토리, 다른 Git 호스트 또는 로컬 디렉터리에서 호스팅될 수 있습니다. 마켓플레이스의 플러그 인은 버전이 지정되므로 마켓플레이스를 사용하면 플러그 인을 보다 쉽게 검색, 설치 및 업데이트할 수 있습니다.

마켓플레이스는 마켓플레이스에 대한 메타데이터를 제공하고 해당 플러그인을 나열하는 marketplace.json 파일로 정의됩니다.

플러그 인을 사용하거나 리포지토리에서 Marketplace에 게시하기 위한 플랫폼별 지침은 GitHub를 참조하세요.

수동 구성과 비교된 플러그 인

플러그 인을 사용하여 추가할 수 있는 모든 기능(예: 사용자 지정 에이전트 프로필 또는 MCP 서버 추가)을 수동으로 구성 Copilot 하여 추가할 수도 있습니다. 그러나 플러그 인은 수동 구성보다 몇 가지 이점을 제공합니다.

특징	리포지토리의 수동 구성	플러그 인
Scope	단일 리포지토리	모든 프로젝트
공유 중	수동 복사/붙여넣기	설치 명령 또는 `enabledPlugins` 항목
버전 관리	Git 기록	Marketplace 버전
발견	리포지토리 검색	Marketplace 둘러보기

GitHub Copilot용 플러그인

누가 이 기능을 사용할 수 있나요?

이 기사에서