# getDiagnostics

接続された IDE から特定のファイルまたは IDE が現在開いているすべてのファイルについて言語サーバーの診断 (エラー、警告、ヒント) を取得します。タスクを完了と宣言する前に、コード変更がクリーンにコンパイルされることを確認するために使用します。

## 使用タイミング

- `Edit` または `Write` の後に、変更が型エラー、構文エラー、またはリント警告を導入しなかったことを確認。
- タスクを終了する前に、すべての開いているファイルを一掃して未解決の問題を探す。
- ユーザーが報告するエラーを診断するとき — IDE から正確なコンパイラまたは型チェッカーメッセージを取得することで推測を避ける。
- 静的な正しさをチェックするだけでよい場合に、完全なビルドまたはテストコマンドを実行する軽量な代替。

テストスイートの代替として `getDiagnostics` に頼らないでください。言語サーバーが見るものを報告し、テストまたは本番時に実行されるものではありません。

## パラメータ

- `uri` (string, optional): 診断を取得するファイル URI (通常 `file:///absolute/path`)。省略すると、IDE が現在開いているすべてのファイルの診断を返します。

## 例

### 例 1: 編集後に単一ファイルをチェック

```
getDiagnostics(
  uri="file:///Users/sky/project/src/auth.ts"
)
```

`src/auth.ts` の TypeScript エラー、ESLint 警告、その他の言語サーバーメッセージを返します。

### 例 2: すべての開いているファイルを一掃

```
getDiagnostics()
```

現在開いているすべてのエディタの診断を返します。マルチファイルリファクタリングの終わりに、他の場所で何も後退していないことを確認するのに便利です。

## 注意事項

- `getDiagnostics` は IDE ブリッジツールです。Claude Code がサポートする IDE 統合 (例えば VS Code 拡張) に接続されている場合にのみ利用可能です。プレーンなターミナルセッションではツールは表示されません。
- 結果は IDE がロードした言語サーバー — TypeScript、Pyright、ESLint、rust-analyzer など — が見るものを反映します。品質とカバレッジはユーザーの IDE セットアップに依存し、Claude Code には依存しません。
- 診断はライブです。編集後、空の結果を成功と解釈する前に、言語サーバーに再解析の時間を与えてください — ファイルを保存したばかりなら再実行してください。
- 重要度レベルには通常 `error`、`warning`、`information`、`hint` が含まれます。最初に `error` に焦点を当ててください。警告は意図的なプロジェクトスタイルかもしれません。
- IDE に現在開いていないファイルの場合、ファイルに実際の問題が含まれていても、言語サーバーは診断を報告しないかもしれません。権威あるカバレッジのためには、ファイルを開くかビルドを実行してください。
