cc-viewer 1.6.182 → 1.6.183

package/concepts/uk/Tool-WebSearch.md

@@ -1,58 +1,51 @@
 # WebSearch
 
-## Визначення
+Виконує живий веб-пошук і повертає ранжовані результати, які асистент використовує, щоб обґрунтувати свою відповідь у поточній інформації поза межею навчання моделі.
 
-Виконує запит до пошукової системи та повертає результати пошуку для отримання актуальної інформації.
+## Коли використовувати
+
+- Відповіді на запитання про поточні події, нещодавні релізи чи термінові новини.
+- Пошук останньої версії бібліотеки, фреймворка чи CLI-інструмента.
+- Знаходження документації чи блог-постів, коли точний URL невідомий.
+- Перевірка факту, який міг змінитися з моменту навчання моделі.
+- Виявлення кількох перспектив на тему перед отриманням будь-якої окремої сторінки через `WebFetch`.
 
 ## Параметри
 
-| Параметр | Тип | Обов'язковий | Опис |
-|----------|-----|--------------|------|
-| `query` | string | Так | Пошуковий запит (мінімум 2 символи) |
-| `allowed_domains` | string[] | Ні | Включати результати лише з цих доменів |
-| `blocked_domains` | string[] | Ні | Виключити результати з цих доменів |
+- `query` (string, обовʼязковий): Пошуковий запит. Мінімальна довжина 2 символи. Включайте поточний рік, коли запитуєте про "latest" чи "recent" інформацію, щоб результати були свіжими.
+- `allowed_domains` (array of strings, необовʼязковий): Обмежує результати лише цими доменами, наприклад `["nodejs.org", "developer.mozilla.org"]`. Корисно, коли ви довіряєте конкретному джерелу.
+- `blocked_domains` (array of strings, необовʼязковий): Виключає результати з цих доменів. Не передавайте той самий домен у `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:` в кінці вашої відповіді, перелічуючи кожен цитований результат як Markdown-гіперпосилання у формі `[Title](URL)`. Це жорстка вимога, а не опціональна.
+- `WebSearch` доступний лише користувачам у Сполучених Штатах. Якщо інструмент недоступний у вашому регіоні, поверніться до `WebFetch` на відомий URL або попросіть користувача вставити релевантний вміст.
+- Кожен виклик виконує пошук за один круговий рейс — ви не можете стримити чи розбивати на сторінки. Уточніть запит, якщо перший набір результатів невдалий.
+- Інструмент повертає фрагменти й метадані, а не повний вміст сторінок. Щоб детально прочитати конкретний результат, продовжіть `WebFetch`, використовуючи повернутий URL.
+- Використовуйте `allowed_domains` для примусового авторитетного джерельного добору для чутливих до безпеки запитань, таких як CVE чи відповідність, і `blocked_domains`, щоб відсікти SEO-ферми, що дзеркалять документацію.
+- Тримайте запити короткими й орієнтованими на ключові слова. Природномовні запитання працюють, але схильні повертати розмовні відповіді, а не первинні джерела.
+- Не вигадуйте URL на основі пошукової інтуїції — завжди виконуйте пошук і цитуйте те, що інструмент насправді повернув.

package/concepts/uk/Tool-Write.md

@@ -1,39 +1,35 @@
 # Write
 
-## Визначення
+Створює новий файл або повністю замінює вміст наявного в локальній файловій системі. Оскільки він замінює все за цільовим шляхом, його слід резервувати для справжнього створення чи навмисних повних переписів.
 
-Записує вміст у локальну файлову систему. Якщо файл вже існує, перезаписує його.
+## Коли використовувати
 
-## Параметри
+- Створення нового файлу вихідного коду, тесту чи конфігурації, якого ще не існує
+- Генерація свіжої фікстури, снапшота чи файлу даних з нуля
+- Виконання повного перепису, де інкрементальний `Edit` був би складнішим, ніж починати з нуля
+- Видача запитаного артефакту, такого як схема, міграція чи скрипт збірки, який користувач явно попросив вас створити
 
