GitHub Copilot CLI向けLSPセットアップ

ユーティリティスキル — Copilot CLI用Language Server Protocolサーバーをインストール・設定します。 使用シーン: 「LSPをセットアップしたい」「言語サーバーをインストールしたい」「JavaのLSPを設定したい」「TypeScript LSPを追加したい」「コード智能化を有効にしたい」「定義へ移動が必要」「参照検索が動作しない」「より良いコード理解が必要」 使用しないシーン: 一般的なコーディングタスク、IDE/エディターのLSP設定、Copilot CLI以外のセットアップ

ワークフロー

1. 言語を確認 — ask_userを使ってLSPサポートが必要なプログラミング言語を質問
2. OSを検出 — uname -s(またはWindowsの場合は$env:OS / %OS%)を実行してmacOS、Linux、Windowsを判定
3. LSPサーバーを検索 — references/lsp-servers.mdから既知のサーバー、インストールコマンド、設定スニペットを確認
4. スコープを確認 — ask_userを使ってユーザーレベル(~/.copilot/lsp-config.json)かリポジトリレベル(リポジトリルートのlsp.jsonまたは.github/lsp.json)のいずれか設定をリクエスト
5. サーバーをインストール — 検出したOSに対応するインストールコマンドを実行
6. 設定を記述 — 新しいサーバーエントリを選択した設定ファイル(ユーザーレベルは~/.copilot/lsp-config.json、リポジトリレベルはlsp.jsonまたは.github/lsp.json)にマージします。リポジトリレベル設定が既に存在する場合はその場所を継続利用し、存在しない場合はユーザーにどのリポジトリレベル場所を使うか質問します。ファイルが存在しない場合は作成し、既存エントリは保持します。
7. 検証 — LSPバイナリが$PATH上にあること、設定ファイルが有効なJSONであることを確認

設定フォーマット

Copilot CLIはユーザーレベルまたはリポジトリレベル場所からLSP設定を読み込み、リポジトリレベル設定がユーザーレベル設定よりも優先されます:

• ユーザーレベル: ~/.copilot/lsp-config.json
• リポジトリレベル: lsp.json(リポジトリルート)または.github/lsp.json

JSON構造:

{
  "lspServers": {
    "<server-key>": {
      "command": "<binary>",
      "args": ["--stdio"],
      "fileExtensions": {
        ".<ext>": "<languageId>",
        ".<ext2>": "<languageId>"
      }
    }
  }
}

主要ルール

• commandはバイナリ名($PATH上に存在する必要があります)または絶対パス
• argsはほぼ常に標準I/O転送を使う"--stdio"を含む
• fileExtensionsは各ファイル拡張子(ドット付き)をLanguage IDにマッピング
• 複数のサーバーはlspServersに共存可能
• 既存ファイルにマージする場合、他のサーバーエントリを上書きしない — 対象言語キーの追加または更新のみ実行

動作

• ユーザーに言語またはスコープを選ばせるときは常にchoices付きask_userを使う
• references/lsp-servers.mdに言語が記載されていない場合、「<言語> LSP server」でウェブ検索し、ユーザーに手動設定をガイド
• パッケージマネージャーが利用できない場合(例:macOSでHomebrew未インストール)、参照ファイルから代替インストール方法を提案
• インストール後、which <binary>(Windowsの場合はwhere.exe)を実行してバイナリがアクセス可能であることを確認
• ユーザーに最終的な設定JSONを記述前に表示
• 設定ファイルが既に存在する場合は先に読み込んでマージ — 上書きしない

検証

セットアップ後、ユーザーに以下を伝えます:

1. /exitを入力してCopilot CLIを終了 — 次回起動時に新しいLSP設定が読み込まれるため必須です
2. 設定した言語のファイルがあるプロジェクトでcopilotを再起動
3. /lspを実行してサーバーステータスを確認
4. 定義へ移動やホバーなどのコード智能化機能を試す