cc-viewer 1.6.182 → 1.6.183

package/concepts/it/Tool-executeCode.md

@@ -1,41 +1,47 @@
-# executeCode (mcp__ide__executeCode)
+# executeCode
 
-## Definizione
+Esegue uno snippet di codice all'interno di un kernel live o sandbox fornito da un'integrazione IDE (ad esempio il kernel Jupyter legato al notebook attualmente aperto). Il tool è presente solo quando Claude Code è in esecuzione accanto a un bridge IDE compatibile come l'estensione VS Code con un kernel Jupyter selezionato.
 
-Esegue codice Python nel kernel Jupyter del file notebook corrente.
+## Quando usare
+
+- Eseguire un calcolo rapido, ispezione di dati o plot contro lo stato già caricato in un kernel Jupyter attivo.
+- Validare uno snippet di codice prima di incollarlo in una cella di notebook.
+- Esplorare un dataframe in memoria, una variabile o un modello che esiste nel kernel ma non è serializzato su disco.
+- Produrre un grafico o un risultato numerico che l'utente vuole reso inline nell'IDE.
+
+NON usare per script standalone che sarebbero meglio serviti da `Bash` che esegue `python script.py`, o per codice che deve persistere attraverso un kernel nuovo.
 
 ## Parametri
 
-| Parametro | Tipo | Obbligatorio | Descrizione |
-|------|------|------|------|
-| `code` | string | Sì | Codice Python da eseguire |
+- `code` (string, obbligatorio): Il codice da eseguire nel kernel corrente. Viene eseguito come se fosse incollato in una cella di notebook — le variabili definite persistono nel kernel fino al riavvio.
+- `language` (string, opzionale): Il linguaggio dello snippet quando il bridge IDE supporta più kernel. Più comunemente omesso; default: il linguaggio del kernel attivo (tipicamente Python).
+
+## Esempi
+
+### Esempio 1: Ispezionare un dataframe in memoria
+
+```
+executeCode(
+  code="df.head()\nprint(df.shape)\nprint(df.dtypes)"
+)
+```
+
+Restituisce le prime righe, la forma e i dtype delle colonne di un dataframe già caricato nel kernel.
 
-## Scenari d'uso
+### Esempio 2: Controllo numerico rapido
 
-**Adatto per:**
-- Eseguire codice in un ambiente Jupyter notebook
-- Testare frammenti di codice
-- Analisi dati e calcoli
+```
+executeCode(
+  code="import numpy as np\nnp.mean([1, 2, 3, 4, 5])"
+)
+```
 
-**Non adatto per:**
-- Esecuzione di codice in ambienti non Jupyter — usare Bash
-- Modificare file — usare Edit o Write
+Esegue un calcolo una tantum senza creare una cella di notebook.
 
 ## Note
 
-- Questo è uno strumento MCP (Model Context Protocol), fornito dall'integrazione IDE
-- Il codice viene eseguito nel kernel Jupyter corrente, lo stato persiste tra le chiamate
-- A meno che l'utente non lo richieda esplicitamente, evitare di dichiarare variabili o modificare lo stato del kernel
-- Lo stato viene perso dopo il riavvio del kernel
-
-## Testo originale
-
-<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` è un tool bridge IDE. Non è disponibile in sessioni terminal semplici di Claude Code; appare solo quando la sessione è connessa a un IDE che espone un kernel (ad esempio l'estensione VS Code Jupyter).
+- Lo stato persiste nel kernel. Le variabili definite da una chiamata `executeCode` restano visibili alle chiamate successive, alle celle di notebook e all'utente — fai attenzione agli effetti collaterali.
+- Codice a lunga esecuzione o bloccante bloccherà il kernel. Mantieni gli snippet brevi; per lavoro di diversi minuti, scrivi uno script vero e proprio ed eseguilo via `Bash`.
+- L'output (stdout, valori di ritorno, immagini) viene restituito alla sessione. Output molto grandi possono essere troncati dal bridge IDE.
+- Per modifiche ai file, preferisci `Edit`, `Write` o `NotebookEdit` — `executeCode` non è un sostituto per l'authoring dei file sorgente.

package/concepts/it/Tool-getDiagnostics.md

@@ -1,32 +1,44 @@
-# getDiagnostics (mcp__ide__getDiagnostics)
+# getDiagnostics
 
-## Definizione
+Recupera diagnostiche del language server (errori, avvisi, suggerimenti) dall'IDE connesso per un file specifico o per ogni file che l'IDE ha attualmente aperto. Usato per verificare che le modifiche al codice compilino pulitamente prima di dichiarare un compito completato.
 
-Ottiene informazioni diagnostiche del linguaggio da VS Code, inclusi errori di sintassi, errori di tipo, avvisi lint, ecc.
+## Quando usare
+
+- Dopo un `Edit` o `Write` per confermare che la modifica non abbia introdotto un errore di tipo, errore di sintassi o avviso di lint.
+- Prima di terminare un compito per esaminare ogni file aperto per problemi irrisolti.
+- Quando si diagnostica un errore che l'utente riporta — estrarre il messaggio esatto del compilatore o type-checker dall'IDE evita di indovinare.
+- Come alternativa leggera all'esecuzione di una build o test suite completa quando hai solo bisogno di controllare la correttezza statica.
+
+NON fare affidamento su `getDiagnostics` come sostituto della suite di test. Riporta ciò che il language server vede, non ciò che viene eseguito in test o produzione.
 
 ## Parametri
 
-| Parametro | Tipo | Obbligatorio | Descrizione |
-|------|------|------|------|
-| `uri` | string | No | URI del file. Se non fornito, ottiene le informazioni diagnostiche di tutti i file |
+- `uri` (string, opzionale): L'URI del file (tipicamente `file:///absolute/path`) per cui recuperare le diagnostiche. Quando omesso, il tool restituisce diagnostiche per ogni file che l'IDE ha attualmente aperto.
 
