mcpField
G
github-copilot-cli

github-copilot-cli

github.com/rysweetAgent 工作流76118 次安装21 周前更新
代码仓库

关于 github-copilot-cli

github-copilot-cli 技能为 GitHub Copilot CLI 的安装、配置、使用和扩展提供指导，面向需要管理命令行 Copilot 的用户。内容涵盖 MCP 服务、技能、自定义 Agent 及常见故障排查。

主要功能

  1. 01安装、更新与身份验证指导
  2. 02介绍斜杠命令和快捷键
  3. 03管理 MCP 服务配置
  4. 04配置技能与自定义 Agent
  5. 05排查常见问题

适用场景

  1. 01安装或更新 GitHub Copilot CLI
  2. 02为 Copilot CLI 添加 MCP 服务
  3. 03创建或管理技能与自定义 Agent
  4. 04诊断认证或配置问题

MCP 相关

介绍 GitHub Copilot CLI 如何配置和管理 MCP 服务，包括添加、查看和编辑配置。还说明 MCP 服务用于扩展 Copilot 的外部工具。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/rysweet/amplihack --skill github-copilot-cli

安装后在 Claude Code 中输入/github-copilot-cli确认已加载。

附带文件examples.mdreference.md

详细介绍

GitHub Copilot CLI 专家

全面掌握 GitHub Copilot CLI 的安装、配置、使用和扩展。

用途

此技能提供以下方面的专家指导：

  1. 安装和更新 GitHub Copilot CLI
  2. 身份验证和配置
  3. 核心用法和斜杠命令
  4. 扩展性（MCP 服务、技能、自定义 Agent）
  5. 常见问题排查

激活时机

提及以下内容时自动激活：

  • “copilot cli”、“github copilot cli”、“gh copilot”
  • “install copilot”、“update copilot”
  • “copilot commands”、“copilot slash commands”
  • “copilot mcp”、“add mcp server”
  • “copilot skills”、“create copilot skill”
  • “copilot custom agent”

快速参考

安装（所有平台）

始终获取最新版本——使用以下命令：

平台命令
Windows（WinGet）winget install GitHub.Copilot
macOS/Linux（Homebrew）brew install copilot-cli
所有平台（npm，Node.js 22+）npm install -g @github/copilot
macOS/Linux（脚本）curl -fsSL https://gh.io/copilot-install | bash

预发布版本：添加 @prerelease 或使用 GitHub.Copilot.Prerelease

身份验证
copilot                    # Launch and follow /login prompt
# OR use PAT with "Copilot Requests" permission:
export GH_TOKEN=your_token
常用斜杠命令
命令用途
/help显示所有命令和快捷键
/model选择 AI 模型（Claude Sonnet 4.5、GPT-5 等）
/agent浏览并选择可用的 Agent
/skills管理技能
/mcp管理 MCP 服务配置
/delegate [prompt]交由 Copilot 编码 Agent 处理（创建 PR）
/compact减少上下文窗口的使用量
/context显示令牌使用情况可视化
键盘快捷键
快捷键操作
@提及要纳入上下文的文件
!直接执行 Shell 命令
Esc取消当前操作
Ctrl+C取消 / 清除 / 退出
Ctrl+L清除屏幕
Ctrl+O展开/折叠时间线
扩展性概览
  1. MCP 服务 - 使用外部工具扩展 Copilot
  2. 技能 - 面向特定任务的指令和脚本
  3. 自定义 Agent - 专用 Agent 配置
  4. 自定义指令 - 仓库范围的指导

导航指南

何时阅读辅助文件

reference.md - 在需要以下内容时阅读：

  • 包含所有选项的完整斜杠命令参考
  • 详细的 MCP 服务配置和 JSON 架构
  • 完整的权限系统文档
  • 高级配置选项
  • 环境变量参考

examples.md - 在需要以下内容时阅读：

  • 分步安装指南
  • 可用的 MCP 服务配置
  • 技能创建示例
  • 自定义 Agent 示例
  • 真实世界的使用场景

核心概念

MCP 服务（Model Context Protocol）

Copilot CLI 默认包含 GitHub MCP 服务。添加自定义 MCP 服务：

/mcp add             # Interactive configuration
/mcp show            # List configured servers
/mcp edit <name>     # Modify existing server

配置存储于：~/.copilot/mcp-config.json

技能

技能通过指令和脚本提升 Copilot 执行任务的能力。

位置：

  • 项目：.github/skills/ 或 .claude/skills/
  • 个人：~/.copilot/skills/ 或 ~/.claude/skills/

结构：

.github/skills/my-skill/
└── SKILL.md    # Instructions with YAML frontmatter
自定义 Agent

以 Markdown 文件形式存储的专用 Agent 配置。

位置：

  • 用户：~/.copilot/agents/
  • 仓库：.github/agents/
  • 组织：.github-private/agents/
自定义指令

Copilot 的仓库专属指南：

  • .github/copilot-instructions.md - 仓库范围
  • .github/instructions/**/*.instructions.md - 特定路径
  • AGENTS.md - Agent 行为指令

故障排查快速提示

问题解决方案
未安装brew install copilot-cli 或 npm i -g @github/copilot
未通过身份验证在 Copilot CLI 中运行 /login
策略已禁用检查组织/企业的 Copilot 设置
MCP 服务未加载检查 ~/.copilot/mcp-config.json 语法
技能未激活重启 Copilot CLI，检查 SKILL.md YAML

版本：1.0.0 | 状态：公开预览 注意：GitHub Copilot CLI 处于公开预览阶段，可能会发生变更。

评论

支持 Markdown