github-copilot-cli-expert

GitHub Copilot CLI エキスパート

ターミナルネイティブな AI コーディングアシスタント、GitHub Copilot CLI に関する包括的な知識です。

注：コマンド構文や利用可能なモデルは変更される場合があります。最新のオプションは Copilot CLI で /help を実行して確認してください。

目的

このスキルでは、以下について専門的なガイダンスを提供します。

1. GitHub Copilot CLI のインストールと更新
2. すべてのスラッシュコマンドとキーボードショートカット
3. カスタムエージェント、スキル、MCP サーバーの設定
4. セキュリティ、権限、信頼済みディレクトリ
5. GitHub ワークフロー（PR、issue、Actions）との連携
6. プログラムによる利用モードと対話型利用モード

クイックリファレンス

インストール（いずれかを選択）

# Homebrew (macOS/Linux) - Recommended
brew install copilot-cli

# npm (all platforms, requires Node.js 22+)
npm install -g @github/copilot

# WinGet (Windows)
winget install GitHub.Copilot

# Install script (macOS/Linux)
curl -fsSL https://gh.io/copilot-install | bash

最新バージョンへの更新

# Homebrew
brew upgrade copilot-cli

# npm
npm update -g @github/copilot

# WinGet
winget upgrade GitHub.Copilot

# Check version
copilot --version

初回利用の前に

要件：

• 有効な GitHub Copilot サブスクリプション（プラン）
• Node.js 22+（npm でインストールする場合）
• PowerShell v6+（Windows ユーザー）

認証：

# On first run, you'll be prompted to login
copilot
# Then: /login

# OR set environment variable
export GH_TOKEN="ghp_xxxxxxxxxxxx"

主要なスラッシュコマンド

コマンド	説明
/help	すべてのコマンドとショートカットを表示
/model	AI モデルを選択（claude-sonnet-4-5、gpt-5 など）
/mcp	MCP サーバーの設定を管理
/agent	カスタムエージェントを参照して選択
/delegate	GitHub 上の Copilot コーディングエージェントにタスクを引き渡す
/compact	コンテキストウィンドウの使用量を削減
/context	トークン使用量を視覚化して表示
/usage	セッションのメトリクスを表示
/diff	セッション中に行った変更を確認
/share	セッションをファイルまたは gist にエクスポート
/skills	機能を強化するスキルを管理

キーボードショートカット

ショートカット	アクション
@file	ファイルの内容をコンテキストに含める
!cmd	シェルコマンドを直接実行
Esc	操作をキャンセル／プロンプトを終了
Ctrl+C	キャンセル／クリア／終了
Ctrl+L	画面をクリア
Ctrl+O	タイムラインを展開／折りたたむ
↑/↓	コマンド履歴を移動

このスキルを使う場面

次の内容に言及すると自動的にトリガーされます：

• 「copilot cli」、「github copilot」、「install copilot」
• 「update copilot」、「copilot version」、「copilot commands」
• 「mcp server」、「custom agents」、「copilot skills」

明示的に呼び出すには、次を使用します。

Skill(skill="github-copilot-cli-expert")

ナビゲーションガイド

参考ファイルを読むタイミング

reference.md - 次の情報が必要な場合に読みます。

• 詳細なオプションを含む、すべてのスラッシュコマンドの完全な一覧
• すべてのコマンドラインフラグと環境変数
• 詳細なセキュリティ設定（信頼済みディレクトリ、ツール権限）
• プログラムモードの例とスクリプトのパターン
• MCP サーバー設定の JSON 形式

examples.md - 次の情報が必要な場合に読みます。

• 手順ごとのワークフロー例（PR 作成、コードレビュー）
• カスタムエージェントの作成と呼び出しの例
• GitHub 連携のユースケース（issue、Actions、PR）
• Copilot コーディングエージェントへの委任ワークフロー

主な機能

1. 対話型モードとプログラムモード

対話型（デフォルト）：

copilot
# Then type prompts naturally

プログラム（スクリプト）：

copilot -p "Summarize recent commits" --allow-tool 'shell(git)'

2. カスタムエージェント

組み込みエージェント：explore、task、plan、code-review

カスタムエージェントの配置場所：

• ユーザーレベル：~/.copilot/agents/
• リポジトリ：.github/agents/
• 組織／エンタープライズ：.github-private/agents/

3. MCP サーバー

GitHub MCP サーバーはデフォルトで含まれています。さらに追加するには：

/mcp add
# Fill details, Ctrl+S to save

設定の保存先：~/.copilot/mcp-config.json

4. セキュリティモデル

• 信頼済みディレクトリ：初回起動時に確認されます
• ツールの承認：ファイル変更に必要です
• パスの権限：デフォルトでは現在のディレクトリと一時ディレクトリ
• URL の権限：すべての URL で承認が必要です

よく使われるパターン

プロンプトにファイルを含める

Explain @config/settings.yml
Fix the bug in @src/app.js

GitHub エージェントに委任する

/delegate complete the API tests and create a PR

前のセッションを再開する

copilot --resume    # Cycle through sessions
copilot --continue  # Resume most recent

プロンプトなしでツールを許可する

copilot --allow-all-tools
copilot --allow-tool 'shell(git)'
copilot --deny-tool 'shell(rm)'

バージョン情報

現在のバージョン：copilot --version で確認してください

プレリリースチャンネル：

brew install copilot-cli@prerelease
npm install -g @github/copilot@prerelease
winget install GitHub.Copilot.Prerelease

リリース：https://github.com/github/copilot-cli/releases/

トラブルシューティング

認証に関する問題

/login              # In interactive mode
# Or use PAT with GH_TOKEN/GITHUB_TOKEN env var

コンテキストウィンドウがいっぱいの場合

/compact            # Summarize conversation
/context            # View token usage

MCP サーバーが読み込まれない場合

/mcp show           # List configured servers
/mcp edit [name]    # Edit configuration

ツールの使用許可が拒否された場合

• 信頼済みディレクトリを確認します：~/.copilot/config.json → trusted_folders
• --allow-all-paths または --allow-all-urls フラグを使用します
• プロンプトが表示されたら、ツールを個別に承認します

初回セットアップに関する問題

インストール後に「Copilot が見つかりません」と表示される場合：

• インストール後にターミナルを再起動します
• PATH にインストール先が含まれていることを確認します
• which copilot（Unix）または where copilot（Windows）を実行します

「サブスクリプションがありません」というエラーが表示される場合：

• https://github.com/settings/copilot で確認します
• プランに CLI へのアクセスが含まれていることを確認します
• /logout を実行してから /login を試します

関連スキル

• mcp-manager：高度な MCP サーバー設定
• agent-sdk：カスタムエージェントの構築
• documentation-writing：わかりやすいドキュメントの作成方法

公式リソース

• ドキュメント：https://docs.github.com/copilot/concepts/agents/about-copilot-cli
• 使用ガイド：https://docs.github.com/copilot/how-tos/use-copilot-agents/use-copilot-cli
• インストール：https://docs.github.com/copilot/how-tos/set-up/install-copilot-cli
• リリース：https://github.com/github/copilot-cli/releases/
• フィードバック：CLI で /feedback コマンドを使用します