GitHub Copilot applyToパターンで実現する条件分岐型インストラクション管理¶

Q: applyTo パターンに複数の拡張子を指定できますか？

はい。カンマ区切りで複数指定できます。例: applyTo: "**/*.tsx,**/*.ts,**/*.jsx"。各パターンは OR 条件で評価されます。

Q: applyTo が効かない場合のチェックポイントは？

settings.json に chat.instructionsFilesLocations が正しく設定されているか確認、ファイル拡張子が .instructions.md であるか確認、glob パターンが **/*.tsx のように再帰的指定になっているか確認してください。

GitHub Copilot 完全ガイド

この記事の対象者

技術スタックが混在するプロジェクトでCopilotを使い分けたい方

⚡ 5分で始めるクイックスタート

# 1. 設定を有効化
mkdir -p .vscode
cat << 'EOF' > .vscode/settings.json
{
  "chat.instructionsFilesLocations": {
    ".github/instructions/**/*.instructions.md": true
  }
}
EOF

# 2. インストラクションファイルを作成
mkdir -p .github/instructions
cat << 'EOF' > .github/instructions/frontend.instructions.md
---
description: "React/TypeScript専用ルール"
applyTo: "**/*.tsx,**/*.ts"
---
# フロントエンド開発ガイドライン
- TypeScript strict モード使用
- React Hooks の依存配列を必ず設定
EOF

# 3. コミット
git add .vscode/settings.json .github/instructions/
git commit -m "Add applyTo-based instructions"

検証: .tsx ファイルで Copilot Chat に質問 → 「References」に frontend.instructions.md が表示されれば成功

📍 インストラクション体系における位置づけ¶

applyTo パターンは、GitHub Copilot のインストラクション体系の中で「Path-specific（パス別ルール）」を担います。

階層	ファイル	適用タイミング
Repository-wide	`.github/copilot-instructions.md`	全リクエスト（常時）
Path-specific	`.instructions.md` + `applyTo`	パス一致時（自動）
Agent Skills	`.github/skills/*/SKILL.md`	エージェント判断時（オンデマンド）
AGENTS.md	`AGENTS.md`	エージェント起動時（マルチツール共通）

applyTo vs Agent Skills の使い分け

applyTo = ファイルパスに基づく自動適用。開発者が意識しなくても適切なルールが効く
Agent Skills = エージェントが必要と判断したときにオンデマンドで読み込む手順知識
例: React コンポーネントのコーディング規約 → applyTo、Terraform plan レビュー手順 → Skills

詳細な全体像はカスタムインストラクション完全ガイドを参照してください。

この記事のポイント¶

条件分岐型インストラクション
ファイル拡張子や命名パターンに応じた自動的なルール適用
コンテキスト効率化
関連性の高い情報のみを64kトークン制限内で集中投入
複数技術スタック対応
React/Python/YAML等の混在環境での最適化された開発支援
チーム作業標準化
議事録・PR・仕様書作成時の自動的な命名規則とフォーマット適用

📖 applyToパターンとは¶

GitHub Copilot の applyTo パターンは、カスタムインストラクションファイルにおいて特定の条件に合致するファイルにのみインストラクションを適用する機能です。

パスが合えば自動で効く

従来のカスタムインストラクションが全ファイルに適用されるのに対し、applyTo を使用することで：

ファイル拡張子別の専用ルール適用
命名パターン別の自動フォーマット適用
コンテキスト使用量の最適化

が可能になります。

⚙️ 前提条件：settings.json設定¶

重要：設定なしでは動作しません

applyTo パターンを活用するには、VS Codeの settings.json で複数インストラクションファイルの読み込みを有効化する必要があります。

必須設定¶

{
  "chat.instructionsFilesLocations": {
    ".github/instructions/**/*.instructions.md": true
  }
}

チーム全体での設定共有¶

.vscode/settings.json にプロジェクト設定として追加することで、チーム全体で統一できます：

{
  "chat.instructionsFilesLocations": {
    ".github/instructions/**/*.instructions.md": true,
    "docs/instructions/**/*.instructions.md": true
  }
}

🏗️ 基本的なファイル構成¶

project-root/
├── .github/
│   ├── copilot-instructions.md         # 基本ルール（確実読み込み）
│   └── instructions/
│       ├── frontend.instructions.md    # React/TypeScript用
│       ├── backend.instructions.md     # Python/API用
│       ├── meeting.instructions.md     # 議事録用
│       └── docs.instructions.md        # ドキュメント用
├── .vscode/
│   └── settings.json                   # プロジェクト設定
└── docs/
    └── instructions/
        └── style.instructions.md       # スタイルガイド用

YAML Frontmatter のプロパティ一覧¶

各 .instructions.md ファイルの先頭に記述する YAML Frontmatter では、以下のプロパティが使用できます。