-## Scenari d'uso
+## Esempi
 
-**Adatto per:**
-- Controllare problemi semantici del codice come sintassi, tipi, lint
-- Verificare se sono stati introdotti nuovi errori dopo la modifica del codice
-- Sostituire i comandi Bash per controllare la qualità del codice
+### Esempio 1: Controllare un singolo file dopo l'editing
 
-**Non adatto per:**
-- Eseguire test — usare Bash
-- Controllare errori a runtime — usare Bash per eseguire il codice
+```
+getDiagnostics(
+  uri="file:///Users/sky/project/src/auth.ts"
+)
+```
 
-## Note
+Restituisce qualsiasi errore TypeScript, avviso ESLint o altro messaggio del language server per `src/auth.ts`.
 
-- Questo è uno strumento MCP (Model Context Protocol), fornito dall'integrazione IDE
-- Disponibile solo in ambienti VS Code / IDE
-- Preferire questo strumento rispetto ai comandi Bash per controllare i problemi del codice
+### Esempio 2: Esaminare tutti i file aperti
 
-## Testo originale
+```
+getDiagnostics()
+```
+
+Restituisce diagnostiche attraverso ogni editor attualmente aperto. Utile alla fine di un refactor multi-file per assicurarsi che nulla abbia fatto regressione altrove.
+
+## Note
 
-<textarea readonly>Get language diagnostics from VS Code</textarea>
+- `getDiagnostics` è un tool bridge IDE. È disponibile solo quando Claude Code è connesso a un'integrazione IDE supportata (ad esempio l'estensione VS Code). In una sessione terminal semplice il tool non apparirà.
+- I risultati riflettono qualunque language server l'IDE abbia caricato — TypeScript, Pyright, ESLint, rust-analyzer, ecc. Qualità e copertura dipendono dalla configurazione IDE dell'utente, non da Claude Code.
+- Le diagnostiche sono live. Dopo una modifica, dai al language server un momento per rianalizzare prima di interpretare un risultato vuoto come successo — ri-esegui se il file è appena stato salvato.
+- I livelli di severità includono tipicamente `error`, `warning`, `information` e `hint`. Concentrati prima su `error`; gli avvisi possono essere stile di progetto intenzionale.
+- Per file non attualmente aperti nell'IDE, il language server potrebbe non avere diagnostiche da riportare anche se il file contiene problemi reali. Apri il file o esegui la build per copertura autoritativa.

package/concepts/it/Tools.md

@@ -8,7 +8,7 @@ Di seguito l'indice categorizzato di tutti gli strumenti.
 
 | Strumento | Scopo |
 |------|------|
