💻 6月3日の MS Build で開催される VS Code Live に参加しましょう。

プロジェクト向けに AI をカスタマイズする

このガイドでは、Visual Studio Code でプロジェクト向けの AI カスタマイズを設定する方法を説明します。基本的なコーディング規約から始め、段階的によりターゲットを絞った機能を追加していきます。

完了すると、プロジェクトには以下が含まれるようになります

  • すべてのチャットリクエストに適用されるプロジェクト全体のコーディング規約
  • フロントエンドコード用のファイル固有の指示
  • 一般的なタスクのための再利用可能なプロンプトファイル
  • 制限付きツールを持つカスタムエージェント
  • 特殊な機能のためのスキル

前提条件

ステップ 1: プロジェクト全体のコーディング規約を設定する

まずは、プロジェクトのコーディング規約を記録した指示ファイルを作成します。これらの指示は、すべてのチャットリクエストに自動的に含まれるようになります。

  1. チャット ビューを開きます (⌃⌘I (Windows、Linux Ctrl+Alt+I))。

  2. /init と入力し、Enter を押します。

    /init

  3. VS Code がプロジェクト構造を分析し、コードベースに合わせて最適化された .github/copilot-instructions.md ファイルを生成します。

  4. 生成されたファイルを確認し、カスタマイズします。例えば、推奨するインポートスタイルについてのルールを追加します。

    ## Imports
- Use named imports instead of default imports.
- Group imports: external libraries first, then internal modules, then relative paths.

  5. ファイルを保存します。

動作確認: Copilot にコードを生成するよう依頼します（例: 「日付フォーマット用のユーティリティ関数を作成して」）。回答がコーディング規約に従っているか確認します。チャット回答内の References (参照) セクションを選択し、copilot-instructions.md が含まれていることを確認します。

ヒント

常時適用される指示の詳細については、「カスタム指示の使用」を参照してください。

ステップ 2: ファイル固有の指示を追加する

コードベースの場所によって異なる規約に従う必要がある場合は、applyTo パターンを使用した指示ファイルを作成し、特定のファイルタイプを対象にします。

  1. チャット ビューを開きます (⌃⌘I (Windows、Linux Ctrl+Alt+I))。

  2. /create-instructions と入力し、作成したい指示の説明を入力して、Enter を押します。

    /create-instructions React-specific coding standards

  3. 指示に関する明確化のための質問に答え、生成された指示ファイルを確認します。

動作確認: .tsx ファイルを開き、Copilot に「ユーザープロフィールカードコンポーネントを作成して」と依頼します。回答が React 固有の規約に従っているはずです。References (参照) セクションを確認し、指示ファイルが適用されたことを確認します。

ヒント

異なるファイルタイプ、フレームワーク、またはモジュールごとに複数の指示ファイルを作成できます。詳細については、「.instructions.md ファイルの使用」を参照してください。

ステップ 3: 再利用可能なプロンプトファイルを作成する

プロンプトファイルは、一般的なタスクをチャットで呼び出せるスラッシュコマンドとして定義します。頻繁に行うタスク用に作成してみましょう。

  1. チャット ビューを開きます (⌃⌘I (Windows、Linux Ctrl+Alt+I))。

  2. /create-prompt と入力し、作成したいプロンプトの説明を入力して、Enter を押します。

    /create-prompt Scaffold a new React component with tests

  3. プロンプトに関する明確化のための質問に答え、生成されたプロンプトファイルを確認します。

動作確認: チャットビューで /<プロンプト名> ソートおよびフィルタリング機能付きのデータテーブル と入力し、Enter を押します。エージェントが規約に従ってコンポーネントとテストファイルのひな形を作成するはずです。

ヒント

チャットで /create-prompt と入力すると、AI の支援を受けてプロンプトファイルを生成できます。また、進行中の会話から「このワークフローをプロンプトとして保存して」と頼むことで、再利用可能なプロンプトを抽出することも可能です。詳細については、「プロンプトファイルの使用」を参照してください。

ステップ 4: カスタムエージェントを構築する

