GitHub Copilot
Best Practices

Copilot はマルチモデル対応。チャットパネルのモデルセレクターから切り替えるか、設定で固定できる。

VS Code のチャットパネル右上のモデル名をクリックして切り替え。タスクごとにモデルを使い分けるのがベスト。

チャットパネルで「Agent」モードに切り替えると、Copilot がファイル操作・ターミナル実行・Web検索を自律的に行う。

• コンテキスト変数: #file / #selection / @workspace でスコープを指定
• ツール: ファイル読み書き・ターミナル・ブラウザ（設定次第）
• 承認プロンプト: ファイル変更・コマンド実行前に確認が入る（Agent設定で制御可）
• Multi-Agent: 2026-06 Build発表。並列サブエージェントがそれぞれ独立したタスクを担当

# チャットの例
@workspace テスト未カバーの関数を列挙して、
          Vitestのテストを自動生成してください

#file:src/api.ts この関数のバリデーションを強化して
               エラーメッセージを日本語にしてください

applyTo フロントマターで適用ファイルのグロブパターンを指定できる（複数ファイルに分割可能）。

# .github/instructions/react.instructions.md
---
applyTo: "src/components/**/*.tsx"
---

ReactコンポーネントはforwardRefを使わない。
propsにはインターフェースを使い、型エイリアスは避ける。
useEffectの依存配列は必ず正確に指定すること。

# .github/instructions/api.instructions.md
---
applyTo: "src/api/**/*.ts"
---

APIレスポンスはzodスキーマでバリデーションする。
エラーは never throw — 必ず Result 型を返す。
fetch はラッパー関数 apiClient() 経由のみ使用可。

全プロジェクト共通の個人的な指示は VS Code 設定から登録できる。

{
  "github.copilot.chat.codeGeneration.useInstructionFiles": true,
  "github.copilot.chat.codeGeneration.instructions": [
    {
      "text": "日本語でコメントを書いてください。変数名・関数名は英語。"
    },
    {
      "text": "エラーメッセージは常に日本語にしてください。"
    }
  ]
}

# インタラクティブモード
copilot "テストが通っていないコードを修正して"

# 自動承認（確認プロンプトをスキップ）
copilot -y "依存パッケージをすべて最新に更新して"

# Autopilot（完了まで自律継続）
copilot --autopilot "認証機能を実装して PR まで作成して"

# クラウドデリゲート（バックグラウンド非同期実行）
copilot & "大規模リファクタリングを実行して"

# モデル指定
copilot --model claude-sonnet-4-6 "パフォーマンス改善案を出して"
copilot --model gpt-5.5 "このアルゴリズムを最適化して"

# 特定ファイルをコンテキストに
copilot --context src/api.ts "このファイルのテストを書いて"

Copilot CLI には GitHub MCP サーバーがデフォルト搭載。設定不要で GitHub の Issues・PR・リポジトリ操作ができる。

# ~/.copilot/mcp.json で追加 MCP を設定
{
  "mcpServers": {
    "github": {
      "enabled": true,
      "tools": ["create_issue", "create_pull_request", "list_prs"]
    },
    "filesystem": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-filesystem", "."]
    }
  }
}

# Autopilot: タスク完了まで自律実行（PRまで）
copilot --autopilot --branch feat/auth \
  "JWTリフレッシュトークンの実装をして、テストも書いてPRを作成して"

# Fleet Mode: 複数タスクを並列処理
copilot fleet --tasks tasks.yaml

# tasks.yaml
tasks:
  - name: fix-auth
    prompt: "認証バグを修正"
  - name: add-tests
    prompt: "カバレッジ80%以上になるようテストを追加"
  - name: update-docs
    prompt: "READMEを最新の仕様に合わせて更新"

デフォルト設定ディレクトリは ~/.copilot/。COPILOT_HOME 環境変数で変更可能。

~/.copilot/
  settings.json           # メイン設定（モデル・権限・UI・ツール制御）
  copilot-instructions.md # 個人の永続指示（全セッション・全プロジェクトに適用）
  instructions/
    *.instructions.md     # 追加の個人指示ファイル
  agents/
    *.agent.md            # 個人カスタムエージェント（全セッションで利用可）
  skills/
    {name}/SKILL.md       # 個人カスタムスキル定義
  mcp-config.json         # ユーザーレベル MCP サーバー設定（全セッション）
  lsp-config.json         # Language Server Protocol 設定
  hooks/                  # ユーザーレベル hook スクリプト
  extensions/             # ユーザーレベル拡張
  permissions-config.json # ツール・ディレクトリ権限の永続承認（自動管理）

リポジトリレベル設定（Git 管理）:

.github/copilot/
  settings.json           # チーム共有設定（限定キーのみ有効）
  settings.local.json     # 個人オーバーライド（.gitignore に追加する）

リポジトリ共有 settings.json で有効なキー:

// .github/copilot/settings.json — チームで共有できるキーのみ
{
  "companyAnnouncements": "...",
  "disableAllHooks": false,
  "enabledPlugins": ["plugin-name"],
  "hooks": { ... },
  "mergeStrategy": "rebase"
}

ユーザー settings.json の主要キー:

設定の優先順位（低 → 高）: ビルトインデフォルト → MDM ポリシー → ユーザー設定（~/.copilot/settings.json）→ リポジトリ設定（.github/copilot/settings.json）→ ローカル設定（settings.local.json）→ 環境変数 → CLI フラグ

.agent.md フロントマター（Copilot App 向け）:

---
name: My Cloud Agent
description: リポジトリのセキュリティチェックを担当するエージェント（必須）
tools: ["read", "search"]
target: github-copilot    # vscode / github-copilot / 省略で両方
disable-model-invocation: false
---

エージェント本体の指示をここに書く（最大 30,000 文字）。
model プロパティは VS Code / JetBrains など IDE 側でのみ有効。
Copilot App（クラウド）では model 指定不可。

copilot.github.com/workspace からブラウザで利用。リポジトリ全体を推論・計画→多ファイル編集→テスト実行→反復までを Web UI で完結させる。

• 大規模リファクタリングや機能追加に向く
• 変更前にプラン（タスクリスト）を確認してから実行できる
• GitHub Actions と連携してテストを自動実行

パブリックリポジトリのコードと一致する補完をブロックする機能（ライセンスリスク低減）。

{
  "github.copilot.advanced": {
    "secret_key": "",
    "length": 0
  },
  // GitHub.com の設定から有効化
  // Settings → Copilot → Suggestions matching public code: Block
}

• GitHub Enterprise Cloud: Organization・Enterprise レベルで Copilot の利用範囲を制御
• Copilot Business/Enterprise: データをモデルトレーニングに使用しない（利用規約で保証）
• IP Indemnity: Enterprise プランはコンテンツに関する知的財産侵害の法的保護あり
• Audit Log: Copilot のアクティビティをOrg単位で監査可能

# GitHub CLI でインストール（v2.90.0 以上が必要）
gh skills install github/awesome-copilot <skill-name>

# スキルの一覧・更新・公開
gh skill list
gh skill update <skill-name>
gh skill publish

# 使用可能な値の例
allowed-tools:
  - shell(git:*)          # git コマンドすべて
  - npm(build)            # npm build のみ
  - write                 # ファイル書き込み
  - GitHub(create_issue)  # GitHub MCP の特定ツールのみ

⚠️ shell/bash の事前承認はプロンプトインジェクションで任意コマンド実行のリスクあり。信頼できる自作スキルのみに限定すること。

SKILL.md はオープンスタンダード（agentskills.io）として両社が採用。将来的に他ツールへの展開も想定される。