GitHub Copilotの能力を引き出すカスタム指示とは GitHubがポイントを解説：遠回しな言い方や皮肉はNG？

GitHubは、「GitHub Copilot」の「カスタム指示」に関するTipsを公式ブログで紹介した。開発者が望むコードを効率的かつ安全に得られるよう支援するのが狙いだ。

[＠IT]

　GitHubは2025年9月3日（米国時間）、AI（人工知能）コーディングアシスタント「GitHub Copilot」（以下、Copilot）の「カスタム指示」（カスタムインストラクション）に関するTipsをブログで公開した。Copilotは自然言語で与えるプロンプト次第で出力の品質が大きく変わるため、GitHubは「ポイントを押さえたカスタム指示を作成しておくことで効率的なコードを生成できる」としている。

リリース

カスタム指示に記載すべき5つのポイントとは

　カスタム指示とは、いわゆる「システムプロンプト」のようなもので、Copilotの挙動を開発者のニーズやプロジェクト固有のルールに合わせて調整するための機能だ。「アプリケーションの目的」「技術スタックの内容」「コーディングのルール」といった内容をカスタム指示として与えることで、Copilotに開発者の意図やプロジェクトの背景を理解させ、それに沿った提案をさせられるようになるという。

　GitHubは、カスタム指示を「copilot-instructions.md」ファイルに記載することを推奨している。本稿では、Copilotに適切な提案をさせるためにカスタム指示ファイルに記載すべき5つのポイントを紹介する。

1. プロジェクトの概要を伝える
2. 技術スタックを明確にする
3. コーディングガイドラインを記載する
4. プロジェクト構造を説明する
5. 利用可能なリソースやスクリプトを明示する

1．プロジェクトの概要を伝える

　プロジェクトの概要を記載する。プロジェクトで開発するアプリケーションの目的は何か、対象ユーザーは誰か、主な機能はどんなものかを簡潔に説明する。長文である必要はなく、数行でプロジェクトの全体像を示すことができれば十分だ。

2．技術スタックを明確にする

　バックエンドやフロントエンドで使っている技術、例えばAPIやデータベース、テストツールなどを列挙することで、Copilotはプロジェクトの技術的な背景を理解しやすくなる。詳細な情報を何段落にもわたって書く必要はない。以下は一例だ。

フロントエンド、バックエンド、テストで使う技術について記載している（提供：GitHub）

3．コーディングガイドラインを記載する

　プロジェクトで定めたコーディング規約や付随するルールをCopilotに伝える。「JavaScriptやTypeScriptではセミコロンを入れるのか？」「Pythonでは型ヒントを使用するのか？」「インデントにタブとスペースのどちらを使うか？」といったプロジェクト共通のルールを明示することで、Copilotが生成するコードの品質や一貫性を保つことができる。

「JavaScript/TypeScriptではセミコロンを使用すること」といったガイドラインを記載している（提供：GitHub）

4．プロジェクト構造を説明する

　ディレクトリ構造を記載することで、Copilotに無駄な作業をさせずに済む。以下が記述例だ。

プロジェクトのディレクトリやフォルダ構成、そこに含まれる内容について記載している（提供：GitHub）

5．利用可能なリソースやスクリプトを明示する

　セットアップやビルド、テストに使うスクリプトや開発支援ツールの存在をCopilotに伝える。これによって、Copilotが既存のツールを活用した上で精度の高い提案を迅速に提案できるようになる。以下が記述例だ。

プロジェクトで利用可能なスクリプトやツールを記載している（提供：GitHub）

Copilotにカスタム指示を作らせることのも有効

　Copilot自身にカスタム指示ファイルを生成させる方法もある。まずCopilotにプロンプトで指示を与え、たたき台となるファイルを生成させる。それを開発チームが編集して利用するという方法になる。

　以下はカスタム指示ファイルを生成するプロンプトの例だ。

「ガイダンスには次の内容を必ず含めてください。アプリケーションの目的、技術スタック、コーディングガイドライン、プロジェクト構成、既存のツールとリソース」などをプロンプトで指示している（提供：GitHub）

このニュースのポイント

Q: カスタム指示とは何か？

A: Copilotの挙動をプロジェクト固有のルールや開発者のニーズに合わせて調整する仕組みで、プロジェクトの背景を理解させ、意図に沿ったコードを提案させるためのもの。GitHubは「copilot-instructions.md」に記載することを推奨している。

Q: GitHubが示したカスタム指示に盛り込むべき5つのポイントは？

A: 「プロジェクト概要の記載」「技術スタックの明確化」「コーディングガイドライン」「プロジェクト構造の説明」「利用可能なリソースやスクリプトの明示」。

Q: Copilotにカスタム指示を作らせる活用法もあるか？

A: ある。Copilotにたたき台となるカスタム指示ファイルを生成させ、開発チームが編集して利用する方法も紹介されている。