プロパティ	必須	説明
`description`	推奨	インストラクションの概要（Copilotが読み込み判断に使用）
`applyTo`	○	適用対象のglobパターン（カンマ区切りで複数指定可）
`excludeAgent`	-	特定エージェントへの適用を除外

excludeAgent による適用制御¶

excludeAgent を指定すると、特定のエージェントにはインストラクションを適用しないよう制御できます。

---
description: "テスト実装ガイドライン"
applyTo: "**/*.test.ts,**/*.spec.ts"
excludeAgent: "code-review"
---

excludeAgent 値	除外対象
`coding-agent`	GitHub Copilot Coding Agent（Issue自動処理）
`code-review`	Copilot Code Review

Agent Mode との関係

Agent Mode（VS Code内のチャットエージェント）には excludeAgent は適用されません。excludeAgent はGitHub.com上で動作する Coding Agent や Code Review が対象です。

🔧 実践的な実装例¶

1. 技術スタック別インストラクション¶

フロントエンド用（React/TypeScript）¶

---
description: "React/TypeScript専用のコーディング規則"
applyTo: "**/*.tsx,**/*.ts"
---

# React/TypeScript開発ガイドライン

## 基本ルール
- React Hooksの依存配列を必ず適切に設定
- TypeScriptは strict モードで使用
- コンポーネント名はPascalCase
- カスタムHooksは "use" プレフィックス必須

## インポート順序
1. React関連
2. 外部ライブラリ
3. 内部コンポーネント
4. 型定義
5. スタイル

## 命名規則
- コンポーネントファイル: `ComponentName.tsx`
- カスタムHooks: `useFeatureName.ts`
- 型定義: `types/FeatureName.ts`

バックエンド用（Python/FastAPI）

---
description: "Python/FastAPI専用のコーディング規則"
applyTo: "**/*.py"
---

# Python/FastAPI開発ガイドライン

## 基本ルール
- Type hints必須
- Black フォーマッター使用
- docstringはGoogle形式
- 例外処理は必ず実装

## ファイル構成
- APIエンドポイント: `routers/feature_name.py`
- データモデル: `models/feature_name.py`
- ビジネスロジック: `services/feature_name.py`

## 命名規則
- 関数名: snake_case / クラス名: PascalCase / 定数: UPPER_SNAKE_CASE

議事録作成用

---
description: "会議議事録作成時の自動フォーマット"
applyTo: "meeting-*.md,**/meetings/*.md"
---

# 会議議事録作成ガイドライン

## ファイル命名規則
- 形式: `meeting-YYYY-MM-DD-[会議名].md`

## 必須構成
1. **会議情報** - 日時・参加者・会議種別
2. **議題** - 各議題に番号を付与
3. **決定事項** - 何が決定されたか＋影響範囲
4. **アクションアイテム** - `[ ] タスク（担当者：@username、期限：YYYY-MM-DD）`

プルリクエスト作成用

---
description: "PR作成時の自動テンプレート適用"
applyTo: "pr-*.md,pull_request_template.md"
---

# プルリクエスト作成ガイドライン

## 必須項目
- 📋 変更内容（新機能/バグ修正/リファクタリング/ドキュメント更新）
- 🔍 テスト（単体/結合/手動/エラーケース）
- 📝 チェックリスト（レビュー依頼/CI通過/ドキュメント更新/影響確認）

## ブランチ命名規則
- feature/機能名 / bugfix/バグ修正内容 / hotfix/緊急修正内容

技術仕様書用

---
description: "技術仕様書作成時の構成とフォーマット"
applyTo: "**/*-spec.md,**/specs/*.md"
---

# 技術仕様書作成ガイドライン

## 必須構成
1. **概要** - 機能の目的・想定ユーザー・成功基準
2. **技術仕様** - アーキテクチャ図・DB設計・API仕様
3. **実装方針** - 使用技術・設計パターン・セキュリティ考慮
4. **テスト仕様** - 単体/結合テスト範囲・性能要件

💡 デフォルト読み込みとの組み合わせ戦略¶

基本構成の設計思想¶

# .github/copilot-instructions.md（基本ルール - 確実読み込み）

## 全体共通ルール
- エラーハンドリング必須
- ログ出力の統一
- セキュリティ原則の遵守

## ファイル作成時の命名規則
- 議事録: `meeting-YYYY-MM-DD-[会議名].md`
- PR: `pr-[機能名]-YYYY-MM-DD.md`
- 仕様書: `[機能名]-spec.md`
- テスト: `[対象].test.[拡張子]`

## 技術スタック別の詳細ルール
フロントエンド: [.github/instructions/frontend.instructions.md]
バックエンド: [.github/instructions/backend.instructions.md]
インフラ: [.github/instructions/infrastructure.instructions.md]

