アイデアからプルリクエストへ：GitHub Copilot CLIで構築する実践ガイド

ほとんどの開発者は、実際の作業をターミナル上で行っています。 そこでプロジェクトの初期化を行い、テストを実行し、CI の失敗をデバッグし、レビューに耐えうる状態になる前に迅速で機械的な変更を加えます。GitHub Copilot CLI は、この現実に合わせて、ターミナル内で意図から直接レビュー可能な差分へ移行し、その作業をエディタやプルリクエストへと引き継ぐことを支援します。 本ブログでは、新しい GitHub Skills 演習に基づき、Copilot CLI を用いてアプリケーションを作成・進化させるための実践的なワークフローを紹介しています。Skills 演習はガイド付きの実践 walkthrough を提供しますが、本記事では各ステップがなぜ機能するのか、そして実際のプロジェクトでいつ使用すべきかに焦点を当てます。 GitHub Skills 演習でさらに深く掘り下げる このワークフローの完全なガイド版（実践練習を含む）をお探しの場合は、「Copilot CLI でアプリケーションを作成する」という GitHub Skills 演習をご覧ください。 これは、事前に設定された GitHub Codespaces のインスタンス内で、これらのパターンを段階的に walkthrough します。本番環境のコードに適用する前に安全に実験するための良い方法です。この演習では以下の内容を取り扱います： - Copilot CLI をインストールし、issue テンプレートを使用して issue を作成する - Node.js CLI カルculator アプリを生成する -追加の演算子で計算機能の拡張を行う - 計算関数のためのユニットテストを書く - プルリクエストを作成・レビュー・マージする Copilot CLI とは何か（そして何ではないか） Copilot CLI は、ターミナル内で動作する GitHub 対応のコーディングエージェントです。自然言語で何を望むかを記述し、コードに触れる前に /plan コマンドを使って作業の見通しを立てたり、実行前に具体的なコマンドや差分を確認したりできます。Copilot は内部で推論を行うこともありますが、明示的な承認がない限り、コマンドを実行したり変更を適用したりすることはありません。 実際には、Copilot CLI は以下のような支援を行います: あなたの意図に基づいて問題を探索する /plan（または Shift + Tab を押してプランニングモードに入る）を使用して構造化された計画を提案するか、確認可能な具体的なコマンドや差分を提示する ファイルの生成または修正を行う 発生した失敗の原因を説明する Copilot CLI が行わないこと: あなたの承認なしにコマンドを黙って実行したり変更を適用したりすること 慎重な設計作業を代替すること レビューの必要性を排除すること 実行されるもの、変更されるもの、そしてリリースされるもののコントロールは常にあなたが握っています。 ステップ 1: スキャフォールディングではなく意図から始める フレームワークを選択したりテンプレートをコピーしたりすることから始めず、まず構築したいものを明確に述べることから始めましょう。 空のディレクトリから以下を実行します: copilot > Create a small web service with a single JSON endpoint and basic tests インタラクティブモードに入る代わりに、単一のプロンプトで提案を生成したい場合は、以下のように実行することもできます: copilot -p "Create a small web service with a single JSON endpoint and basic tests" スキル演習では、このパターンが繰り返し使用されます：まず意図を記述し、次に実際に実行したいと考える提案されたコマンドを選択します。 この段階では、Copilot CLI は問題領域の探索を行っています。以下のようなことが可能です: スタックの提案 ファイルのアウトライン作成 セットアップコマンドの提案 何かが自動的に実行されることはありません。実行するかどうかを決定する前に、すべてを検証します。これにより、設計にコミットする前に実験を行うのに CLI が適した場所となります。 ステップ 2: 自分が責任を持てる範囲のみをスケフォールドする あなたが納得できる方向性が見えたら、Copilot CLI にスケフォールドの支援を依頼してください: > テストランナーと README を含む最小限の Node.js プロジェクトとしてこれをスケフォールドしてください ここで Copilot CLI が最も即座に役立ちます。以下が可能になります: ディレクトリと設定ファイルの作成 基本的なプロジェクト構造の接続 手動で入力またはコピーする必要があるボイラープレートコードの生成 Copilot CLI はプロジェクト構造を「所有」するわけではありません。一般的な慣習に基づいてスケフォールドを提案しますが、これは処方箋ではなく、出発点として扱うべきです。 重要な制約は、常に結果に対する責任があなたにあるということです。出力はチームメイトからのコードのように扱い、レビューし、編集するか、あるいは却下してください。 ステップ 3: 失敗の地点で反復する Copilot CLI の内部で直接テストを実行します: すべてのテストを実行し、パスすることを確認してください 何かが失敗した場合、同じセッション内でその具体的な失敗について Copilot に問い合わせてください: > なぜこれらのテストは失敗しているのですか？ 説明ではなく具体的な提案を望む場合は、以下を試してください: このテストの失敗を修正し、差分を表示してください このパターン（! コマンドの実行、検証、質問、差分の確認）により、エージェントが抽象的なプロンプトではなく、実際の出力に基づいて動作することが保証されます。 💡 プロのヒント：実際には、理解を得たい場合は「explain」コマンドが有用ですが、レビュー可能な具体的な提案が必要であれば「suggest」コマンドの方が適しています。Copilot CLI のスラッシュコマンドの詳細については、当社のガイドをご覧ください。 ステップ 4: 機械的またはリポジトリ全体の修正を行う Copilot CLI は、説明は容易だが実行が面倒な変更にも非常に適しています: > リポジトリ内の X のすべてのインスタンスを Y にリネームし、テストを更新する これらの変更は機械的で範囲が限定されているため、レビューもロールバックも容易です。CLI は生成されたテキストの壁ではなく、具体的な差分（diff）を提供します。 ステップ 5: コードの形状を作り始める必要がある場合はエディタへ移行する 最終的には、速度よりも正確性が重要になります。 これは、エディタや IDE に自然に引き継ぐポイントです。ここで以下が可能になります: - エッジケースについて推論する - API を洗練させる - デザイン上の判断を下す Copilot はここでも機能しますが、重要な点はなぜ環境を切り替えるのかという理由です。CLI は素早く実用的な成果物に到達するのに役立ちます。一方、IDE ではコードを望む通りの形に仕上げる作業が行われます。 良い目安となるルール: - CLI: /plan を使用し、/diff で差分を生成して、儀式のような手順を省いて迅速に進める - IDE: ロジックの洗練や、レビューで説明責任が求められる判断を下す必要がある場合に /IDE を使用する - GitHub: コミットを行い、/delegate コマンドを使ってプルリクエスト（pull request）を開き、非同期で協力する ステップ 6: GitHub でリリースする 変更が良好に見えるようになったら、コミットしてプルリクエストを開きます。これは自然言語を通じて Copilot CLI を使って行うことができます: 適用可能な説明的メッセージを付けてすべてのファイルをステージングし、コミットして変更点をプッシュしてください。 プルリクエストを作成し、Copilot をレビュアーとして追加してください。 これで作業が持続可能になります： チームメンバーによるレビューが可能に CI でのテスト実行が可能に 非同期での反復開発の準備が整う こここそが Copilot の価値が単なる一つの機能ではなく、リリースに至るフローの一部として複合的に高まる瞬間です。このスキル演習は意図的にここで終わります。なぜなら、Copilot の真価が発揮されるのは、コミット、プルリクエスト、レビューというプロセスにおいてであり（単なる提案にとどまらない）からです。 一つのワークフロー、三つの局面 Copilot を理解するための有益なメンタルモデルは以下の通りです： CLI: 低コストで迅速に価値を実証 IDE: コードの構成と洗練 GitHub: レビュー、共同作業、リリース Copilot CLI が強力である理由はまさに、このシステムを置き換えるのではなく、その一部として組み込まれている点にあります。 Copilot で構築する際の注意：Copilot SDK について 開発者向けツールや内部システム、あるいはエージェント実行自体が製品の一部となる（単にターミナルで実行するだけのものではない）アプリケーションを開発している場合、現在技術プレビュー版である GitHub Copilot SDK を検討されることをお勧めします。 Copilot SDK を使用すれば、独自のオーケストレーション層を構築・維持する必要なく、Copilot CLI の基盤となる計画および実行エンジンへのプログラムによるアクセスが可能になります。プランナー、ツール、回復ロジックを手動で接続する代わりに、エージェントの動作を定義するだけでよく、Copilot が実行を担当します。 Copilot CLI は、自分のワークフロー内で高速かつ対話的な実行を望む場合に使用します。一方、Copilot SDK は、これらのエージェント機能をアプリケーション内部に埋め込みたい場合に使用します。SDK は Copilot CLI の背後にある実行エンジンを公開していますが、リポジトリスコープのメモリや委任されたプルリクエストワークフローといった GitHub 固有の機能は含まれません。 Copilot SDK を探索する > このガイドから持ち帰るべきこと Copilot CLI は、判断力を代替するものではなく、推進力のためのツールとして扱う場合に最も有用です。 適切に使用すれば、意図を具体的な変更へと迅速に変換するのに役立ちます：アイデアの探求、プロジェクトのスケーフォールディング、障害の診断、そしてターミナル内で直接機械的な作業の処理などです。精度が求められる場合はエディタに移行し、作業が共有の準備ができたら、それは GitHub 上でプルリクエストとして提出されます。レビュー可能で、テスト可能で、出荷可能な状態となります。 このフローは、単一のコマンドよりも重要です。 このガイドから得られるべき最も重要な教訓はこれです：Copilot は、開発者がすでにソフトウェアを構築している方法に自然に適合するときに最もよく機能します。CLI で始めてつまずきを解消したり素早く進んだりし、IDE で慎重になって判断を下せるようにし、GitHub に頼って作業の耐久性を確保してください。 GitHub Copilot CLI の利用を開始するか、スキルコースを受講する > 「アイデアからプルリクエストへ：GitHub Copilot CLI を活用した実践的ガイド」の記事は、The GitHub Blog で最初に公開されました。

アイデアからプルリクエストへ：GitHub Copilot CLIで構築する実践ガイド

背景や根拠まで確認しますか？

関連記事

調べる

選ぶ

サイト

背景や根拠まで確認しますか？

関連記事

ニュースの次に確認する

調べる

選ぶ

サイト