-| Параметр | Тип | Обов'язковий | Опис |
-|----------|-----|--------------|------|
-| `file_path` | string | Так | Абсолютний шлях до файлу (повинен бути абсолютним) |
-| `content` | string | Так | Вміст для запису |
+## Параметри
 
-## Сценарії використання
+- `file_path` (string, обовʼязковий): Абсолютний шлях до файлу для запису. Будь-які батьківські каталоги повинні вже існувати.
+- `content` (string, обовʼязковий): Повний текст для запису у файл. Це стає всім тілом файлу.
 
-**Підходить для:**
-- Створення нових файлів
-- Коли потрібно повністю переписати вміст файлу
+## Приклади
 
-**Не підходить для:**
-- Зміна локальної частини файлу — слід використовувати Edit
-- Не слід проактивно створювати файли документації (*.md) або README, якщо користувач явно не просить
+### Приклад 1: Створення нового модуля-помічника
+Викличте `Write` з `file_path: "/Users/me/app/src/utils/slugify.ts"` і надайте реалізацію як `content`. Використовуйте це лише після перевірки, що файл ще не існує.
 
-## Примітки
+### Приклад 2: Регенерація похідного артефакту
+Після зміни джерела схеми перепишіть `/Users/me/app/generated/schema.json` одним викликом `Write`, використовуючи свіжозгенерований JSON як `content`.
 
-- Якщо цільовий файл вже існує, його потрібно спочатку прочитати через 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` надсилає лише diff, що швидше, безпечніше й легше переглядати.
+- Не створюйте проактивно Markdown-документацію, `README.md` чи файли журналу змін, якщо користувач явно не просить про них.
+- Не додавайте емодзі, маркетингові тексти чи декоративні банери, якщо користувач не запитує такий стиль.
+- Спочатку перевірте, що батьківський каталог існує, викликом `Bash` `ls`; `Write` не створює проміжних папок.
+- Надавайте вміст точно таким, яким ви хочете, щоб він зберігся; немає шаблонізації чи постобробки.

package/concepts/uk/Tool-executeCode.md

@@ -1,41 +1,47 @@
-# executeCode (mcp__ide__executeCode)
+# executeCode
 
-## Визначення
+Виконує фрагмент коду всередині живого ядра чи пісочниці, наданої інтеграцією IDE (наприклад, Jupyter-ядра, привʼязаного до поточно відкритого ноутбука). Інструмент присутній лише тоді, коли Claude Code працює поряд із сумісним мостом IDE, таким як розширення VS Code із вибраним Jupyter-ядром.
 
-Виконує Python-код у Jupyter kernel поточного файлу notebook.
+## Коли використовувати
+
+- Швидке обчислення, перевірка даних чи побудова графіка на стані, вже завантаженому в активному Jupyter-ядрі.
+- Валідація фрагмента коду перед вставкою його в клітинку ноутбука.
+- Дослідження dataframe у памʼяті, змінної чи моделі, що існує в ядрі, але не серіалізована на диск.
+- Створення графіка чи числового результату, який користувач хоче відрендерити вбудовано в IDE.
+
+НЕ використовуйте для самостійних скриптів, які краще обслуговуватиме `Bash`, що запускає `python script.py`, або для коду, що потребує збереження між свіжими ядрами.
 
 ## Параметри
 
-| Параметр | Тип | Обов'язковий | Опис |
-|----------|-----|--------------|------|
-| `code` | string | Так | Python-код для виконання |
+- `code` (string, обовʼязковий): Код для виконання в поточному ядрі. Виконується так, наче вставлений у клітинку ноутбука — змінні, визначені, зберігаються в ядрі, поки його не перезапустять.
+- `language` (string, необовʼязковий): Мова фрагмента, коли міст IDE підтримує кілька ядер. Найчастіше опускається; за замовчуванням — мова активного ядра (зазвичай Python).
+
+## Приклади
+
+### Приклад 1: Перевірка dataframe у памʼяті
+
+```
+executeCode(
+  code="df.head()\nprint(df.shape)\nprint(df.dtypes)"
+)
+```
+
+Повертає перші рядки, форму та типи колонок dataframe, уже завантаженого в ядрі.
 
-## Сценарії використання
+### Приклад 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, що експонує ядро (наприклад, розширення Jupyter VS Code).
+- Стан зберігається в ядрі. Змінні, визначені одним викликом `executeCode`, залишаються видимими для пізніших викликів, клітинок ноутбука та користувача — уважно ставтеся до побічних ефектів.
+- Тривалий чи блокуючий код блокуватиме ядро. Тримайте фрагменти короткими; для багатохвилинної роботи пишіть справжній скрипт і запускайте його через `Bash`.
+- Вивід (stdout, значення, що повертаються, зображення) повертається в сесію. Дуже великі виводи можуть бути обрізані мостом IDE.
+- Для правок файлів віддавайте перевагу `Edit`, `Write` чи `NotebookEdit` — `executeCode` не замінює авторства файлів вихідного коду.

package/concepts/uk/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, необовʼязковий): URI файлу (зазвичай `file:///absolute/path`), для якого отримати діагностику. Коли опущено, інструмент повертає діагностику для кожного файлу, що IDE наразі тримає відкритим.
 
