GitHub Copilot CLI の /research コマンド — コミットログも Actions 履歴も全部調べてくれるディープリサーチ
@07JP27 氏が X で連続投稿し、GitHub Copilot CLI の /research コマンドの威力を紹介しています。
/research コマンドすげえ。Web を Deep Research してくれるのはもちろん、紐づくリポジトリのコミットログとか GitHub Actions の実行履歴まで全部見てくれて「お前のこのときのコミットのここが原因だぞ。Actions のログにもこう出てるだろ」みたいなことを言ってくる。
元の投稿では Qiita 記事(@shyamagu 氏の解説)も参照されており、MCP ツール連携や WorkIQ との統合例が紹介されています。本記事では、/research コマンドの技術的な仕組みと、Claude Code との比較を交えて解説します。
/research コマンドとは
概要
2026 年 2 月 25 日、GitHub Copilot CLI が全有料プラン向けに一般提供(GA)を開始しました。同日リリースの v0.0.417 で追加された /research コマンドは、ディープリサーチ専用のスラッシュコマンドです。
通常のチャットが速度重視なのに対し、/research は徹底性(thoroughness)を重視します。複数のツールを呼び出しながら情報を収集し、数百行に及ぶ Markdown レポートを生成します。
| |
3 つのクエリ分類
/research はクエリを自動分類し、回答形式を最適化します。
| クエリ種別 | 応答形式 | 例 |
|---|---|---|
| プロセス質問 | ステップバイステップのガイド | 「このプロジェクトのデプロイ手順は?」 |
| 概念質問 | ナラティブな説明 | 「React の Concurrent Rendering の仕組みは?」 |
| 技術ディープダイブ | アーキテクチャ図 + コード例 | 「認証フローの実装を分析して」 |
出力と共有
レポートは Markdown ファイルとしてディスクに保存されます。一時的なチャットメッセージではなく、永続的な成果物として残ります。
| |
なぜコミットログや Actions 履歴まで調べられるのか
GitHub MCP Server の組み込み
/research コマンドの真の強みは、GitHub MCP Server がデフォルトで組み込まれている点にあります。Copilot CLI は起動時に GitHub MCP Server を自動で接続し、以下のツールが使えるようになります。
| カテゴリ | ツール | 機能 |
|---|---|---|
| コード探索 | search_code | リポジトリ横断のコード検索 |
| コード探索 | get_file_contents | ファイル内容の取得 |
| コミット履歴 | list_commits | ブランチ・リポジトリのコミット一覧 |
| コミット履歴 | get_commit | 特定コミットの詳細(diff 含む) |
| Issue | get_issue / list_issues | Issue の取得・一覧 |
| Issue | search_issues | リポジトリ横断の Issue 検索 |
| PR | pull_request_read | PR の詳細情報 |
| PR | list_pull_requests | PR の一覧 |
| Actions | list_workflows | ワークフロー一覧 |
| Actions | list_workflow_runs | ワークフロー実行履歴 |
| Actions | get_workflow_run | 特定実行の詳細 |
| Actions | get_job_logs | ジョブログの取得 |
| Actions | get_workflow_run_logs | 実行全体のログ取得 |
/research はこれらのツールを自律的に組み合わせて呼び出します。@07JP27 氏が驚いたように、**「このコミットのここが原因だ」「Actions のログにもこう出ている」**と具体的に指摘できるのは、コミット詳細(get_commit)とワークフローログ(get_job_logs)を実際に読んでいるからです。
調査の流れ
ユーザー: /research CI が昨日から失敗している原因を調べて
/research エージェントの行動:
1. list_workflow_runs → 直近の実行履歴を取得
2. get_workflow_run → 失敗した実行の詳細を確認
3. get_job_logs → 失敗ジョブのログを読む
4. list_commits → 失敗開始時点前後のコミット一覧を取得
5. get_commit → 疑わしいコミットの diff を確認
6. get_file_contents → 変更されたファイルの現在の内容を確認
7. Web 検索 → エラーメッセージの解決策を調査
→ 原因特定 + 修正提案を含む Markdown レポートを生成
クロスリポジトリ検索
認証済みの GitHub アカウントを通じて、ローカルリポジトリに限定されない調査が可能です。組織内の他のリポジトリや、アクセス権のあるプライベートリポジトリも検索対象になります。
Copilot CLI の /research と Claude Code の違い
設計思想の違い
| 観点 | Copilot CLI /research | Claude Code |
|---|---|---|
| 目的 | 調査レポートの生成 | コードの実装・修正 |
| 出力 | Markdown レポート(読み取り専用) | ファイル編集・コマンド実行 |
| GitHub 連携 | MCP Server 組み込み済み | MCP で追加設定が必要 |
| Web 検索 | 組み込み | WebSearch / WebFetch |
| コード変更 | 不可(レポートのみ) | 可能 |
| モデル | 固定(/model 設定とは独立) | 選択可能 |
/research は「調査専門」
/research コマンドの重要な制約は、コードを変更しないことです。調査結果をレポートとして出力するだけで、ファイルの編集やコミットは行いません。これは意図的な設計で、「調べる」と「直す」を分離しています。
Claude Code は調査と実装を一貫して行えますが、GitHub のコミットログや Actions ログを直接読む機能は組み込まれていません。gh コマンドを Bash 経由で呼び出すことで同様の調査は可能ですが、/research のように専用の調査エージェントが自律的にツールを組み合わせる方式とは異なります。
補完的な使い分け
原因調査フェーズ:
Copilot CLI /research → レポート生成
「CI の失敗原因はこのコミットの依存関係変更」
修正実装フェーズ:
Claude Code → コード修正 + テスト + コミット
「依存関係を修正して CI を通す」
MCP ツール連携の拡張性
標準 GitHub MCP に加えたカスタム連携
Copilot CLI は GitHub MCP Server 以外のカスタム MCP サーバーも接続できます。@shyamagu 氏の Qiita 記事で紹介されている例を見てみます。
Microsoft Learn MCP Server
| |
MCP ツールを明示的に指定することで、Web の一般検索よりも正確な公式情報を得られます。
WorkIQ 連携
| |
M365 のカレンダー・メール・ファイルなど、業務データへのアクセスも MCP 経由で実現できます。
出力形式の柔軟性
/research は Markdown だけでなく、指定すれば PowerPoint(pptx)や Excel(xlsx)形式での出力にも対応します。ただし、精度はプロンプトの書き方に依存します。
Copilot CLI GA の全体像
/research は GA リリースに含まれる多くの新機能の一つです。主要な機能を整理します。
| 機能 | 説明 |
|---|---|
| Plan モード | Shift+Tab で計画モードに切替、実装前に構造化された計画を作成 |
| Autopilot モード | 完全自律実行 |
| /research | ディープリサーチ + レポート生成 |
| Agent Skills | Markdown ベースのスキルファイルで専門ワークフローを定義 |
| MCP サーバー | カスタム MCP サーバーの接続 |
| プラグイン | /plugin install owner/repo でプラグインを追加 |
| モデル選択 | Claude Opus 4.6, Sonnet 4.6, GPT-5.3-Codex, Gemini 3 Pro |
| 自動コンパクション | コンテキストの 95% で自動圧縮、無制限セッション |
| セッション再開 | --resume / /resume で過去のセッションを再開 |
対応プラットフォームとインストール
| |
対応プラン: Copilot Pro, Pro+, Business, Enterprise
まとめ
/researchはディープリサーチ専用コマンド: 2026 年 2 月 25 日の GA リリースで追加された。通常チャットより徹底的に調査し、Markdown レポートを生成する- GitHub MCP Server が組み込み済み: コミットログ(
list_commits/get_commit)、Actions ログ(get_job_logs)、Issue、PR を自律的に横断調査する。これが「コミットのここが原因だぞ」と指摘できる理由 - コードは変更しない:
/researchは調査レポートの生成に特化しており、ファイル編集やコミットは行わない。「調べる」と「直す」の分離が設計思想 - MCP ツールで拡張可能: Microsoft Learn、WorkIQ など外部 MCP サーバーを接続して調査範囲を拡大できる
- Claude Code との補完関係:
/researchで原因を特定し、Claude Code で修正を実装するという使い分けが効果的 - マルチモデル対応: Claude Opus 4.6、GPT-5.3-Codex、Gemini 3 Pro など主要モデルを選択可能(ただし
/researchは固定モデル)
参考
- @07JP27 氏のポスト(/research の威力)
- @07JP27 氏のポスト(/research の紹介)
- @shyamagu 氏: GitHub Copilot CLI の /research が強い(Qiita)
- GitHub Docs: Researching with GitHub Copilot CLI
- GitHub Blog: GitHub Copilot CLI is now generally available
- GitHub Blog: GitHub Copilot CLI 101
- GitHub: github-mcp-server
- GitHub Copilot CLI: Architecture and MCP Integration(DeepWiki)
- gihyo.jp: GitHub Copilot CLI が一般提供を開始