GitHub Copilot CLI 插件参考

CLI 命令

你可以在终端中使用以下命令管理 Copilot 命令行界面（CLI） 的插件。

install 命令的插件规范

          `./my-plugin` 或 `/abs/path`    | 本地目录 |

plugin.json

所有插件都包含一个插件目录，该目录至少包含一个位于 plugin.json 插件目录根目录的清单文件。 请参阅“为 GitHub Copilot 命令行界面 创建插件”。

必填字段

可选元数据字段

          `name` （必需）、 `email` （可选）、 `url` （可选）。 |

| homepage | 字符串 | 插件主页 URL。 | | repository | 字符串 | 源存储库 URL。 | | license | 字符串 | 许可证标识符（例如， MIT）。 | | keywords | 字符串[] | 搜索关键字。 | | category | 字符串 | 插件类别。 | | tags | 字符串[] | 其他标记。 |

组件路径字段

这些命令告知 CLI 在何处查找插件的组件。 所有选项都是可选的。 如果省略，CLI 将使用默认约定。

示例 plugin.json 文件

{
  "name": "my-dev-tools",
  "description": "React development utilities",
  "version": "1.2.0",
  "author": {
    "name": "Jane Doe",
    "email": "[email protected]"
  },
  "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": "[email protected]"
  },
  "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 命令行界面 创建一个插件市场”。

示例 marketplace.json 文件

{
  "name": "my-marketplace",
  "owner": {
    "name": "Your Organization",
    "email": "[email protected]"
  },
  "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": "[email protected]"
  },
  "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` 字段

顶级字段

          `{ name, email? }` — 市场所有者信息。 |

| plugins | 数组 | 是的 | 插件条目列表（请参阅下表）。 | | metadata | 对象 | 否 | { description?, version?, pluginRoot? } |

插件输入字段（数组中的 plugins 对象）

文件位置

          `~/.copilot/installed-plugins/` 和 `~/.copilot/installed-plugins/_direct` |

| 市场缓存 | ~/.copilot/state/marketplace-cache/ | | 插件清单 | plugin.json、.github/plugin/plugin.json 或 .claude-plugin/plugin.json | | 市场清单 | .github/plugin/marketplace.json 或 .claude-plugin/marketplace.json | | Agents | agents/（默认值，可在清单中覆盖） | | Skills | skills/（默认值，可在清单中覆盖） | | Hooks 配置 | hooks.json 或 hooks/hooks.json | | MCP 配置 | .mcp.json 或 .github/mcp.json | | LSP 配置 | lsp.json 或 .github/lsp.json |

加载顺序和优先级

如果安装多个插件，则某些自定义代理、技能、MCP 服务器或通过 MCP 服务器提供的工具可能具有重复的名称。 在这种情况下，CLI 会根据优先顺序确定要使用的组件。

•           **智能体和技能**采用“先找到者优先”的优先级。
  

  如果项目级自定义代理或技能的名称或 ID 与所安装的插件中的名称或 ID 相同，则插件中的代理或技能将被无提示忽略。 该插件无法替代项目级或个人配置。 自定义代理使用其 ID 删除重复数据，该 ID 派生自其文件名（例如，如果文件命名 reviewer.agent.md，则代理 ID 为 reviewer）。 技能通过其在 SKILL.md 文件中的名称字段进行去重。

•         **MCP 服务器** 使用最后胜出优先权。
  

  如果安装一个插件，该插件使用与已安装的 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  │
└────────────────────────┬────────────────────────────────┘
                         │
  ┌──────────────────────▼──────────────────────────────────────────────┐
  │  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. ~/.claude/skills/                (personal-claude)              │
  │  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. .vscode/mcp.json                 (workspace)                    │
  │  3. PLUGIN: MCP configs              (plugins)                      │
  │  4. --additional-mcp-config flag     (highest priority)             │
  └─────────────────────────────────────────────────────────────────────┘