-| [Task](Tool-Task.md) | Avvia un sub agent (SubAgent) per gestire task complessi multi-step |
+| [Agent](Tool-Agent.md) | Avvia un sub agent (SubAgent) per gestire task complessi multi-step |
 | [TaskOutput](Tool-TaskOutput.md) | Ottieni l'output di un task in background |
 | [TaskStop](Tool-TaskStop.md) | Ferma un task in background in esecuzione |
 | [TaskCreate](Tool-TaskCreate.md) | Crea una voce nella lista dei task strutturata |

package/concepts/ja/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 に返す
+## 使用タイミング
 
-## 表示されるタイミング
+- 3 つ以上の異なる検索や読み取りを必要とする質問に答える必要がある場合。例: 「ログインルートからセッションストアまで、認証はどのように配線されているか？」
+- ターゲットが不明 — どのファイル、モジュール、シンボルを見るべきかまだ分からない場合。
+- 変更を行う前に、リポジトリの見慣れない領域の構造的概要が必要な場合。
+- 複数の候補を相互参照する必要がある場合 (例えば、いくつかの類似した名前のヘルパーのうち、どれが実際に本番で呼び出されているか)。
+- 文献スタイルのサマリが必要な場合: 「X をインポートしているすべての場所をリストし、呼び出しサイトごとにカテゴリ化する。」
 
-Search サブ agent は通常、次のような場合に表示されます:
+Search を使用しない場合:
 
-1. メイン agent が特定のファイル、関数、またはコードパターンを見つける必要があるとき
-2. ユーザーが広範なコードベース探索を要求したとき
-3. agent が依存関係、参照、または使用パターンを調査しているとき
+- すでに正確なファイルと行が分かっている場合。直接 `Read` を呼び出してください。
+- 1 つの `Grep` または `Glob` で質問に答えられる場合。直接実行してください。サブエージェントを派遣するとオーバーヘッドが増えます。
+- タスクが編集、コマンド実行、または任意の副作用を必要とする場合。Search は設計上読み取り専用です。
+- ツール呼び出しの正確な逐語的出力が必要な場合。サブエージェントは要約します。生の結果をプロキシしません。
+
+## 徹底度レベル
+
+質問の重要度に合ったレベルを選んでください。
+
+- `quick` — いくつかのターゲットを絞った検索、ベストエフォートの回答。素早いポインタが必要で (例えば「env 変数のパースロジックはどこにあるか？」)、回答が不完全であれば繰り返すことに抵抗がない場合に使用します。
+- `medium` — デフォルト。数ラウンドの検索、候補のクロスチェック、最も関連性の高いファイルを完全に読み込みます。典型的な「この領域を理解させて」の質問に使用します。
+- `very thorough` — 網羅的な探索。サブエージェントは、もっともらしいすべてのリードを追跡し、周囲のコンテキストを読み、要約する前に結果をダブルチェックします。正確性が重要な場合 (例えばセキュリティレビュー、マイグレーション計画) や、不完全な回答が再作業を引き起こす場合に使用します。
+
+より高い徹底度はサブエージェント内でより多くの時間とトークンを消費しますが、それらのトークンはサブエージェント内にとどまります — メインエージェントには最終サマリのみが返されます。
+
+## 利用可能なツール
+
+Search はメインエージェントが使用するすべての読み取り専用ツールにアクセスでき、それ以外はありません。
+
+- `Read` — 部分的な範囲を含む特定のファイルの読み取り用。
+- `Grep` — ツリー全体のコンテンツ検索用。
+- `Glob` — 名前パターンによるファイル特定用。
+- 読み取り専用モードの `Bash` — 変更なしに状態を検査するコマンド用 (例えば `git log`、`git show`、`ls`、`wc`)。
+- `WebFetch` と `WebSearch` — そのコンテキストが必要な場合の外部ドキュメント読み取り用。
+
+編集ツール (`Write`、`Edit`、`NotebookEdit`)、状態を変更するシェルコマンド、タスクグラフツール (`TaskCreate`、`TaskUpdate` など) は意図的に利用不可になっています。
+
+## 注意事項
+
+- Search サブエージェントにはトピックではなく具体的な質問を与えてください。「`renderMessage` のすべての呼び出し元をリストし、どれがカスタムテーマを渡すかを記録する」は有用な回答を返します。「レンダリングについて教えて」は返しません。
+- サブエージェントはサマリを返します。正確なファイルパスが必要なら、プロンプトで明示的に求めてください。
+- 複数の独立した質問は、1 つの長いプロンプトではなく、並列 Search サブエージェントとして派遣するのが最適です。それぞれが集中できます。
+- Search は編集できないため、何を変更すべきかが分かったら、メインエージェントで後続の編集ステップと組み合わせてください。
+- Search の出力は証拠として扱い、真実とはしないでください。重要なものについては、行動する前に引用されたファイルを自分で開いてください。

