GitHub Copilot CLI 플러그 인 참조

플러그 인의 정의 및 클라이언트에서 Copilot 작동하는 방식에 대한 개요는 플러그 인 정보 GitHub Copilot을 참조하세요.

CLI 명령

터미널에서 다음 명령을 사용하여 플러그 인 코파일럿 CLI을 관리할 수 있습니다. copilot plugin와 copilot plugins는 서로 바꿔 사용할 수 있으므로, 하위 명령에 더 자연스러운 표현을 사용하세요.

비대화형으로 copilot plugins enable NAME --plugin, copilot plugins disable NAME --plugin 및 copilot plugins remove NAME --plugin는 동일한 활성화, 비활성화 및 제거 작업을 제공합니다. --plugin 는 기본 종류이며 이러한 세 가지 명령에 대해 생략할 수 있습니다. 이러한 명령을 MCP 서버 및 기술로 확장하는 비대화형 및 --mcp 종류는 --skill을 참조하세요.

명령에 대한 install 플러그 인 사양

copilot plugins install 옵션

사양에서 플러그 인을 설치하는 것 외에도 파일, copilot plugins install URL 또는 디렉터리 --skill에서 개별 기술을 설치할 수 있습니다. 기술 설치는 플러그 인 설치가 아니며 마켓플레이스를 거치지 않습니다. 기술 자체에 대한 자세한 내용은 GitHub Copilot CLI 명령 참조 을 참조하세요.

디렉터리를 설치하면 디렉터리를 복사하는 대신 사용자 지정 기술 원본으로 등록합니다. 파일 또는 URL을 설치하면 기술 콘텐츠가 개인 또는 프로젝트 기술 디렉터리에 복사됩니다.

MCP 서버는 인증 및 대화형 비밀 항목이 필요한 정책 구성 레지스트리에서 설치됩니다. copilot plugins install 대신 /plugins 대시보드(온라인 모드) 또는 /mcp 슬래시 명령을 사용해 MCP 서버를 추가하세요.

copilot plugins update 옵션

copilot plugins marketplace 하위 명령어

기본 제공 마켓플레이스는 런타임과 함께 제공되며 제거할 수 없습니다.

plugin.json

모든 플러그 인은 플러그 인 디렉터리의 루트에 있는 plugin.json 매니페스트 파일을 포함하는 플러그 인 디렉터리로 구성됩니다. 에 대한 플러그 인 만들기 GitHub Copilot 명령 줄 인터페이스 (CLI)을(를) 참조하세요.

필수 필드

선택적 메타데이터 필드

구성 요소 경로 필드

그러면 플러그 인의 구성 요소를 찾을 수 있는 위치를 CLI에 알립니다. 모두 선택 사항입니다. 생략하면 CLI는 기본 규칙을 사용합니다.

예제 plugin.json 파일

{
  "name": "my-dev-tools",
  "description": "React development utilities",
  "version": "1.2.0",
  "author": {
    "name": "Jane Doe",
    "email": "jane@example.com"
  },
  "license": "MIT",
  "keywords": ["react", "frontend"],
  "agents": "agents/",
  "skills": ["skills/", "extra-skills/"],
  "hooks": "hooks.json",
  "mcpServers": ".mcp.json"
}

{
  "name": "my-dev-tools",
  "description": "React development utilities",
  "version": "1.2.0",
  "author": {
    "name": "Jane Doe",
    "email": "jane@example.com"
  },
  "license": "MIT",
  "keywords": ["react", "frontend"],
  "agents": "agents/",
  "skills": ["skills/", "extra-skills/"],
  "hooks": "hooks.json",
  "mcpServers": ".mcp.json"
}

LSP 서버 구성

플러그인에 LSP(언어 서버 프로토콜) 서버를 포함하려면 플러그인 디렉터리에 lsp-config/servers.json 파일을 만들거나, lspServers의 plugin.json 필드를 사용하여 경로 또는 인라인 객체를 지정합니다.

예제 lsp-config/servers.json(또는 lspServers에서 plugin.json을 통한 인라인 방식):

{
    "lspServers": {
        "my-lsp": {
            "command": "my-language-server",
            "fileExtensions": { ".myext": "mylang" }
        }
    }
}

