Skip to content

Copilot CLI Plugins 是打包好的功能扩展包,一键安装即可获得新的 Skills、Agents 和 MCP 配置。默认内置两个插件市场:copilot-plugins(官方)和 awesome-copilot(社区),也可以直接从 GitHub 仓库或本地目录安装。

GitHub Copilot CLI 插件安装指南:从市场发现和安装 Plugins

什么是 Plugin

Plugin 是打包好的 Copilot CLI 扩展:一个 Plugin 可以包含多个 Skills、Custom Agents、MCP 服务器配置,以及 Hooks 脚本。

相比手动创建各类配置文件,Plugin 提供了"一包打尽"的便利:

  • 安装一个"React Testing Plugin",你的 Copilot 就掌握了这个项目的测试规范和运行脚本
  • 安装一个团队共享的"company-standards Plugin",所有人都使用统一的 AI 辅助规范

浏览插件市场

Copilot CLI 默认内置两个市场:

  • copilot-plugins:GitHub 官方维护的插件集合
  • awesome-copilot:社区贡献的开源插件

查看已注册的市场

bash
copilot plugin marketplace list

浏览市场中的插件

bash
copilot plugin marketplace browse copilot-plugins
copilot plugin marketplace browse awesome-copilot

添加第三方市场

bash
copilot plugin marketplace add octo-org/copilot-plugins-repo

安装插件

从市场安装

bash
copilot plugin install PLUGIN-NAME@copilot-plugins

从 GitHub 仓库安装

bash
copilot plugin install OWNER/REPO

从任意 Git 仓库安装

bash
copilot plugin install https://github.com/example/my-plugin.git

从本地目录安装(开发阶段测试)

bash
copilot plugin install ./path/to/my-plugin

安装要求:仓库根目录或 .plugin/.github/plugin/.claude-plugin/ 目录中必须包含 plugin.json 文件。如果 plugin.json 在非标准位置,可以指定:

bash
copilot plugin install OWNER/REPO:custom/path/to/plugin

管理已安装的插件

命令功能
copilot plugin list查看所有已安装的插件
copilot plugin update PLUGIN-NAME更新到最新版本
copilot plugin uninstall PLUGIN-NAME卸载插件

插件存储位置

~/.copilot/installed-plugins/MARKETPLACE-NAME/PLUGIN-NAME/

验证安装

安装后,在 Copilot CLI 会话中验证:

bash
# 检查新 Agents
/agent

# 检查新 Skills
/skills list

# 检查新 MCP 服务器
/mcp show

企业管理

企业管理员可以通过 Copilot 策略管控哪些市场和插件是被允许使用的,防止员工安装未经审批的第三方插件。

常见问题

Q: Plugin 安装后我不需要重启 Copilot CLI 吗?

A: 对于大多数情况,新安装的 Plugin 在下次启动 CLI 时自动加载。在运行中的会话里,可以尝试 /skills reload 或重启会话。

Q: Plugin 和 Skills 有什么区别?

A: Skills 是单个能力扩展(一个 SKILL.md 目录);Plugin 是包含多个 Skills、Agents、MCP 配置的综合扩展包。可以把 Plugin 理解成 Skills 的"打包版本"。

Q: 如何知道一个 Plugin 会安装什么?

A: 可以先查看插件仓库的 plugin.json 文件,其中列出了所有包含的组件(agents、skills、hooks、mcpServers)。审查后再决定是否安装。