-## Сценарії використання
+## Приклади
 
-**Підходить для:**
-- Перевірка синтаксичних, типових, lint та інших семантичних проблем коду
-- Перевірка після редагування коду, чи не з'явилися нові помилки
-- Заміна команд Bash для перевірки якості коду
+### Приклад 1: Перевірка одного файлу після редагування
 
-**Не підходить для:**
-- Запуск тестів — слід використовувати Bash
-- Перевірка помилок виконання — слід використовувати Bash для виконання коду
+```
+getDiagnostics(
+  uri="file:///Users/sky/project/src/auth.ts"
+)
+```
 
-## Примітки
+Повертає будь-які помилки TypeScript, попередження ESLint чи інші повідомлення мовного сервера для `src/auth.ts`.
 
-- Це 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/uk/Tools.md

@@ -8,7 +8,7 @@ Claude Code надає моделі набір вбудованих інстру
 
 | Інструмент | Призначення |
 |------------|-------------|
-| [Task](Tool-Task.md) | Запуск підагента (SubAgent) для обробки складних багатокрокових завдань |
+| [Agent](Tool-Agent.md) | Запуск підагента (SubAgent) для обробки складних багатокрокових завдань |
 | [TaskOutput](Tool-TaskOutput.md) | Отримання виводу фонового завдання |
 | [TaskStop](Tool-TaskStop.md) | Зупинка запущеного фонового завдання |
 | [TaskCreate](Tool-TaskCreate.md) | Створення запису структурованого списку завдань |

package/concepts/zh/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 以供进一步处理
+## 何时使用
 
-## 出现时机
+- 你需要回答需要三次或更多独立搜索或读取的问题。例如：「从登录路由到会话存储，认证是如何串联起来的？」
+- 目标未知——你还不知道要看哪个文件、模块或符号。
+- 你在做出改动前需要对仓库陌生区域的结构性概览。
+- 你要交叉比对多个候选（例如几个名字相似的 helper 中，哪一个实际在生产中被调用）。
+- 你需要文献式总结：「列出每一处 import X 的位置，并按调用点分类。」
 
-Search 子 agent 通常在以下情况出现：
+不要在以下情况使用 Search：
 