package/concepts/ja/Tool-Agent.md

@@ -1,125 +1,60 @@
 # Agent
 
-## 定義
+独自のコンテキストウィンドウを持つ自律的な Claude Code サブエージェントを起動し、焦点を絞ったタスクを処理して単一の統合された結果を返します。オープンエンドな調査、並列作業、チーム協業を委譲するための標準的な仕組みです。
 
-サブ agent（SubAgent）を起動して、複雑なマルチステップタスクを自律的に処理します。サブ agent は独立したサブプロセスで、それぞれ専用のツールセットとコンテキストを持ちます。Agent は新しい Claude Code バージョンにおける Task ツールのリネーム版です。
+## 使用タイミング
 
-## パラメータ
-
-| パラメータ | 型 | 必須 | 説明 |
-|------------|------|------|------|
-| `prompt` | string | はい | サブ agent が実行するタスクの説明 |
-| `description` | string | はい | 3〜5語の短い要約 |
-| `subagent_type` | string | はい | サブ agent タイプ、利用可能なツールセットを決定 |
-| `model` | enum | いいえ | モデルを指定（sonnet / opus / haiku）、デフォルトは親から継承 |
-| `max_turns` | integer | いいえ | 最大 agentic ターン数 |
-| `run_in_background` | boolean | いいえ | バックグラウンドで実行するかどうか。バックグラウンドタスクは output_file パスを返す |
-| `resume` | string | いいえ | 再開する agent ID、前回の実行から続行。コンテキストを失わずに以前のサブ agent を引き継ぐのに有用 |
-| `isolation` | enum | いいえ | 隔離モード、`worktree` で一時的な git worktree を作成 |
-
-## サブ agent タイプ
-
-| タイプ | 用途 | 利用可能なツール |
-|--------|------|------------------|
-| `Bash` | コマンド実行、git 操作 | Bash |
-| `general-purpose` | 汎用マルチステップタスク | 全ツール |
-| `Explore` | コードベースの高速探索 | Agent/Edit/Write/NotebookEdit/ExitPlanMode 以外のすべて |
-| `Plan` | 実装方針の設計 | Agent/Edit/Write/NotebookEdit/ExitPlanMode 以外のすべて |
-| `claude-code-guide` | Claude Code 使用ガイド Q&A | Glob, Grep, Read, WebFetch, WebSearch |
-| `statusline-setup` | ステータスバーの設定 | Read, Edit |
-
-## 使用シナリオ
-
-**適している場合：**
-- マルチステップで自律的に完了する必要がある複雑なタスク
-- コードベースの探索と深い調査（Explore タイプを使用）
-- 隔離環境が必要な並列作業
-- バックグラウンドで実行する必要がある長時間タスク
+- 関連するファイルがまだ分からず、`Glob`、`Grep`、`Read` を複数回繰り返すことが予想されるオープンエンドな検索。
+- 並列の独立した作業 — 単一のメッセージで複数のエージェントを起動して、別々の領域を同時に調査します。
+- ノイズの多い探索をメインの会話から分離し、親コンテキストをコンパクトに保ちます。
+- `Explore`、`Plan`、`claude-code-guide`、`statusline-setup` などの特化したサブエージェントタイプに委譲します。
+- 協調的なマルチエージェント作業のため、アクティブなチームに名前付きのチームメイトを起動します。
 
-**適していない場合：**
-- 特定のファイルパスの読み取り——直接 Read または Glob を使用
-- 2〜3個の既知ファイル内の検索——直接 Read を使用
-- 特定のクラス定義の検索——直接 Glob を使用
+対象となるファイルやシンボルがすでに分かっている場合には使用しないでください — 代わりに `Read`、`Grep`、`Glob` を直接使用してください。`Agent` を介した単一ステップの参照はコンテキストウィンドウを丸ごと浪費し、レイテンシを追加します。
 
