GitHubは、カスタムディレクティブがCopilotのコンテキスト理解と出力品質を大幅に向上させることができると強調しています。Copilotにチーム標準、プロジェクトコンテキスト、ツールチェーンを組み込むことで、AIは迂回を回避し、無駄のないコードを記述できるようになり、コードレビューとドキュメント作成が容易になります。1. なぜCopilotのカスタムディレクティブを作成するのか？1. プロジェクトと標準に合わせてAIをカスタマイズします。カスタムディレクティブは、プロジェクトスタック、命名規則、コーディングスタイル、テスト境界を明確に定義します。これにより、AIは単に「出力を一般化」するのではなく、プロジェクトの制約に基づいて実装可能なコードとドキュメントを生成できます。2. 長期的なAI設定を構築します。よく使用されるライブラリ、エラーブラックリスト、パフォーマンスレッドラインなどの機能を長期メモリに設定することで、Copilotはそれらを後続のセッションで再利用し、再説明と手戻りを削減できます。
（1）やり取りを減らす
入出力フォーマット、例、禁止用語を明確にします。AIがテンプレートに従って直接生成するため、レビュー時間が大幅に短縮されます。
（2）ツールチェーン自動化と連携する
テストフレームワーク、静的検査、パッケージングプロセスを指示書に宣言します。AIはパイプラインを通過できる実装とスクリプトを優先的に生成します。
II. 再現可能な5つのライティングスキル
1. 書く前に役割と境界を定義する
「あなたは特定の技術スタックのシニアエンジニアなので、これらのタイプのライブラリしか呼び出せません。テスト可能なコードを書くことを優先してください」と明確に伝え、許可されていないパターンやパフォーマンスの制限を説明します。
2.プロジェクトのコンテキストをリストにまとめる
言語バージョン、依存関係、ディレクトリ構造、構成のポイントを 3 つまたは 5 つのキーポイントに整理して、AI が断片的な情報ではなく一目でコンテキストを取得できるようにします。
（1）構造化された出力形式
コード、アイデア、複雑さ、テスト ケース、潜在的なリスクを含む 5 つの部分からなる戻り値の形式を必要とし、「プロセスのない回答」だけを提供することを避けます。
（2）例駆動型および反例のガードレール
良い例と反例を添付して、AI に「このように書いて、ああは書かないで」と伝えると、効果はすぐに現れます。
III. エンジニアリングの実装とチーム コラボレーション
1.指示をリポジトリとテンプレートに配置する
カスタム指示、貢献ガイドライン、Lint ルールを同じ場所に配置し、すべてのリポジトリで同じベースラインを再利用して、個々の差異を減らします。
2. 指示のイテレーション メカニズムを確立する
「ライブラリの誤用、パフォーマンスの低下、スタイルのドリフト」などの問題を指示に書き戻し、毎週少しずつ更新して、小サンプル回帰を通じて合格率とレビュー密度を観察します。
（1）異なるシナリオ向けの複数バージョン
「バグ修正、機能作成、ドキュメント作成、テスト作成」の異なる指示バージョンを区別し、オンデマンドで読み込むことで「すべてを一度に」実行することを防ぎます。
（2）セキュリティとコンプライアンスへの準拠
AI が準拠していないコンポーネントを導入したり、情報を漏らしたりすることを防ぐため、指示書にライセンス要件、依存関係のホワイトリスト、機密データ原則を宣言します。
よくある質問 (Q&A)
Q: カスタム指示書と通常のプロンプト (AI キーワード: Copilot) の違いは何ですか?
A: カスタム指示書は、Copilot の動作を制限するために使用される長期的な「基本設定」です。プロンプトは、オンデマンドのタスク指示書のようなものです。 2つを組み合わせることで、安定性が大幅に向上します。
Q：チームはカスタム指示をどのように統一しますか（AIツール：GitHub Copilot）？ A：リポジトリテンプレートとコントリビューションガイドに指示を組み込み、生成されたコードがパイプラインと一致していることを確認するために、リンティング、テスト、および事前コミットフックを実装します。 Q：指示の有効性をどのように評価しますか（AIキーワード：コーディング品質）？ A：レビュー中に変更された行数、テストの初回パス率、静的チェック警告の数、ビルド時間を観察し、継続的なA/B比較を実行するための回帰セットを作成します。 Q：これにより、AIは「厳格」になりますか（AIキーワード：スタイル制御）？ A：「探索モード」と「厳格モード」の2つの指示を維持し、開発初期の探索ではより寛容にし、リリース前に厳格に戻すことで、創造性と安定性のバランスをとります。
