GitHub Copilot
Best Practices

デフォルト設定ディレクトリは ~/.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 はマルチモデル対応。チャットパネルのモデルセレクターから切り替えるか、設定で固定できる。

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

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

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

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

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

# インタラクティブモード
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.github.com/workspace からブラウザで利用。リポジトリ全体を推論・計画→多ファイル編集→テスト実行→反復までを Web UI で完結させる。

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

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 Chatの内蔵ツール「memory tool」（プレビュー）は3つのスコープを持つ。

• User memory — 全ワークスペース共通、ローカル保存
• Repository memory — 現在のワークスペースに限定、既定ではローカル保存
• Session memory — 会話終了で揮発

Repository memoryの実体はワークスペースごとの単なるMarkdownファイル。VS CodeのworkspaceStorage配下（GitHub.copilot-chat拡張のフォルダ内）に生成される。公式ドキュメントは保存場所がworkspaceStorage配下であることまでは明記しているが、以下の詳細な階層・ファイル名は個別のユーザー環境での実機観測例であり公式ドキュメントには未記載

# Windows の場合（ユーザー報告に基づく例）
%APPDATA%\Code\User\workspaceStorage\<ワークスペース固有ハッシュ>\
  GitHub.copilot-chat\memory-tool\memories\repo\project_notes.md

オフにする・中身を見る方法：

// settings.json — memory tool 自体を無効化
{
  "chat.tools.memory.enabled": false
}

// 何が実際にコンテキストへ渡されたか確認する
// Chat view を右クリック → Diagnostics

Repository memoryを有効化すると、保存先がGitHubホスト側の「Copilot Memory」（2026-01-15 パブリックプレビュー開始）に切り替わり、coding agent・code review・CLIの間で共有されるようになる。2026-03-04以降、Copilot Pro/Pro+ユーザーは既定でON（オプトイン→オプトアウト方式に変更済み）。この場合、以下の管理コントロールが効く。

• リポジトリ管理者: リポジトリSettings内の既存Copilot機能コントロールから、そのリポジトリ単位で無効化可能
• 個人（Copilot Pro/Pro+）: 個人のCopilot設定 「Features → Copilot Memory」からいつでも無効化可能
• 各記憶は既定で28日後に自動失効

なお chat.tools.memory.enabled はローカルmemory tool専用のスイッチで、クラウド版Copilot Memoryの有効/無効はこれとは別（個人設定画面から操作）。混同注意。

# 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）として両社が採用。将来的に他ツールへの展開も想定される。

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

{
  "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単位で監査可能