-## 注意事項
-
-- サブ agent は完了後に単一メッセージを返し、その結果はユーザーには見えないため、メイン agent が伝達する必要がある
-- 単一メッセージ内で複数の並列 Agent 呼び出しを発行して効率を向上できる
-- バックグラウンドタスクは TaskOutput ツールで進捗を確認
-- Explore タイプは直接 Glob/Grep を呼び出すより遅いため、単純な検索では不十分な場合にのみ使用
-- 長時間実行で即座に結果が不要なタスクには `run_in_background: true` を推奨。結果が必要な場合はフォアグラウンド（デフォルト）を使用
-- `resume` パラメータにより、以前開始したサブ agent セッションを継続でき、蓄積されたコンテキストを保持
-
-## 原文
+## パラメータ
 
-<textarea readonly>Launch a new agent to handle complex, multi-step tasks autonomously.
+- `description` (string, required): タスクを説明する 3〜5 語の短いラベル。UI とログに表示されます。
+- `prompt` (string, required): エージェントが実行する完全で自己完結したブリーフ。必要なコンテキスト、制約、期待される返却フォーマットをすべて含めなければなりません。
+- `subagent_type` (string, optional): `general-purpose`、`Explore`、`Plan`、`claude-code-guide`、`statusline-setup` などのプリセットペルソナ。デフォルトは `general-purpose`。
+- `run_in_background` (boolean, optional): true の場合、エージェントは非同期で実行され、親は作業を継続できます。結果は後で取得します。
+- `model` (string, optional): このエージェントのモデルを上書きします — `opus`、`sonnet`、`haiku`。デフォルトは親セッションのモデルです。
+- `isolation` (string, optional): `worktree` に設定すると、エージェントを分離された git worktree 内で実行し、ファイルシステムへの書き込みが親と衝突しないようにします。
+- `team_name` (string, optional): 既存のチームに起動する場合、エージェントが参加するチーム識別子。
+- `name` (string, optional): チーム内でアドレス指定可能なチームメイト名。`SendMessage` の `to` ターゲットとして使用されます。
 
-The Agent tool launches specialized agents (subprocesses) that autonomously handle complex tasks. Each agent type has specific capabilities and tools available to it.
+## 例
 
-Available agent types and the tools they have access to:
-- general-purpose: General-purpose agent for researching complex questions, searching for code, and executing multi-step tasks. When you are searching for a keyword or file and are not confident that you will find the right match in the first few tries use this agent to perform the search for you. (Tools: *)
-- statusline-setup: Use this agent to configure the user's Claude Code status line setting. (Tools: Read, Edit)
-- Explore: Fast agent specialized for exploring codebases. Use this when you need to quickly find files by patterns (eg. "src/components/**/*.tsx"), search code for keywords (eg. "API endpoints"), or answer questions about the codebase (eg. "how do API endpoints work?"). When calling this agent, specify the desired thoroughness level: "quick" for basic searches, "medium" for moderate exploration, or "very thorough" for comprehensive analysis across multiple locations and naming conventions. (Tools: All tools except Agent, ExitPlanMode, Edit, Write, NotebookEdit)
-- Plan: Software architect agent for designing implementation plans. Use this when you need to plan the implementation strategy for a task. Returns step-by-step plans, identifies critical files, and considers architectural trade-offs. (Tools: All tools except Agent, ExitPlanMode, Edit, Write, NotebookEdit)
-- claude-code-guide: Use this agent when the user asks questions ("Can Claude...", "Does Claude...", "How do I...") about: (1) Claude Code (the CLI tool) - features, hooks, slash commands, MCP servers, settings, IDE integrations, keyboard shortcuts; (2) Claude Agent SDK - building custom agents; (3) Claude API (formerly Anthropic API) - API usage, tool use, Anthropic SDK usage. **IMPORTANT:** Before spawning a new agent, check if there is already a running or recently completed claude-code-guide agent that you can resume using the "resume" parameter. (Tools: Glob, Grep, Read, WebFetch, WebSearch)
+### 例 1: オープンエンドなコード検索
 
-When using the Agent tool, you must specify a subagent_type parameter to select which agent type to use.
+```
+Agent(
+  description="Find auth middleware",
+  subagent_type="Explore",
+  prompt="Locate every place in this repo where JWT verification is performed. Return a bulleted list of absolute file paths with a one-line note about each site's role. Do not modify any files."
+)
+```
 