カスタムエージェントを使うと、特定のツールへのアクセス権を持つ専門的なペルソナを AI に持たせることができます。コードを読み取ることはできるが変更はできない、コードレビュー担当者エージェントを作成してみましょう。

  1. チャット ビューを開きます (⌃⌘I (Windows、Linux Ctrl+Alt+I))。

  2. /create-agent と入力し、作成したいエージェントの説明を入力して、Enter を押します。

    /create-agent A code reviewer that analyzes code for quality, security, and best practices without modifying files

  3. エージェントに関する明確化のための質問に答え、生成されたエージェントファイルを確認します。

動作確認: チャットビューのエージェントドロップダウンから Reviewer (レビュアー) エージェントを選択し、「認証モジュールをレビューして」と依頼します。エージェントは変更を加えることなくコードを分析するはずです。

ヒント

エージェントに handoffs (引き継ぎ) を追加して、ガイド付きワークフローを作成できます。例えば、計画立案エージェントから実装エージェントへ引き継ぐといったことが可能です。詳細については、「カスタムエージェント」を参照してください。

ステップ 5: 特殊な機能のためのスキルを作成する

スキルとは、Copilot が関連するタスクを実行するために読み込む、指示、スクリプト、リソースのフォルダーです。コーディング規約を定義する指示ファイルとは異なり、スキルは特定のワークフローを実行する方法を Copilot に教えます。

  1. コマンドパレット (⇧⌘P (Windows, Linux Ctrl+Shift+P)) から Chat: Open Customizations コマンドを実行し、エージェントカスタマイズエディターを開きます。

  2. Skills タブを選択し、ドロップダウンから New Skill (Workspace) を選択します。

  3. update-readme などのスキル名を入力し、Enter を押します。

  4. SKILL.md ファイルに以下の内容を追加します。

    ---
name: update-readme
description: Update the project README to reflect recent code changes. Whenever code changes are made, this skill reviews the changes and updates the README with new features, usage instructions, and API references.
---
# Update README

When updating the README:
1. Review recent code changes to identify new or modified features
2. Update the relevant sections (installation, usage, API reference)
3. Add entries for new commands, configuration options, or environment variables
4. Remove documentation for deleted or deprecated features
5. Keep the existing tone, structure, and formatting conventions

動作確認: チャットで Copilot にプロジェクトへの新機能追加を依頼します（例: 「ヘルスチェックエンドポイントを追加して」）。コードが生成される際、新しいエンドポイントのドキュメントを README に自動的に更新するはずです。また、チャットビューで /update-readme と入力してスキルを直接呼び出すこともできます。

ヒント

チャットで /create-skill と入力すると、AI の支援を受けてスキルを生成できます。また、進行中の会話から「今やった作業からスキルを作成して」と頼むことで、スキルを抽出することも可能です。詳細については、「エージェントスキル」を参照してください。

構築するもの

これでプロジェクトに階層的な AI カスタマイズが設定されました。

your-project/
  .github/
    copilot-instructions.md          # Project-wide coding standards (Step 1)
    instructions/
      react.instructions.md          # React-specific conventions (Step 2)
    prompts/
      create-component.prompt.md     # Reusable component scaffolding (Step 3)
    agents/
      reviewer.agent.md              # Read-only code reviewer (Step 4)
    skills/
      update-readme/
        SKILL.md                     # README updater workflow (Step 5)

次のステップ

  • MCP サーバーを追加して、外部ツールやサービスでエージェントを拡張する
  • エージェントのライフサイクルポイント（ファイル編集後のフォーマッター実行など）でタスクを自動化するために フック を設定する
  • エージェントプラグインをブラウズして、コミュニティマーケットプレイスからパッケージ化されたカスタマイズをインストールする
  • .github/ ディレクトリをリポジトリにコミットして、チームとカスタマイズを共有する
  • エージェントカスタマイズエディターを使用して、すべてのカスタマイズを一元管理する
5/28/2026
© . This site is unofficial and not affiliated with Microsoft.