GitHub Copilot CLI 插件参考

CLI 命令

您可以在终端中使用以下命令来管理 Copilot CLI 的插件。

用于 install 命令的插件规范

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"
}

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 数组中的对象）

文件位置

加载顺序和优先级

如果您安装了多个插件，可能会出现自定义代理、技能、MCP 服务器或通过 MCP 服务器提供的工具名称重复的情况。在此情形下，CLI 会依据优先级顺序决定使用哪个组件。

• 代理和技能 使用先到先得的优先级。

  如果您在项目级别拥有与已安装插件中相同名称或 ID 的自定义代理或技能，则插件中的该代理或技能会被静默忽略。插件无法覆盖项目级或个人配置。自定义代理会根据其 ID 去重，ID 来自文件名（例如文件名为 reviewer.agent.md 时，代理 ID 为 reviewer）。技能则通过其 SKILL.md 文件中的 name 字段去重。

• MCP 服务器 使用后到先得的优先级。

  如果您安装的插件定义了与已安装的 MCP 服务器同名的服务器，则插件的定义优先。您可以使用 --additional-mcp-config 命令行选项来覆盖使用插件安装的同名 MCP 服务器配置。

• 内置工具和代理始终存在，且不能被用户定义的组件覆盖。

下图展示了加载顺序和优先级规则。

┌──────────────────────────────────────────────────────────────────┐
│  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. ~/.claude/agents/            (user, .claude convention)         │
  │  5. <project>/.claude/agents/    (project)                          │
  │  6. <parents>/.claude/agents/    (inherited, monorepo)              │
  │  7. PLUGIN: agents/ dirs         (plugin, by install order)         │
  │  8. 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. ~/.claude/skills/                (personal-claude)              │
  │  8. PLUGIN: skills/ dirs             (plugin)                       │
  │  9. 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 编程参考