Copilot用デバッグツールガイド

拡張機能のブレークポイント MCP ツールについて説明または選択する場合は、このスキルを使用してください。

インストール、設定、ユーザー向けの使用方法については、まずメイン README を参照してください:

• 中文说明: README.md
• English guide: README.en.md

このスキルは、拡張機能が設定済みの後、ツール選択、パラメータ規則、および Copilot 側のガイダンスのみをカバーします。

ツールの選択

• list_breakpoints: 現在のブレークポイント状態が不明な場合は最初に使用します。
• list_breakpoints_in_file: ユーザーが特定のファイルのすべてのブレークポイントが必要な場合に使用します。
• get_breakpoint_statistics: ユーザーが現在のブレークポイントセットの概要が必要な場合に使用します。
• search_breakpoints: ユーザーがテキスト、種類、有効状態によってブレークポイントを記述する場合、またはフィルタリングが必要な場合に使用します。
• add_source_breakpoint: ファイルと場所にソースブレークポイントを追加する場合に使用します。
• add_function_breakpoint: 関数名で関数ブレークポイントを追加する場合に使用します。
• remove_breakpoint: key を優先して使用します。それ以外の場合は、関数ブレークポイントに functionName を使用するか、ソースブレークポイントに filePath + line、および必要に応じて column を使用します。
• set_breakpoint_enabled: key を優先して使用します。それ以外の場合は、関数ブレークポイントに functionName を使用するか、ソースブレークポイントに filePath + line、および必要に応じて column を使用します。
• update_breakpoint: key を優先して使用します。それ以外の場合は、関数ブレークポイントに functionName を使用するか、ソースブレークポイントに filePath + line、および必要に応じて column を使用します。有効状態、条件、ヒット条件、またはログメッセージを変更する場合はこれを使用してください。ブレークポイントを手動で再作成する必要はありません。
• set_breakpoints_enabled_in_file: 1 つのファイル内のすべてのソースブレークポイントを有効または無効にする場合に使用します。
• clear_breakpoints: VS Code に現在登録されているすべてのブレークポイントを削除する場合に使用します。
• list_debug_sessions: 現在認識されているデバッグセッションとその sessionId 値を列挙する場合に使用します。
• list_debug_threads: 選択したデバッグセッションで認識されているスレッドを列挙する場合に使用します。
• pause_debug_session: アクティブなデバッグセッションを一時停止する場合に使用します。
• continue_debug_session: アクティブなデバッグセッションを再開する場合に使用します。
• step_over_debug_session: 関数に入らずに現在の行をステップオーバーする場合に使用します。
• step_into_debug_session: 現在の行で呼び出された関数にステップインする場合に使用します。
• step_out_debug_session: 現在の関数からステップアウトする場合に使用します。
• restart_debug_session: 選択したデバッグセッションを停止し、解決された設定から再起動する場合に使用します。
• stop_debug_session: アクティブなデバッグセッションを停止する場合に使用します。
• open_debug_source_file: デバッグ前またはデバッグ中にアクティブなエディタをターゲットソースファイルに切り替える場合に使用します。
• list_debug_launch_configurations: 後で起動できる launch.json エントリを検査する場合に使用します。
• start_debug_launch_configuration: 起動設定名または生の設定オブジェクトからデバッグを開始する場合に使用します。
• list_debug_call_stack: 選択したセッションまたはスレッドのコールスタックを検査する場合に使用します。
• list_debug_scopes: 選択したスタックフレームのスコープを検査する場合に使用します。
• list_debug_variables: スコープまたは別の変数呼び出しによって返された変数参照を展開する場合に使用します。
• evaluate_debug_expression: 選択したデバッグコンテキストで式を評価する場合に使用します。
• list_debug_watch_expressions: 拡張機能で管理されるウォッチリストを検査する場合に使用します。
• add_debug_watch_expression: 拡張機能で管理されるウォッチリストに式を追加する場合に使用します。
• remove_debug_watch_expression: ID で拡張機能で管理される 1 つのウォッチ式を削除する場合に使用します。
• clear_debug_watch_expressions: 拡張機能で管理されるすべてのウォッチ式をクリアする場合に使用します。
• evaluate_debug_watch_expressions: 選択したデバッグコンテキストで、拡張機能で管理されるすべてのウォッチ式を評価する場合に使用します。