-When NOT to use the Agent tool:
-- If you want to read a specific file path, use the Read or Glob tool instead of the Agent tool, to find the match more quickly
-- If you are searching for a specific class definition like "class Foo", use the Glob tool instead, to find the match more quickly
-- If you are searching for code within a specific file or set of 2-3 files, use the Read tool instead of the Agent tool, to find the match more quickly
-- Other tasks that are not related to the agent descriptions above
+### 例 2: 並列の独立した調査
 
-Usage notes:
-- Always include a short description (3-5 words) summarizing what the agent will do
-- Launch multiple agents concurrently whenever possible, to maximize performance; to do that, use a single message with multiple tool uses
-- When the agent is done, it will return a single message back to you. The result returned by the agent is not visible to the user. To show the user the result, you should send a text message back to the user with a concise summary of the result.
-- You can optionally run agents in the background using the run_in_background parameter. When an agent runs in the background, you will be automatically notified when it completes — do NOT sleep, poll, or proactively check on its progress. Continue with other work or respond to the user instead.
-- **Foreground vs background**: Use foreground (default) when you need the agent's results before you can proceed — e.g., research agents whose findings inform your next steps. Use background when you have genuinely independent work to do in parallel.
-- Agents can be resumed using the `resume` parameter by passing the agent ID from a previous invocation. When resumed, the agent continues with its full previous context preserved. When NOT resuming, each invocation starts fresh and you should provide a detailed task description with all necessary context.
-- When the agent is done, it will return a single message back to you along with its agent ID. You can use this ID to resume the agent later if needed for follow-up work.
-- Provide clear, detailed prompts so the agent can work autonomously and return exactly the information you need.
-- Agents with "access to current context" can see the full conversation history before the tool call. When using these agents, you can write concise prompts that reference earlier context (e.g., "investigate the error discussed above") instead of repeating information. The agent will receive all prior messages and understand the context.
-- The agent's outputs should generally be trusted
-- Clearly tell the agent whether you expect it to write code or just to do research (search, file reads, web fetches, etc.), since it is not aware of the user's intent
-- If the agent description mentions that it should be used proactively, then you should try your best to use it without the user having to ask for it first. Use your judgement.
-- If the user specifies that they want you to run agents "in parallel", you MUST send a single message with multiple Agent tool use content blocks. For example, if you need to launch both a build-validator agent and a test-runner agent in parallel, send a single message with both tool calls.
-- You can optionally set `isolation: "worktree"` to run the agent in a temporary git worktree, giving it an isolated copy of the repository. The worktree is automatically cleaned up if the agent makes no changes; if changes are made, the worktree path and branch are returned in the result.
+同じメッセージで 2 つのエージェントを起動します — 1 つはビルドパイプラインを調査し、もう 1 つはテストハーネスをレビューします。それぞれが独自のコンテキストウィンドウを取得し、サマリを返します。単一のツール呼び出しブロックにまとめることで並列実行されます。
 
-Example usage:
+### 例 3: 実行中のチームにチームメイトを起動
 
-<example_agent_descriptions>
-"test-runner": use this agent after you are done writing code to run tests
-"greeting-responder": use this agent to respond to user greetings with a friendly joke
-</example_agent_descriptions>
+```
+Agent(
+  description="Data layer specialist",
+  team_name="refactor-crew",
+  name="db-lead",
+  prompt="You are db-lead on team refactor-crew. Audit all Prisma schema files and propose a migration plan. Use SendMessage to report findings to the team leader."
+)
+```
 
-<example>
-user: "Please write a function that checks if a number is prime"
-assistant: Sure let me write a function that checks if a number is prime
-assistant: First let me use the Write tool to write a function that checks if a number is prime
-assistant: I'm going to use the Write tool to write the following code:
-<code>
-function isPrime(n) {
-  if (n <= 1) return false
-  for (let i = 2; i * i <= n; i++) {
-    if (n % i === 0) return false
-  }
-  return true
-}
-</code>
-<commentary>
-Since a significant piece of code was written and the task was completed, now use the test-runner agent to run the tests
-</commentary>
-assistant: Now let me use the test-runner agent to run the tests
-assistant: Uses the Agent tool to launch the test-runner agent
-</example>
+## 注意事項
 