플랫폼 간 지원을 위해 bash 대신 powershell 및 command을 사용하세요:

{
    "lspServers": {
        "my-lsp": {
            "bash": "${PLUGIN_ROOT}/scripts/start-lsp.sh",
            "powershell": "${PLUGIN_ROOT}/scripts/start-lsp.ps1",
            "fileExtensions": { ".myext": "mylang" }
        }
    }
}

(*) 하나 이상의 command, bash또는 powershell 필수입니다. bash 및 powershell 모두 지정되면 플랫폼에 적합한 항목이 자동으로 선택됩니다(Windows PowerShell, 다른 위치의 Bash).

플러그 인 디렉터리 내의 경로를 참조하는 데 사용합니다 ${PLUGIN_ROOT} .

marketplace.json

리포지토리의 marketplace.json 디렉터리에 .github/plugin/ 파일을 만들어 저장하면, 사람들이 플러그인을 검색하고 설치할 수 있는 플러그인 마켓플레이스를 만들 수 있습니다. 파일을 로컬 파일 시스템에 저장할 수도 있습니다 marketplace.json. 예를 들어 파일을 다음과 같이 /PATH/TO/my-marketplace/.github/plugin/marketplace.json 저장하면 다음 명령을 사용하여 CLI에 파일을 추가할 수 있습니다.

copilot plugin marketplace add /PATH/TO/my-marketplace

자세한 내용은 에 대한 플러그 인 마켓플레이스 만들기 GitHub Copilot 명령 줄 인터페이스 (CLI)을(를) 참조하세요.

예제 marketplace.json 파일

{
  "name": "my-marketplace",
  "owner": {
    "name": "Your Organization",
    "email": "plugins@example.com"
  },
  "metadata": {
    "description": "Curated plugins for our team",
    "version": "1.0.0"
  },
  "plugins": [
    {
      "name": "frontend-design",
      "description": "Create a professional-looking GUI ...",
      "version": "2.1.0",
      "source": "./plugins/frontend-design"
    },
    {
      "name": "security-checks",
      "description": "Check for potential security vulnerabilities ...",
      "version": "1.3.0",
      "source": "./plugins/security-checks"
    }
  ]
}

{
  "name": "my-marketplace",
  "owner": {
    "name": "Your Organization",
    "email": "plugins@example.com"
  },
  "metadata": {
    "description": "Curated plugins for our team",
    "version": "1.0.0"
  },
  "plugins": [
    {
      "name": "frontend-design",
      "description": "Create a professional-looking GUI ...",
      "version": "2.1.0",
      "source": "./plugins/frontend-design"
    },
    {
      "name": "security-checks",
      "description": "Check for potential security vulnerabilities ...",
      "version": "1.3.0",
      "source": "./plugins/security-checks"
    }
  ]
}

marketplace.json 필드

최상위 필드

플러그 인 항목 필드(배열 내의 plugins 개체)

플러그 인 소스 형식

source 플러그 인 항목의 필드는 상대 경로 문자열 또는 리포지토리 또는 Git URL 원본을 GitHub 설명하는 개체를 허용합니다.

{
    "source": {
        "source": "github",
        "repo": "owner/repo",
        "ref": "v1.0.0",
        "path": "plugins/my-plugin"
    }
}

github 및 url 소스 형식은 모두, sha에 추가로(또는 이를 대신해) 설치를 정확한 커밋에 고정하기 위한 선택적 ref 필드를 지원합니다:

{
    "source": {
        "source": "github",
        "repo": "owner/repo",
        "sha": "a94a8fe5ccb19ba61c4c0873d391e987982fbbd3",
        "path": "plugins/my-plugin"
    }
}

sha 는 전체 40자 커밋 SHA여야 합니다. 강제 푸시나 태그/브랜치 이동의 영향을 받지 않는 재현 가능한 설치를 위해 sha에 고정합니다.

파일 위치

로드 순서 및 우선 순위

여러 플러그 인을 설치하는 경우 MCP 서버를 통해 제공되는 일부 사용자 지정 에이전트, 기술, MCP 서버 또는 도구에 중복 이름이 있을 수 있습니다. 이 경우 CLI는 우선 순위에 따라 사용할 구성 요소를 결정합니다.

