cc-viewer 1.6.182 → 1.6.183

package/concepts/ja/Tool-WebFetch.md

@@ -1,55 +1,50 @@
 # WebFetch
 
-## 定義
+公開 Web ページの内容を取得し、HTML を Markdown に変換して、自然言語プロンプトを使って結果に対して小さな補助モデルを実行し、必要な情報を抽出します。
 
-指定 URL のウェブページ内容を取得し、HTML を markdown に変換し、AI モデルで prompt に基づいて内容を処理します。
+## 使用タイミング
+
+- 会話で参照された公開ドキュメントページ、ブログ投稿、または RFC を読む。
+- 既知の URL から特定の事実、コードスニペット、またはテーブルを、ページ全体をコンテキストにロードせずに抽出する。
+- 公開 Web リソースのリリースノートやチェンジログを要約する。
+- ソースがローカルリポジトリにない場合にライブラリの公開 API リファレンスを確認する。
+- ユーザーがチャットに貼り付けたリンクをたどってフォローアップの質問に答える。
 
 ## パラメータ
 
-| パラメータ | 型 | 必須 | 説明 |
-|------------|------|------|------|
-| `url` | string (URI) | はい | 取得する完全な URL |
-| `prompt` | string | はい | ページからどの情報を抽出するかの説明 |
+- `url` (string, required): 完全な形式の絶対 URL。プレーンな `http://` は自動的に `https://` にアップグレードされます。
+- `prompt` (string, required): 小さな抽出モデルに渡される指示。「すべてのエクスポートされた関数をリストする」や「サポートされる最小 Node バージョンを返す」など、ページから何を取り出すかを正確に記述します。
+
+## 例
+
+### 例 1: 設定デフォルトを抽出
+
+```
+WebFetch(
+  url="https://vitejs.dev/config/server-options.html",
+  prompt="What is the default value of server.port and can it be a string?"
+)
+```
+
+ツールは Vite docs ページを取得し、Markdown に変換し、「デフォルトは `5173`、数値のみを受け入れる」のような短い回答を返します。
 
-## 使用シナリオ
+### 例 2: チェンジログセクションを要約
 
-**適している場合：**
-- 公開ウェブページの内容を取得
-- オンラインドキュメントの参照
-- ウェブページから特定の情報を抽出
+```
+WebFetch(
+  url="https://nodejs.org/en/blog/release/v20.11.0",
+  prompt="List the security fixes included in this release as bullet points."
+)
+```
 
-**適していない場合：**
-- 認証が必要な URL（Google Docs、Confluence、Jira、GitHub など）——まず専用の MCP ツールを探すべき
-- GitHub URL——`gh` CLI を優先使用
+ユーザーが「Node 20.11 で何が変わった？」と尋ね、リリースページが長い場合に便利です。
 
 ## 注意事項
 