-<example>
-user: "Hello"
-<commentary>
-Since the user is greeting, use the greeting-responder agent to respond with a friendly joke
-</commentary>
-assistant: "I'm going to use the Agent tool to launch the greeting-responder agent"
-</example>
-</textarea>
+- エージェントは過去の実行を記憶しません。呼び出すたびにゼロから始まるので、`prompt` は完全に自己完結している必要があります — ファイルパス、規約、質問、期待される回答の形式を含めてください。
+- エージェントは最終メッセージを 1 つだけ返します。実行中に確認の質問をすることはできないため、プロンプトの曖昧さは結果の推測につながります。
+- サブタスクが独立している場合、並列で複数のエージェントを実行するのは逐次呼び出しよりもはるかに高速です。単一のツール呼び出しブロックにまとめてください。
+- エージェントがファイルを書き込み、メインの作業ツリーにマージする前に変更をレビューしたい場合は、常に `isolation: "worktree"` を使用してください。
+- 読み取り専用の偵察には `subagent_type: "Explore"` を、設計作業には `Plan` を優先してください。`general-purpose` は読み書き混在タスクのデフォルトです。
+- バックグラウンドエージェント (`run_in_background: true`) は長時間実行ジョブに適しています。sleep ループでのポーリングは避けてください — 完了時に親に通知されます。

package/concepts/ja/Tool-AskUserQuestion.md

@@ -1,75 +1,60 @@
 # AskUserQuestion
 
-## 定義
+チャット UI 内で 1 つ以上の構造化された選択式の質問をユーザーに提示し、選択を収集してアシスタントに返します — 自由記述のやり取りなしに意図を明確化するのに便利です。
 
-実行中にユーザーに質問し、確認の取得、仮説の検証、または判断の要求に使用します。
+## 使用タイミング
 
-## パラメータ
-
-| パラメータ | 型 | 必須 | 説明 |
-|------------|------|------|------|
-| `questions` | array | はい | 質問リスト（1〜4個の質問） |
-| `answers` | object | いいえ | ユーザーから収集した回答 |
-| `annotations` | object | いいえ | 各質問の注釈（プレビュー選択の備考など） |
-| `metadata` | object | いいえ | トラッキングと分析用のメタデータ |
-
-各 `question` オブジェクト：
-
-| フィールド | 型 | 必須 | 説明 |
-|------------|------|------|------|
-| `question` | string | はい | 完全な質問テキスト。疑問符で終わること |
-| `header` | string | はい | 短いラベル（最大12文字）、ラベルチップとして表示 |
-| `options` | array | はい | 2〜4個の選択肢 |
-| `multiSelect` | boolean | はい | 複数選択を許可するかどうか |
-
-各 `option` オブジェクト：
-
-| フィールド | 型 | 必須 | 説明 |
-|------------|------|------|------|
-| `label` | string | はい | 選択肢の表示テキスト（1〜5語） |
-| `description` | string | はい | 選択肢の説明 |
-| `markdown` | string | いいえ | プレビューコンテンツ（ASCII レイアウト、コードスニペットなどの視覚的比較用） |
-
-## 使用シナリオ
+- リクエストに複数の妥当な解釈があり、進める前にユーザーに 1 つ選んでもらう必要がある場合。
+- 自由テキストの返信だとエラーになりやすい具体的な選択肢 (フレームワーク、ライブラリ、ファイルパス、戦略) から選ぶ必要がある場合。
+- プレビューペインを使用して選択肢を並べて比較したい場合。
+- やり取りを減らすため、複数の関連する決定を 1 つのプロンプトにまとめたい場合。
+- プランやツール呼び出しが、ユーザーがまだ指定していない設定に依存している場合。
 
-**適している場合：**
-- ユーザーの好みや要件を収集
-- 曖昧な指示を明確化
-- 実装中に判断を取得
-- ユーザーに方向性の選択を提供
+## パラメータ
 