この設計により： - 基本ルール：デフォルトファイルで確実に読み込み - 詳細ルール：applyToで条件に応じて自動適用 - 読み込み確実性：重要な情報は必ず伝わる

🚀 コンテキスト効率化のメリット¶

窓は有限、知識は選べ

Before / After: applyTo適用の効果¶

Before（全インストラクション一括読み込み）After（applyToでパス別に適用）

コンテキスト使用量: 15,000トークン
関連する情報: 3,000トークン（20%）
→ 大量のノイズがCopilotの判断を鈍らせる

コンテキスト使用量: 4,000トークン
関連する情報: 3,500トークン（87.5%）
→ 関連性の高い情報のみで高精度な提案

1. トークン使用量の最適化¶

従来の方式：
- 全インストラクション読み込み: 15,000トークン
- 実際に関連する情報: 3,000トークン
- 効率: 20%

applyTo方式：
- 該当インストラクションのみ読み込み: 4,000トークン
- 実際に関連する情報: 3,500トークン
- 効率: 87.5%

2. 応答精度の向上¶

条件分岐により関連性の高い情報のみがCopilotのコンテキストに含まれるため：

不要な情報によるノイズ削減
特定技術スタックに特化した提案
より具体的で実用的なコード生成

3. 認知負荷の軽減¶

開発者は作業中のファイルに応じて： - 自動的に適切なルールが適用される - 「今何のルールを守るべきか」を意識する必要がない - 開発フローの中断が最小化される

⚠️ 運用時の注意点¶

1. よくある設定ミス¶

// ❌ 拡張子なし
"chat.instructionsFilesLocations": {
    ".github/instructions/**/*.md": true
}

// ✅ 正しい拡張子
"chat.instructionsFilesLocations": {
    ".github/instructions/**/*.instructions.md": true
}

2. applyToパターンの記述ミス¶

# ❌ 間違った記述
applyTo: "*.tsx"

# ✅ 正しい記述
applyTo: "**/*.tsx"

3. 過度な分割による管理複雑化¶

❌ 避けるべき構成:
├── instructions/
│   ├── react-hooks.instructions.md
│   ├── react-context.instructions.md
│   ├── react-components.instructions.md
│   └── react-routing.instructions.md

✅ 推奨構成:
├── instructions/
│   ├── frontend.instructions.md
│   ├── backend.instructions.md
│   └── docs.instructions.md

🔍 効果測定の方法¶

1. 参照確認¶

Copilot Chatの応答に表示される「References」で： - 適切なインストラクションファイルが参照されているか - 不要なファイルが読み込まれていないか

2. 応答品質の評価¶

定期的に以下を確認： - 期待通りのコード生成が行われているか - 技術スタック固有の提案が含まれているか - 命名規則が正しく適用されているか

3. チームフィードバック¶

開発者からの使用感調査： - 開発効率の向上実感 - 提案内容の適切さ - 設定の使いやすさ

❓ よくある質問 (FAQ)¶

Q: applyTo パターンに複数の拡張子を指定できますか？

はい。カンマ区切りで複数指定できます。例: applyTo: "**/*.tsx,**/*.ts,**/*.jsx"。各パターンは OR 条件で評価されます。

Q: applyTo と copilot-instructions.md は併用できますか？

はい。copilot-instructions.md は常時適用される基本ルール、applyTo は条件付きの詳細ルールとして併用できます。両方のインストラクションがコンテキストに含まれます。

Q: applyTo が効かない場合のチェックポイントは？

settings.json に chat.instructionsFilesLocations が正しく設定されているか確認
ファイル拡張子が .instructions.md であるか確認（.md のみでは不可）
glob パターンが **/*.tsx のように再帰的指定になっているか確認（*.tsx はルート直下のみ）

🎯 まとめ¶

applyTo パターンは、GitHub Copilotカスタムインストラクションの効率化と精度向上を実現する強力な機能です。

重要なポイント¶

settings.json設定が前提条件
デフォルト読み込みとの組み合わせで確実性を担保
コンテキスト効率化による64kトークン制限の有効活用
技術スタック混在環境での最適化された開発支援

適切に設計・運用することで、従来のカスタムインストラクションでは実現できなかった条件分岐型の知識管理が可能になり、チーム開発の効率化と品質向上を同時に実現できます。

Agent Skillsガイド →

静的ルールの次は、必要時に自動で読むスキルを作る

🔗 関連記事¶

カスタムインストラクション完全ガイド
インストラクション体系の全体像とベストプラクティス
Agent Skillsガイド
オンデマンド起動の手順知識パッケージ
AGENTS.md統一管理ガイド
複数AIツールで共通利用できるプロジェクト命令
マルチエージェント協働ガイド
GitHub CopilotとClaude Codeの使い分け戦略