パラメータ規則

• filePath は絶対パスまたはワークスペース相対パスです。
• ツールが workspaceFolderPath を受け入れる場合、マルチルートワークスペースの相対パスにはこれを優先して使用します。
• functionName は関数ブレークポイントにのみ適用されます。
• line と column は 1 ベースです。
• update_breakpoint で condition、hitCondition、および logMessage を null に設定して既存の値をクリアできます。
• 相対パスは一致するワークスペースフォルダに対して解決します。明示的な workspaceFolderPath が指定されていない場合、拡張機能は一意のワークスペースフォルダを推測するか、曖昧さエラーを返します。
• ツール inputSchema に存在しないパラメータを作成しないでください。
• デバッグセッションツールはオプションの sessionId を受け入れます。省略された場合、アクティブなデバッグセッションで動作します。
• sessionId 値が利用可能なことを知る必要がある場合は、まず list_debug_sessions を使用してください。
• デバッグセッションを選択した後、どのスレッド ID が利用可能なことを知る必要がある場合は list_debug_threads を使用してください。
• アダプタ固有の再起動リクエストではなく、停止と再起動の動作には restart_debug_session を使用します。
• 起動またはステップの前にアクティブなエディタをターゲットソースファイルに切り替える必要がある場合は open_debug_source_file を使用します。
• .vscode/launch.json を検査する場合は list_debug_launch_configurations を使用します。複数のワークスペースフォルダに同じ設定名が含まれている場合、起動時に workspaceFolderPath を渡します。
• list_debug_launch_configurations から解析された起動エントリが既にある場合は、start_debug_launch_configuration を生の設定オブジェクトで使用します。
• ブレークポイントで一時停止した後またはフレームで停止している間に、list_debug_call_stack、list_debug_scopes、list_debug_variables、および evaluate_debug_expression を使用します。
• ネイティブの VS Code ウォッチパネルを読まない、再利用可能な拡張機能で管理されるウォッチリストが必要な場合は、ウォッチ式ツールを使用します。
• list_debug_sessions はベストエフォートであり、アクティベーション後に拡張機能が観察したセッションのみを反映します。

推奨ワークフロー

1. list_breakpoints または search_breakpoints で現在の状態を検査します。
2. ブレークポイントが既にある場合は、既存のブレークポイントを変更するときに key を使用します。
3. ブレークポイントプロパティの変更のみが必要な場合は update_breakpoint を使用します。
4. 安定した key が利用できない場合は、関数ブレークポイントに functionName を使用します。
5. 安定した key が利用できない場合は、ソースブレークポイントに対してのみファイルベースのターゲティングを使用します。
6. ユーザーがツールを呼び出す方法を尋ねた場合は、必要なフィールドと一致するルールを説明します。
7. 一時停止/継続/ステップ/再起動/停止リクエストの場合は、ブレークポイントツールではなく一致するデバッグセッションツールを選択します。
8. ターゲットデバッグセッションが曖昧な場合は、最初に list_debug_sessions を呼び出し、選択した sessionId を渡します。
9. 選択したセッション内でステップするためにスレッド ID が必要な場合は、最初に list_debug_threads を呼び出します。
10. ユーザーが別のクライアント用の再利用可能な MCP 設定スニペットを求めた場合は、Export MCP Configuration コマンドに指示します。

リファレンス

• ユーザーガイド: README.md / README.en.md
• 中文说明: doc/mcp-tools.zh-cn.md
• English guide: doc/mcp-tools.en.md