エージェント型開発を探求する -

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

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

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

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

前提条件

  • VS Code がインストールされていること
  • GitHub Copilot プラン (Free、Pro、Business、Enterpriseのいずれか) があること
  • GitHub Copilot 拡張機能 がインストールされていること
  • VS Codeでワークスペースまたはフォルダが開かれていること

ステップ 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/ ディレクトリをリポジトリにコミットして、チームとカスタマイズを共有する
  • チャットカスタマイズエディタ を使用して、すべてのカスタマイズを一元管理する
4/8/2026
© . This site is unofficial and not affiliated with Microsoft.