-- URL は完全な有効 URL でなければならない
-- HTTP は自動的に HTTPS にアップグレード
-- 内容が大きすぎる場合、結果が要約される可能性がある
-- 15分の自動クリーニングキャッシュを含む
-- URL が異なるホストにリダイレクトされた場合、ツールはリダイレクト URL を返し、新しい URL で再リクエストが必要
-- MCP 提供の web fetch ツールが利用可能な場合、そちらを優先使用
-
-## 原文
-
-<textarea readonly>IMPORTANT: WebFetch WILL FAIL for authenticated or private URLs. Before using this tool, check if the URL points to an authenticated service (e.g. Google Docs, Confluence, Jira, GitHub). If so, you MUST use ToolSearch first to find a specialized tool that provides authenticated access.
-
-- Fetches content from a specified URL and processes it using an AI model
-- Takes a URL and a prompt as input
-- Fetches the URL content, converts HTML to markdown
-- Processes the content with the prompt using a small, fast model
-- Returns the model's response about the content
-- Use this tool when you need to retrieve and analyze web content
-
-Usage notes:
-  - IMPORTANT: If an MCP-provided web fetch tool is available, prefer using that tool instead of this one, as it may have fewer restrictions.
-  - The URL must be a fully-formed valid URL
-  - HTTP URLs will be automatically upgraded to HTTPS
-  - The prompt should describe what information you want to extract from the page
-  - This tool is read-only and does not modify any files
-  - Results may be summarized if the content is very large
-  - Includes a self-cleaning 15-minute cache for faster responses when repeatedly accessing the same URL
-  - When a URL redirects to a different host, the tool will inform you and provide the redirect URL in a special format. You should then make a new WebFetch request with the redirect URL to fetch the content.
-  - For GitHub URLs, prefer using the gh CLI via Bash instead (e.g., gh pr view, gh issue view, gh api).
-</textarea>
+- `WebFetch` は認証、Cookie、または VPN を必要とする URL では失敗します。Google Docs、Confluence、Jira、プライベート GitHub リソース、内部 wiki には、認証付きアクセスを提供する専用 MCP サーバーを代わりに使用してください。
+- GitHub にホストされているもの (PR、issue、ファイル blob、API 応答) には、Web UI をスクレイピングするよりも `Bash` 経由の `gh` CLI を優先してください。`gh pr view`、`gh issue view`、`gh api` は構造化データを返し、プライベートリポジトリに対しても動作します。
+- 取得されたページが非常に大きい場合、結果は要約されることがあります。正確なテキストが必要な場合は、`prompt` を絞ってリテラル抽出を求めてください。
+- URL ごとに 15 分の自己クリーニングキャッシュが適用されます。同じページへの 1 セッション中の繰り返し呼び出しはほぼ瞬時ですが、わずかに古いコンテンツを返すことがあります。鮮度が重要な場合はプロンプトで言及するか、キャッシュが切れるのを待ってください。
+- 対象ホストがクロスホストリダイレクトを発行した場合、ツールは特別な応答ブロックで新しい URL を返し、自動的には従いません。まだコンテンツが必要な場合は、リダイレクト先で `WebFetch` を再呼び出ししてください。
+- プロンプトはメインアシスタントよりも小さく高速なモデルによって実行されます。狭く具体的に保ってください。複雑なマルチステップ推論は、取得後に生の Markdown を自分で読む方がうまく処理できます。
+- URL に埋め込まれたシークレット、トークン、またはセッション識別子を絶対に渡さないでください — 出力に反映されるページコンテンツやクエリ文字列は上流サービスによってログに記録される可能性があります。

package/concepts/ja/Tool-WebSearch.md

@@ -1,58 +1,51 @@
 # WebSearch
 
-## 定義
+ライブ Web 検索を実行し、モデルのトレーニングカットオフを超える最新情報でアシスタントが回答を根拠付けるためのランク付けされた結果を返します。
 
-検索エンジンクエリを実行し、最新情報を取得するための検索結果を返します。
+## 使用タイミング
+
+- 時事問題、最近のリリース、または速報ニュースに関する質問に答える。
+- ライブラリ、フレームワーク、CLI ツールの最新バージョンを調べる。
+- 正確な URL が分からないドキュメントやブログ投稿を見つける。
+- モデルがトレーニングされて以降に変わった可能性のある事実を検証する。
+- `WebFetch` で特定のページを取得する前に、トピックに関する複数の視点を発見する。
 
 ## パラメータ
 
-| パラメータ | 型 | 必須 | 説明 |
-|------------|------|------|------|
-| `query` | string | はい | 検索クエリ（最低2文字） |
-| `allowed_domains` | string[] | いいえ | これらのドメインの結果のみを含む |
-| `blocked_domains` | string[] | いいえ | これらのドメインの結果を除外 |
+- `query` (string, required): 検索クエリ。最小 2 文字。「最新」または「最近」の情報について尋ねるときは、結果が新鮮になるよう現在の年を含めてください。
+- `allowed_domains` (array of strings, optional): 結果をこれらのドメインのみに制限します。例えば `["nodejs.org", "developer.mozilla.org"]`。特定のソースを信頼する場合に便利です。
+- `blocked_domains` (array of strings, optional): これらのドメインからの結果を除外します。同じドメインを `allowed_domains` と `blocked_domains` の両方に渡さないでください。
+
+## 例
+
+### 例 1: 現在の年でバージョンを検索
+
+```
+WebSearch(
+  query="React 19 stable release date 2026",
+  allowed_domains=["react.dev", "github.com"]
+)
+```
+
+公式アナウンスを返し、低品質アグリゲーターサイトを避けます。
+
+### 例 2: ノイズの多いソースを除外
 