-**適していない場合：**
-- 「方針でよろしいですか？」と聞く場合——ExitPlanMode を使用すべき
+- `questions` (array, required): 1 つのプロンプトで一緒に表示される 1〜4 個の質問。各質問オブジェクトには以下が含まれます。
+  - `question` (string, required): 疑問符で終わる完全な質問テキスト。
+  - `header` (string, required): 質問の上にチップとして表示される短いラベル (最大 12 文字)。
+  - `options` (array, required): 2〜4 個の選択肢オブジェクト。各選択肢には `label` (1〜5 語)、`description`、オプションの `markdown` プレビューがあります。
+  - `multiSelect` (boolean, required): `true` の場合、ユーザーは複数の選択肢を選べます。
+
+## 例
+
+### 例 1: 単一フレームワークの選択
+
+```
+AskUserQuestion(questions=[{
+  "header": "Test runner",
+  "question": "Which test runner should I configure?",
+  "multiSelect": false,
+  "options": [
+    {"label": "Vitest (Recommended)", "description": "Fast, Vite-native, Jest-compatible API"},
+    {"label": "Jest",                  "description": "Mature, broadest plugin ecosystem"},
+    {"label": "Node --test",           "description": "Zero dependencies, built in"}
+  ]
+}])
+```
+
+### 例 2: 2 つのレイアウトを並べてプレビュー
+
+```
+AskUserQuestion(questions=[{
+  "header": "Layout",
+  "question": "Which dashboard layout do you prefer?",
+  "multiSelect": false,
+  "options": [
+    {"label": "Sidebar",  "description": "Nav on the left", "markdown": "```\n+------+---------+\n| NAV  | CONTENT |\n+------+---------+\n```"},
+    {"label": "Top bar",  "description": "Nav across top",  "markdown": "```\n+-----------------+\n|       NAV       |\n+-----------------+\n|     CONTENT     |\n+-----------------+\n```"}
+  ]
+}])
+```
 
 ## 注意事項
 
-- ユーザーは常に "Other" を選択してカスタム入力を提供できる
-- 推奨選択肢は最初に配置し、label の末尾に "(Recommended)" を追加
-- `markdown` プレビューは単一選択の質問のみ対応
-- `markdown` がある選択肢は左右並列レイアウトに切り替わる
-- 計画モードでは、方針確定前の要件明確化に使用
-
-## 原文
-
-<textarea readonly>Use this tool when you need to ask the user questions during execution. This allows you to:
-1. Gather user preferences or requirements
-2. Clarify ambiguous instructions
-3. Get decisions on implementation choices as you work
-4. Offer choices to the user about what direction to take.
-
-Usage notes:
-- Users will always be able to select "Other" to provide custom text input
-- Use multiSelect: true to allow multiple answers to be selected for a question
-- If you recommend a specific option, make that the first option in the list and add "(Recommended)" at the end of the label
-
-Plan mode note: In plan mode, use this tool to clarify requirements or choose between approaches BEFORE finalizing your plan. Do NOT use this tool to ask "Is my plan ready?" or "Should I proceed?" - use ExitPlanMode for plan approval. IMPORTANT: Do not reference "the plan" in your questions (e.g., "Do you have feedback about the plan?", "Does the plan look good?") because the user cannot see the plan in the UI until you call ExitPlanMode. If you need plan approval, use ExitPlanMode instead.
-
-Preview feature:
-Use the optional `markdown` field on options when presenting concrete artifacts that users need to visually compare:
-- ASCII mockups of UI layouts or components
-- Code snippets showing different implementations
-- Diagram variations
-- Configuration examples
-
-When any option has a markdown, the UI switches to a side-by-side layout with a vertical option list on the left and preview on the right. Do not use previews for simple preference questions where labels and descriptions suffice. Note: previews are only supported for single-select questions (not multiSelect).
-</textarea>
+- UI は各質問に自動的に「Other」自由記述オプションを追加します。独自の「Other」、「None」、「Custom」エントリを追加しないでください — 組み込みのエスケープハッチと重複します。
+- 各呼び出しは 1〜4 個の質問、各質問は 2〜4 個の選択肢に制限してください。この範囲を超えるとハーネスによって拒否されます。
+- 特定の選択肢を推奨する場合は、それを先頭に置き、ラベルに「(Recommended)」を付けて UI が優先パスを強調表示するようにしてください。
+- `markdown` フィールドによるプレビューは単一選択の質問でのみサポートされます。ASCII レイアウト、コードスニペット、設定差分などの視覚的なアーティファクトに使用してください — ラベルと説明で十分な単純な好みの質問には使用しないでください。
+- 質問のいずれかの選択肢に `markdown` 値がある場合、UI は選択肢リストを左、プレビューを右に表示する並列レイアウトに切り替わります。
+- 「このプランはどうですか？」と尋ねるのに `AskUserQuestion` を使用しないでください — プラン承認のために存在する `ExitPlanMode` を呼び出してください。プランモード中は、質問テキストで「the plan」に言及することも避けてください。`ExitPlanMode` が実行されるまでプランはユーザーに見えません。
+- API キーやパスワードなどの機密情報や自由記述の入力を要求するためにこのツールを使用しないでください。代わりにチャットで質問してください。