-1. 主 agent 需要查找特定文件、函数或代码模式时
-2. 用户请求进行广泛的代码库探索时
-3. agent 正在调查依赖关系、引用或使用模式时
+- 你已经知道确切的文件和行号。直接调用 `Read`。
+- 一次 `Grep` 或 `Glob` 就能回答问题。直接执行；派发子代理会增加开销。
+- 任务需要编辑、运行命令或任何副作用。Search 按设计是只读的。
+- 你需要某次工具调用的精确逐字输出。子代理做摘要；它们不转发原始结果。
+
+## 彻底程度
+
+根据问题的利害选择级别。
+
+- `quick` —— 数次有针对性的搜索，尽力而为的答案。适用于需要快速指针（如「env 变量解析逻辑在哪？」）且能接受不完整答案后自行迭代的场景。
+- `medium` —— 默认值。若干轮搜索、交叉核对候选并完整阅读最相关的文件。适用于典型「帮我理解这个区域」的问题。
+- `very thorough` —— 穷尽式探索。子代理会追查每条可信线索、阅读周围上下文、在总结前再次核对结论。当正确性重要（例如安全审查、迁移规划），或不完整的答案会导致返工时使用。
+
+更高的彻底度在子代理内消耗更多时间和 token，但那些 token 都留在子代理内——只有最终摘要回到主代理。
+
+## 可用工具
+
+Search 可访问主代理所用的所有只读工具，仅限于此：
+
+- `Read` —— 读取具体文件，包括部分范围。
+- `Grep` —— 在整树上做内容搜索。
+- `Glob` —— 按名称模式定位文件。
+- 只读模式的 `Bash` —— 用于检查状态而不变更状态的命令（例如 `git log`、`git show`、`ls`、`wc`）。
+- `WebFetch` 和 `WebSearch` —— 当需要时阅读外部文档。
+
+编辑类工具（`Write`、`Edit`、`NotebookEdit`）、修改状态的 shell 命令，以及任务图工具（`TaskCreate`、`TaskUpdate` 等）被刻意禁用。
+
+## 注意事项
+
+- 给 Search 子代理一个具体的问题，而不是一个主题。「List every caller of `renderMessage` and note which ones pass a custom theme」会返回有用的答案；「tell me about rendering」不会。
+- 子代理返回摘要。若需要精确文件路径，请在提示中显式要求。
+- 多个独立问题最好作为多个并行的 Search 子代理派发，而非一个长 prompt，这样每个都能聚焦。
+- 因为 Search 不能编辑，请在主代理中配以后续的编辑步骤，等你知道该改什么后再动手。
+- 把 Search 输出当作证据，而非真理。对任何承载决策的内容，动作前请自行打开引用的文件。

package/concepts/zh/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 使用指南问答 | 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, 必填)：3-5 个词的简短标签，用于描述任务；显示在 UI 与日志中。
+- `prompt` (string, 必填)：代理将执行的完整、自包含的任务说明。必须包含所有必要的上下文、约束条件以及期望的返回格式。
+- `subagent_type` (string, 可选)：预设的角色，如 `general-purpose`、`Explore`、`Plan`、`claude-code-guide` 或 `statusline-setup`。默认为 `general-purpose`。
+- `run_in_background` (boolean, 可选)：为 true 时，代理异步运行，父级可继续工作；结果稍后再获取。
+- `model` (string, 可选)：为该代理覆盖模型——`opus`、`sonnet` 或 `haiku`。默认使用父会话模型。
+- `isolation` (string, 可选)：设为 `worktree` 可让代理在隔离的 git worktree 中运行，避免其文件写入与父级冲突。
+- `team_name` (string, 可选)：派生到已有团队时，代理将加入的团队标识符。
+- `name` (string, 可选)：队友在团队内可寻址的名称，用作 `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.
+在同一条消息中启动两个代理——一个检查构建流水线，一个审查测试框架。每个代理拥有独立的上下文窗口并返回摘要。在单个工具调用块中批量发起可让它们并发执行。
 
-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` 必须完全自包含——包含文件路径、约定、问题以及你希望收到的确切答案形式。
+- 代理仅返回一条最终消息。它无法在运行中途提出澄清问题，因此提示中的歧义会导致结果靠猜测。
+- 并行运行多个代理在子任务彼此独立时，比串行调用快得多。请在单个工具调用块中批量发起。
+- 当代理需要写入文件，且你希望在并入主工作树前审阅改动时，请使用 `isolation: "worktree"`。
+- 只读侦察优先选择 `subagent_type: "Explore"`，设计工作选择 `Plan`；`general-purpose` 是读写混合任务的默认选项。
+- 后台代理（`run_in_background: true`）适合长时间运行的任务；不要在 sleep 循环中轮询——父级会在完成时收到通知。