-## 使用シナリオ
+```
+WebSearch(
+  query="kubernetes ingress-nginx CVE April 2026",
+  blocked_domains=["pinterest.com", "medium.com"]
+)
+```
 
-**適している場合：**
-- モデルの知識カットオフ日を超えた最新情報の取得
-- 現在のイベントや最新データの検索
-- 最新の技術ドキュメントの検索
+結果をベンダーアドバイザリとセキュリティトラッカーに集中させ続けます。
 
 ## 注意事項
 
-- 検索結果は markdown ハイパーリンク形式で返される
-- 使用後はレスポンスの末尾に "Sources:" セクションを付け、関連 URL を列挙する必要がある
-- ドメインフィルタリング（包含/除外）に対応
-- 検索クエリには現在の年を使用すべき
-- 米国でのみ利用可能
-
-## 原文
-
-<textarea readonly>
-- Allows Claude to search the web and use the results to inform responses
-- Provides up-to-date information for current events and recent data
-- Returns search result information formatted as search result blocks, including links as markdown hyperlinks
-- Use this tool for accessing information beyond Claude's knowledge cutoff
-- Searches are performed automatically within a single API call
-
-CRITICAL REQUIREMENT - You MUST follow this:
-  - After answering the user's question, you MUST include a "Sources:" section at the end of your response
-  - In the Sources section, list all relevant URLs from the search results as markdown hyperlinks: [Title](URL)
-  - This is MANDATORY - never skip including sources in your response
-  - Example format:
-
-    [Your answer here]
-
-    Sources:
-    - [Source Title 1](https://example.com/1)
-    - [Source Title 2](https://example.com/2)
-
-Usage notes:
-  - Domain filtering is supported to include or block specific websites
-  - Web search is only available in the US
-
-IMPORTANT - Use the correct year in search queries:
-  - The current month is March 2026. You MUST use this year when searching for recent information, documentation, or current events.
-  - Example: If the user asks for "latest React docs", search for "React documentation" with the current year, NOT last year
-</textarea>
+- 回答で `WebSearch` を使用するときは、応答の最後に `Sources:` セクションを追加し、引用された各結果を `[Title](URL)` 形式の Markdown ハイパーリンクとしてリストする必要があります。これは任意ではなく、厳格な要件です。
+- `WebSearch` はアメリカ合衆国のユーザーのみ利用可能です。地域でツールが利用できない場合は、既知の URL に対して `WebFetch` にフォールバックするか、ユーザーに関連コンテンツを貼り付けるよう依頼してください。
+- 各呼び出しは検索を単一のラウンドトリップで実行します — ストリームやページネーションはできません。最初の結果セットがターゲットから外れている場合は、クエリを絞り込んでください。
+- ツールはスニペットとメタデータを返し、完全なページ内容は返しません。特定のヒットを詳しく読むには、返された URL を使って `WebFetch` でフォローアップしてください。
+- CVE やコンプライアンスなどのセキュリティに敏感な質問では、権威あるソースを強制するために `allowed_domains` を使用し、ドキュメントをミラーする SEO ファームを削除するために `blocked_domains` を使用してください。
+- クエリは短くキーワード駆動に保ってください。自然言語の質問は機能しますが、主要ソースではなく会話的な回答を返す傾向があります。
+- 検索直感に基づいて URL を発明しないでください — 常に検索を実行し、ツールが実際に返したものを引用してください。

package/concepts/ja/Tool-Write.md

@@ -1,39 +1,35 @@
 # Write
 
-## 定義
+ローカルファイルシステム上で新しいファイルを作成するか、既存のファイルの内容を完全に置換します。対象パスのすべてを置換するため、本当の作成や意図的な完全書き換えのために予約すべきです。
 
-ローカルファイルシステムにコンテンツを書き込みます。ファイルが既に存在する場合は上書きします。
+## 使用タイミング
 
-## パラメータ
+- まだ存在しない新しいソースファイル、テスト、または設定を作成
+- フィクスチャ、スナップショット、またはデータファイルをゼロから生成
+- 段階的な `Edit` がやり直すよりも複雑になる完全書き換え
+- ユーザーが明示的に生成を依頼した、スキーマ、マイグレーション、ビルドスクリプトなどのアーティファクトを出力
 
-| パラメータ | 型 | 必須 | 説明 |
-|------------|------|------|------|
-| `file_path` | string | はい | ファイルの絶対パス（絶対パスでなければならない） |
-| `content` | string | はい | 書き込む内容 |
+## パラメータ
 
-## 使用シナリオ
+- `file_path` (string, required): 書き込むファイルの絶対パス。親ディレクトリはすでに存在している必要があります。
+- `content` (string, required): ファイルに書き込む完全なテキスト。これがファイル本体全体になります。
 
-**適している場合：**
-- 新規ファイルの作成
-- ファイル内容を完全に書き換える必要がある場合
+## 例
 
-**適していない場合：**
-- ファイル内の部分的な内容の変更——Edit を使用すべき
-- ドキュメントファイル（*.md）や README を自発的に作成すべきではない。ユーザーが明示的に要求した場合を除く
+### 例 1: 新しいヘルパーモジュールを作成
+`file_path: "/Users/me/app/src/utils/slugify.ts"` で `Write` を呼び出し、実装を `content` として提供します。ファイルがまだ存在しないことを確認してからのみ使用してください。
 
-## 注意事項
+### 例 2: 派生アーティファクトを再生成
+スキーマソースが変更された後、新しく生成された JSON を `content` として使って 1 回の `Write` 呼び出しで `/Users/me/app/generated/schema.json` を書き直します。
 
-- 対象ファイルが既に存在する場合、先に Read で読み取る必要がある。そうでないと失敗する
-- 既存ファイルの全内容を上書きする
-- 既存ファイルの編集には Edit を優先使用し、Write は新規ファイル作成または完全な書き換えにのみ使用
+### 例 3: 小さなフィクスチャファイルを置換
+すべての行が変わる使い捨てテストフィクスチャの場合、`Write` は一連の `Edit` 呼び出しより明確です。最初にファイルを読み、スコープを確認してから上書きしてください。
 
-## 原文
-
-<textarea readonly>Writes a file to the local filesystem.
+## 注意事項
 
-Usage:
-- This tool will overwrite the existing file if there is one at the provided path.
-- If this is an existing file, you MUST use the Read tool first to read the file's contents. This tool will fail if you did not read the file first.
-- Prefer the Edit tool for modifying existing files — it only sends the diff. Only use this tool to create new files or for complete rewrites.
-- NEVER create documentation files (*.md) or README files unless explicitly requested by the User.
-- Only use emojis if the user explicitly requests it. Avoid writing emojis to files unless asked.</textarea>
+- 既存ファイルを上書きする前に、現在のセッションで `Read` を呼び出す必要があります。`Write` は見ていない内容を上書きすることを拒否します。
+- ファイルの一部だけに触れる変更には `Edit` を優先してください。`Edit` は差分だけを送信するため、より速く、安全で、レビューしやすくなります。
+- ユーザーが明示的に依頼しない限り、Markdown ドキュメント、`README.md`、チェンジログファイルを積極的に作成しないでください。
+- ユーザーがそのスタイルを要求しない限り、絵文字、マーケティング文、装飾バナーを追加しないでください。
+- `Bash` の `ls` 呼び出しで最初に親ディレクトリが存在することを確認してください。`Write` は中間フォルダを作成しません。
+- テンプレートや後処理はないので、永続化したい内容を正確に提供してください。

package/concepts/ja/Tool-executeCode.md

@@ -1,41 +1,47 @@
-# executeCode (mcp__ide__executeCode)
+# executeCode
 
-## 定義
+IDE 統合 (例えば現在開いているノートブックにバインドされた Jupyter カーネル) が提供するライブカーネルまたはサンドボックス内でコードスニペットを実行します。このツールは、VS Code 拡張などの互換性のある IDE ブリッジと Jupyter カーネルが選択された状態で Claude Code が実行されているときにのみ存在します。
 
-現在の notebook ファイルの Jupyter kernel で Python コードを実行します。
+## 使用タイミング
+
+- アクティブな Jupyter カーネルにすでにロードされた状態に対して、素早い計算、データ検査、またはプロットを実行。
+- コードスニペットをノートブックセルに貼り付ける前に検証。
+- カーネルに存在するがディスクにシリアライズされていないインメモリデータフレーム、変数、またはモデルを探索。
+- ユーザーが IDE でインラインでレンダリングしたいチャートや数値結果を生成。
+
+`Bash` で `python script.py` を実行する方がよいスタンドアロンスクリプトや、新しいカーネルをまたいで永続化する必要があるコードには使用しないでください。
 
 ## パラメータ
 
-| パラメータ | 型 | 必須 | 説明 |
-|------------|------|------|------|
-| `code` | string | はい | 実行する Python コード |
+- `code` (string, required): 現在のカーネルで実行するコード。ノートブックセルに貼り付けられたように実行されます — 定義された変数はカーネルが再起動されるまで永続化されます。
+- `language` (string, optional): IDE ブリッジが複数のカーネルをサポートする場合のスニペットの言語。最もよく省略されます。アクティブカーネルの言語 (通常 Python) がデフォルトです。
+
+## 例
+
+### 例 1: インメモリデータフレームを検査
+
+```
+executeCode(
+  code="df.head()\nprint(df.shape)\nprint(df.dtypes)"
+)
+```
+
+カーネルにすでにロードされたデータフレームの最初の行、形状、列 dtype を返します。
 
-## 使用シナリオ
+### 例 2: 素早い数値チェック
 
-**適している場合：**
-- Jupyter notebook 環境でコードを実行
-- コードスニペットのテスト
-- データ分析と計算
+```
+executeCode(
+  code="import numpy as np\nnp.mean([1, 2, 3, 4, 5])"
+)
+```
 
-**適していない場合：**
-- 非 Jupyter 環境でのコード実行——Bash を使用すべき
-- ファイルの変更——Edit または Write を使用すべき
+ノートブックセルを作成せずにワンオフの計算を実行します。
 
 ## 注意事項
 
-- これは MCP（Model Context Protocol）ツールで、IDE 統合により提供
-- コードは現在の Jupyter kernel で実行され、状態は呼び出し間で永続化
-- ユーザーが明示的に要求しない限り、変数の宣言や kernel 状態の変更を避けるべき
-- kernel 再起動後は状態が失われる
-
-## 原文
-
-<textarea readonly>Execute python code in the Jupyter kernel for the current notebook file.
-    
-    All code will be executed in the current Jupyter kernel.
-    
-    Avoid declaring variables or modifying the state of the kernel unless the user
-    explicitly asks for it.
-    
-    Any code executed will persist across calls to this tool, unless the kernel
-    has been restarted.</textarea>
+- `executeCode` は IDE ブリッジツールです。Claude Code のプレーンなターミナルセッションでは利用できません。セッションがカーネルを公開する IDE (例えば VS Code Jupyter 拡張) に接続されている場合にのみ表示されます。
+- 状態はカーネルに永続化されます。1 つの `executeCode` 呼び出しで定義された変数は、後の呼び出し、ノートブックセル、ユーザーに引き続き見えます — 副作用に注意してください。
+- 長時間実行またはブロッキングコードはカーネルをブロックします。スニペットは短く保ってください。数分の作業には、実際のスクリプトを書いて `Bash` で実行してください。
+- 出力 (stdout、戻り値、画像) はセッションに返されます。非常に大きな出力は IDE ブリッジによって切り詰められる可能性があります。
+- ファイル編集には `Edit`、`Write`、または `NotebookEdit` を優先してください — `executeCode` はソースファイルを作成する代替ではありません。

package/concepts/ja/Tool-getDiagnostics.md

@@ -1,32 +1,44 @@
-# getDiagnostics (mcp__ide__getDiagnostics)
+# getDiagnostics
 
-## 定義
+接続された IDE から特定のファイルまたは IDE が現在開いているすべてのファイルについて言語サーバーの診断 (エラー、警告、ヒント) を取得します。タスクを完了と宣言する前に、コード変更がクリーンにコンパイルされることを確認するために使用します。
 
-VS Code から言語診断情報を取得します。構文エラー、型エラー、lint 警告などを含みます。
+## 使用タイミング
+
+- `Edit` または `Write` の後に、変更が型エラー、構文エラー、またはリント警告を導入しなかったことを確認。
+- タスクを終了する前に、すべての開いているファイルを一掃して未解決の問題を探す。
+- ユーザーが報告するエラーを診断するとき — IDE から正確なコンパイラまたは型チェッカーメッセージを取得することで推測を避ける。
+- 静的な正しさをチェックするだけでよい場合に、完全なビルドまたはテストコマンドを実行する軽量な代替。
+
+テストスイートの代替として `getDiagnostics` に頼らないでください。言語サーバーが見るものを報告し、テストまたは本番時に実行されるものではありません。
 
 ## パラメータ
 
-| パラメータ | 型 | 必須 | 説明 |
-|------------|------|------|------|
-| `uri` | string | いいえ | ファイル URI。指定しない場合はすべてのファイルの診断情報を取得 |
+- `uri` (string, optional): 診断を取得するファイル URI (通常 `file:///absolute/path`)。省略すると、IDE が現在開いているすべてのファイルの診断を返します。
 
-## 使用シナリオ
+## 例
 
-**適している場合：**
-- コードの構文、型、lint などのセマンティック問題をチェック
-- コード編集後に新しいエラーが導入されていないか検証
-- Bash コマンドの代わりにコード品質をチェック
+### 例 1: 編集後に単一ファイルをチェック
 
-**適していない場合：**
-- テストの実行——Bash を使用すべき
-- ランタイムエラーのチェック——Bash でコードを実行すべき
+```
+getDiagnostics(
+  uri="file:///Users/sky/project/src/auth.ts"
+)
+```
 
-## 注意事項
+`src/auth.ts` の TypeScript エラー、ESLint 警告、その他の言語サーバーメッセージを返します。
 
-- これは MCP（Model Context Protocol）ツールで、IDE 統合により提供
-- VS Code / IDE 環境でのみ利用可能
-- コード問題のチェックには Bash コマンドよりもこのツールを優先使用
+### 例 2: すべての開いているファイルを一掃
 
-## 原文
+```
+getDiagnostics()
+```
+
+現在開いているすべてのエディタの診断を返します。マルチファイルリファクタリングの終わりに、他の場所で何も後退していないことを確認するのに便利です。
+
+## 注意事項
 
-<textarea readonly>Get language diagnostics from VS Code</textarea>
+- `getDiagnostics` は IDE ブリッジツールです。Claude Code がサポートする IDE 統合 (例えば VS Code 拡張) に接続されている場合にのみ利用可能です。プレーンなターミナルセッションではツールは表示されません。
+- 結果は IDE がロードした言語サーバー — TypeScript、Pyright、ESLint、rust-analyzer など — が見るものを反映します。品質とカバレッジはユーザーの IDE セットアップに依存し、Claude Code には依存しません。
+- 診断はライブです。編集後、空の結果を成功と解釈する前に、言語サーバーに再解析の時間を与えてください — ファイルを保存したばかりなら再実行してください。
+- 重要度レベルには通常 `error`、`warning`、`information`、`hint` が含まれます。最初に `error` に焦点を当ててください。警告は意図的なプロジェクトスタイルかもしれません。
+- IDE に現在開いていないファイルの場合、ファイルに実際の問題が含まれていても、言語サーバーは診断を報告しないかもしれません。権威あるカバレッジのためには、ファイルを開くかビルドを実行してください。

package/concepts/ja/Tools.md

@@ -8,7 +8,7 @@ Claude Code は Anthropic API の tool_use メカニズムを通じてモデル
 
 | ツール | 用途 |
 |--------|------|
-| [Task](Tool-Task.md) | サブ agent（SubAgent）を起動して複雑なマルチステップタスクを処理 |
+| [Agent](Tool-Agent.md) | サブ agent（SubAgent）を起動して複雑なマルチステップタスクを処理 |
 | [TaskOutput](Tool-TaskOutput.md) | バックグラウンドタスクの出力を取得 |
 | [TaskStop](Tool-TaskStop.md) | 実行中のバックグラウンドタスクを停止 |
 | [TaskCreate](Tool-TaskCreate.md) | 構造化タスクリストエントリを作成 |

package/concepts/ko/SubAgent-Search.md

@@ -1,20 +1,52 @@
 # SubAgent: Search
 
-## 정의
+## 목적
 
-Search는 Claude Code의 메인 agent가 코드베이스 검색을 수행하기 위해 생성하는 서브 agent 유형입니다. Glob, Grep, Read와 같은 도구를 사용하여 파일 및 콘텐츠에 대한 대상 검색을 실행한 후 결과를 부모 agent에 반환합니다.
+Search 서브에이전트는 가벼운 읽기 전용 탐색 에이전트입니다. 코드베이스를 이해해야 할 때 — 무언가가 어디에 있는지 찾고, 컴포넌트가 어떻게 맞물리는지 배우고, 구조적 질문에 답해야 할 때 — 파일을 변경하지 않고 디스패치하십시오. 많은 파일에 걸친 많은 작은 읽기에 최적화되어 있으며, 원시 검색 출력이 아닌 간결한 요약을 반환합니다.
 
-## 동작
+Search는 범용 어시스턴트가 아닙니다. 코드를 편집하거나, 빌드를 실행하거나, 변경을 커밋하거나, 읽기 전용 가져오기를 넘어 네트워크 연결을 열 수 없습니다. 그 가치는 메인 에이전트의 컨텍스트를 소비하지 않고 병렬로 큰 탐색 예산을 소모한 다음 간결한 답변을 돌려줄 수 있다는 것입니다.
 
-- 메인 agent가 코드베이스를 검색하거나 탐색해야 할 때 자동으로 생성됨
-- 읽기 전용 접근 권한을 가진 격리된 컨텍스트에서 실행됨
-- 파일 패턴 매칭에는 Glob, 콘텐츠 검색에는 Grep, 파일 검사에는 Read를 사용함
-- 추가 처리를 위해 검색 결과를 부모 agent에 반환함
+## 사용 시점
 
-## 나타나는 시점
+- 세 가지 이상의 서로 다른 검색이나 읽기가 필요한 질문에 답해야 합니다. 예: "로그인 라우트에서 세션 저장소까지 인증이 어떻게 연결되어 있나요?"
+- 대상이 알 수 없음 — 어떤 파일, 모듈, 또는 심볼을 볼지 아직 모릅니다.
+- 변경하기 전에 저장소의 낯선 영역에 대한 구조적 개요가 필요합니다.
+- 여러 후보를 상호 참조해야 합니다 (예: 여러 유사하게 명명된 헬퍼 중 어떤 것이 실제로 프로덕션에서 호출되는지).
+- 문헌 스타일 요약이 필요합니다: "X를 가져오는 모든 곳을 나열하고 호출 사이트별로 분류하세요."
 
-Search 서브 agent는 일반적으로 다음과 같은 경우에 나타납니다:
+Search를 사용하지 말아야 할 때:
 
-1. 메인 agent가 특정 파일, 함수 또는 코드 패턴을 찾아야 할 때
-2. 사용자가 광범위한 코드베이스 탐색을 요청할 때
-3. agent가 의존성, 참조 또는 사용 패턴을 조사할 때
+- 정확한 파일과 줄을 이미 알고 있습니다. `Read`를 직접 호출하십시오.
+- 단일 `Grep`이나 `Glob`이 질문에 답할 것입니다. 직접 실행하십시오. 서브에이전트를 디스패치하면 오버헤드가 추가됩니다.
+- 작업에 편집, 명령 실행, 또는 어떤 부작용이든 필요합니다. Search는 설계상 읽기 전용입니다.
+- 도구 호출의 정확한 원문 출력이 필요합니다. 서브에이전트는 요약하며 원시 결과를 프록시하지 않습니다.
+
+## 철저함 수준
+
+질문의 중요성에 맞는 수준을 선택하십시오.
+
+- `quick` — 몇 가지 대상을 지정한 검색, 최선의 답변. 빠른 포인터가 필요하고 (예: "환경 변수 파싱 로직은 어디에 있나요?") 답변이 불완전하면 반복하는 것이 편안할 때 사용하십시오.
+- `medium` — 기본값. 여러 라운드의 검색, 후보 상호 확인, 가장 관련 있는 파일을 완전히 읽기. 일반적인 "이 영역을 이해하는 데 도움을 주세요" 질문에 사용하십시오.
+- `very thorough` — 철저한 탐색. 서브에이전트는 모든 그럴듯한 단서를 추적하고, 주변 컨텍스트를 읽고, 요약하기 전에 결과를 두 번 확인합니다. 정확성이 중요할 때 (예: 보안 검토, 마이그레이션 계획) 또는 불완전한 답변이 재작업을 초래할 때 사용하십시오.
+
+더 높은 철저함은 서브에이전트 내부에서 더 많은 시간과 토큰을 소비하지만, 그 토큰은 서브에이전트 내부에 머뭅니다 — 최종 요약만 메인 에이전트로 반환됩니다.
+
+## 사용 가능한 도구
+
+Search는 메인 에이전트가 사용하는 모든 읽기 전용 도구에 접근할 수 있으며, 그 외에는 없습니다:
+
+- `Read` — 부분 범위를 포함한 특정 파일 읽기.
+- `Grep` — 트리 전체의 콘텐츠 검색.
+- `Glob` — 이름 패턴으로 파일 찾기.
+- 읽기 전용 모드의 `Bash` — 변이 없이 상태를 검사하는 명령 (예: `git log`, `git show`, `ls`, `wc`).
+- `WebFetch`와 `WebSearch` — 해당 컨텍스트가 필요할 때 외부 문서 읽기.
+
+편집 도구 (`Write`, `Edit`, `NotebookEdit`), 상태를 수정하는 셸 명령, 작업 그래프 도구 (`TaskCreate`, `TaskUpdate` 등)는 의도적으로 사용할 수 없습니다.
+
+## 참고사항
+
+- Search 서브에이전트에게 주제가 아닌 특정 질문을 제공하십시오. "`renderMessage`의 모든 호출자를 나열하고 어떤 것이 커스텀 테마를 전달하는지 기록하세요"는 유용한 답변을 반환합니다. "렌더링에 대해 알려주세요"는 그렇지 않습니다.
+- 서브에이전트는 요약을 반환합니다. 정확한 파일 경로가 필요하면 프롬프트에서 명시적으로 요청하십시오.
+- 여러 독립 질문은 하나의 긴 프롬프트보다 병렬 Search 서브에이전트로 디스패치하는 것이 가장 좋으므로 각각이 집중할 수 있습니다.
+- Search는 편집할 수 없으므로 변경할 것을 알게 되면 메인 에이전트의 후속 편집 단계와 짝을 지으십시오.
+- Search 출력을 근거가 아닌 증거로 취급하십시오. 하중이 실리는 것에 대해서는 행동하기 전에 인용된 파일을 직접 여십시오.