• 에이전트 및 기술은 먼저 발견된 것이 우선하는 규칙을 따릅니다.

  설치한 플러그 인의 이름과 ID가 같은 프로젝트 수준 사용자 지정 에이전트 또는 기술이 있는 경우 플러그 인의 에이전트 또는 기술은 자동으로 무시됩니다. 플러그 인은 프로젝트 수준 또는 개인 구성을 재정의할 수 없습니다. 사용자 지정 에이전트는 파일 이름에서 파생된 ID를 기반으로 중복이 제거됩니다(예: 파일 이름이 reviewer.agent.md인 경우, 에이전트 ID는 reviewer가 됩니다). 기술은 SKILL.md 파일 내에서 이름 필드를 기준으로 중복이 제거됩니다.

• MCP 서버 는 마지막 우선 순위를 사용합니다.

  이미 설치한 MCP 서버와 동일한 서버 이름을 가진 MCP 서버를 정의하는 플러그 인을 설치하는 경우 플러그 인의 정의가 우선합니다. 명령줄 옵션 --additional-mcp-config을 사용하여 플러그인을 통해 설치된 MCP 서버 구성과 동일한 이름의 구성을 재정의할 수 있습니다. 둘 이상의 플러그 인이 동일한 이름으로 MCP 서버를 선언하는 경우 CLI는 마지막으로 로드된 플러그 인의 버전을 사용하고 이를 정의한 모든 이전 플러그 인의 이름을 지정하는 경고를 표시합니다.

• 기본 제공 도구 및 에이전트는 항상 존재하며 사용자 정의 구성 요소에서 재정의할 수 없습니다.

다음 다이어그램에서는 로드 순서 및 우선 순위 규칙을 보여 줍니다.

┌──────────────────────────────────────────────────────────────────┐
│  BUILT-IN - HARDCODED, ALWAYS PRESENT                            │
│  • tools: bash, view, apply_patch, glob, rg, task, ...           │
│  • agents: explore, task, code-review, general-purpose, research │
└────────────────────────┬─────────────────────────────────────────┘
                         │
  ┌──────────────────────▼──────────────────────────────────────────────┐
  │  CUSTOM AGENTS - FIRST LOADED IS USED (dedup by ID)                 │
  │  1. ~/.copilot/agents/           (user, .github convention)         │
  │  2. <project>/.github/agents/    (project)                          │
  │  3. <parents>/.github/agents/    (inherited, monorepo)              │
  │  4. <project>/.claude/agents/    (project)                          │
  │  5. <parents>/.claude/agents/    (inherited, monorepo)              │
  │  6. PLUGIN: agents/ dirs         (plugin, by install order)         │
  │  7. Remote org/enterprise agents (remote, via API)                  │
  └──────────────────────┬──────────────────────────────────────────────┘
                         │
  ┌──────────────────────▼──────────────────────────────────────────────┐
  │  AGENT SKILLS - FIRST LOADED IS USED (dedup by name)                │
  │  1. <project>/.github/skills/        (project)                      │
  │  2. <project>/.agents/skills/        (project)                      │
  │  3. <project>/.claude/skills/        (project)                      │
  │  4. <parents>/.github/skills/ etc.   (inherited)                    │
  │  5. ~/.copilot/skills/               (personal-copilot)             │
  │  6. ~/.agents/skills/                (personal-agents)              │
  │  7. PLUGIN: skills/ dirs             (plugin)                       │
  │  8. COPILOT_SKILLS_DIRS env + config (custom)                       │
  │  --- then commands (.claude/commands/), skills override commands ---│
  └──────────────────────┬──────────────────────────────────────────────┘
                         │
  ┌──────────────────────▼──────────────────────────────────────────────┐
  │  MCP SERVERS - LAST LOADED IS USED (dedup by server name)           │
  │  1. ~/.copilot/mcp-config.json       (lowest priority)              │
  │  2. PLUGIN: MCP configs              (plugins)                      │
  │  3. --additional-mcp-config flag     (highest priority)             │
  └─────────────────────────────────────────────────────────────────────┘

추가 읽기

• 엔터프라이즈 관리 플러그 인 표준 정보
• GitHub Copilot 명령 줄 인터페이스 (CLI)
• GitHub Copilot CLI 명령 참조
• GitHub Copilot CLI 프로그래밍 방식 참조