cc-viewer 1.6.182 → 1.6.183

package/concepts/ru/Tool-TaskStop.md

@@ -1,32 +1,45 @@
 # TaskStop
 
-## Определение
+Останавливает запущенную фоновую задачу — shell-команду, запущенного агента или удалённую сессию — по её runtime-handle. Используйте, чтобы вернуть ресурсы, отменить работу, которая больше не полезна, или восстановиться, когда задача зависла.
 
-Останавливает работающую фоновую задачу.
+## Когда использовать
+
+- Фоновая shell-команда работает дольше ожидаемого, и её результат вам больше не нужен.
+- Локальный агент зациклился или застрял, и его нужно прервать.
+- Пользователь сменил направление, и фоновую работу по прежнему направлению следует бросить.
+- Удалённая сессия вот-вот таймаутнется или держит нужный вам ресурс.
+- Нужен чистый старт перед запуском того же задания заново.
+
+Предпочитайте давать коротко живущей фоновой работе завершиться самостоятельно. `TaskStop` — для случаев, когда продолжение бесполезно или активно вредно.
 
 ## Параметры
 
-| Параметр | Тип | Обязательный | Описание |
-|------|------|------|------|
-| `task_id` | string | Нет | ID фоновой задачи для остановки |
-| `shell_id` | string | Нет | Устарел, используйте `task_id` вместо этого |
+- `task_id` (string, обязательный): runtime-handle, возвращённый при старте фоновой задачи. Тот же идентификатор, что принимает `TaskOutput`, не `taskId` из списка задач.
 
-## Сценарии использования
+## Примеры
 
-**Подходящее применение:**
-- Завершение долго работающей задачи, которая больше не нужна
-- Отмена ошибочно запущенной фоновой задачи
+### Пример 1
 
-## Примечания
+Остановить взбесившуюся фоновую shell-команду.
+
+```
+TaskStop(task_id: "bash_01HXYZ...")
+```
 
-- Возвращает статус успеха или неудачи
-- Параметр `shell_id` устарел, следует использовать `task_id`
+Команда получает сигнал завершения; буферизованный вывод, записанный на текущий момент, остаётся читаемым по пути её вывода.
 
-## Оригинальный текст
+### Пример 2
+
+Отменить запущенного агента после смены направления пользователем.
+
+```
+TaskStop(task_id: "agent_01ABCD...")
+```
+
+## Примечания
 
-<textarea readonly>
-- Stops a running background task by its ID
-- Takes a task_id parameter identifying the task to stop
-- Returns a success or failure status
-- Use this tool when you need to terminate a long-running task
-</textarea>
+- `TaskStop` запрашивает завершение; мгновенного выключения он не гарантирует. Хорошо ведущие себя задачи выходят быстро, но процесс, занятый блокирующим I/O, может уходить чуть дольше.
+- Остановка задачи не удаляет её вывод. Для фоновых shell-задач файл вывода на диске сохраняется и по-прежнему читаем через `Read`. Для агентов и сессий всё, что было захвачено до остановки, остаётся доступным через `TaskOutput`.
+- Неизвестный `task_id` или уже завершённая задача возвращают ошибку или no-op. Это безопасно — можно вызывать `TaskStop` защитно, не проверяя статус предварительно.
+- Если планируется перезапустить ту же работу, остановите старую задачу перед стартом новой, чтобы избежать двух параллельных запусков, гоняющихся за общими ресурсами (файлы, порты, строки БД).
+- `TaskStop` не влияет на записи в списке задач команды. Чтобы отменить отслеживаемую задачу, обновите её статус на `deleted` через `TaskUpdate`.

package/concepts/ru/Tool-TaskUpdate.md

@@ -1,123 +1,70 @@
 # TaskUpdate
 
-## Определение
+Модифицирует существующую задачу — её статус, содержимое, владение, метаданные или рёбра зависимостей. Так задачи проходят через свой жизненный цикл и так работа передаётся между Claude Code, сокомандниками и подагентами.
 
-Обновляет статус, содержимое или зависимости задачи в списке задач.
+## Когда использовать
 
-## Параметры
-
-| Параметр | Тип | Обязательный | Описание |
-|------|------|------|------|
-| `taskId` | string | Да | ID задачи для обновления |
-| `status` | enum | Нет | Новый статус: `pending` / `in_progress` / `completed` / `deleted` |
-| `subject` | string | Нет | Новый заголовок |
-| `description` | string | Нет | Новое описание |
-| `activeForm` | string | Нет | Текст в настоящем продолженном времени, отображаемый во время выполнения |
-| `owner` | string | Нет | Новый ответственный за задачу (имя агента) |
-| `metadata` | object | Нет | Метаданные для слияния (установка в null удаляет ключ) |
-| `addBlocks` | string[] | Нет | Список ID задач, заблокированных этой задачей |
-| `addBlockedBy` | string[] | Нет | Список ID предшествующих задач, блокирующих эту задачу |
-
-## Переход статусов
-
-```
-pending → in_progress → completed
-```
-
-`deleted` может быть установлен из любого статуса, безвозвратно удаляет задачу.
-
-## Сценарии использования
-
-**Подходящее применение:**
-- Пометка задачи как `in_progress` при начале работы
-- Пометка задачи как `completed` после завершения работы
-- Установка зависимостей между задачами
-- Обновление содержимого задачи при изменении требований
-
-**Важные правила:**
-- Помечайте как `completed` только при полном завершении задачи
-- При ошибках или блокировках сохраняйте статус `in_progress`
-- Не помечайте как `completed`, когда тесты не проходят, реализация неполная или возникли неразрешённые ошибки
-
-## Примечания
-
-- Перед обновлением следует получить актуальное состояние задачи через TaskGet, чтобы избежать устаревших данных
-- После завершения задачи вызовите TaskList для поиска следующей доступной задачи
+- Переход задачи по рабочему процессу статусов по мере работы над ней.
+- Взятие задачи путём назначения себя (или другого агента) `owner`.
+- Уточнение `subject` или `description` по мере понимания проблемы.
+- Фиксация вновь обнаруженных зависимостей через `addBlocks` / `addBlockedBy`.
+- Прикрепление структурированных `metadata`, таких как внешние ID тикетов или подсказки о приоритете.
 
-## Оригинальный текст
-
-<textarea readonly>Use this tool to update a task in the task list.
-
-## When to Use This Tool
-
-**Mark tasks as resolved:**
-- When you have completed the work described in a task
-- When a task is no longer needed or has been superseded
-- IMPORTANT: Always mark your assigned tasks as resolved when you finish them
-- After resolving, call TaskList to find your next task
-
-- ONLY mark a task as completed when you have FULLY accomplished it
-- If you encounter errors, blockers, or cannot finish, keep the task as in_progress
-- When blocked, create a new task describing what needs to be resolved
-- Never mark a task as completed if:
-  - Tests are failing
-  - Implementation is partial
-  - You encountered unresolved errors
-  - You couldn't find necessary files or dependencies
-
-**Delete tasks:**
-- When a task is no longer relevant or was created in error
-- Setting status to `deleted` permanently removes the task
+## Параметры
 
-**Update task details:**
-- When requirements change or become clearer
-- When establishing dependencies between tasks
+- `taskId` (string, обязательный): задача для модификации. Получайте из `TaskList` или `TaskCreate`.
+- `status` (string, необязательный): один из `pending`, `in_progress`, `completed`, `deleted`.
+- `subject` (string, необязательный): новый императивный заголовок.
+- `description` (string, необязательный): новое подробное описание.
+- `activeForm` (string, необязательный): новый текст-спиннер в настоящем продолженном.
+- `owner` (string, необязательный): handle агента или сокомандника, берущего ответственность за задачу.
+- `metadata` (object, необязательный): ключи метаданных для слияния в задачу. Установите ключ в `null`, чтобы удалить его.
+- `addBlocks` (array of strings, необязательный): ID задач, которые блокирует эта задача.
+- `addBlockedBy` (array of strings, необязательный): ID задач, которые должны завершиться прежде этой.
 
-## Fields You Can Update
+## Рабочий процесс статусов
 
-- **status**: The task status (see Status Workflow below)
-- **subject**: Change the task title (imperative form, e.g., "Run tests")
-- **description**: Change the task description
-- **activeForm**: Present continuous form shown in spinner when in_progress (e.g., "Running tests")
-- **owner**: Change the task owner (agent name)
-- **metadata**: Merge metadata keys into the task (set a key to null to delete it)
-- **addBlocks**: Mark tasks that cannot start until this one completes
-- **addBlockedBy**: Mark tasks that must complete before this one can start
+Жизненный цикл намеренно линеен: `pending` → `in_progress` → `completed`. `deleted` — терминальный, используется для отзыва задач, над которыми никогда не будут работать.
 
-## Status Workflow
+- Ставьте `in_progress` в момент фактического начала работы, не раньше. Одновременно только одна задача на владельца должна быть `in_progress`.
+- Ставьте `completed`, только когда работа полностью сделана — критерии приёмки выполнены, тесты проходят, вывод записан. Если появляется блокер, держите задачу `in_progress` и добавьте новую задачу, описывающую, что нужно решить.
+- Никогда не помечайте задачу `completed`, когда тесты падают, реализация частична или вы столкнулись с неразрешёнными ошибками.
+- Используйте `deleted` для отменённых или дублирующих задач; не перепрофилируйте задачу под несвязанную работу.
 
-Status progresses: `pending` → `in_progress` → `completed`
+## Примеры
 
-Use `deleted` to permanently remove a task.
+### Пример 1
 
-## Staleness
+Взять задачу и начать её.
 
-Make sure to read a task's latest state using `TaskGet` before updating it.
+```
+TaskUpdate(
+  taskId: "t_01HXYZ...",
+  status: "in_progress",
+  owner: "main-agent"
+)
+```
 
-## Examples
+### Пример 2
 
-Mark task as in progress when starting work:
-```json
-{"taskId": "1", "status": "in_progress"}
-```
+Закончить работу и зафиксировать follow-up зависимость.
 
-Mark task as completed after finishing work:
-```json
-{"taskId": "1", "status": "completed"}
 ```
-
-Delete a task:
-```json
-{"taskId": "1", "status": "deleted"}
+TaskUpdate(
+  taskId: "t_01HXYZ...",
+  status: "completed"
+)
+
+TaskUpdate(
+  taskId: "t_01FOLLOWUP...",
+  addBlockedBy: ["t_01HXYZ..."]
+)
 ```
 
-Claim a task by setting owner:
-```json
-{"taskId": "1", "owner": "my-name"}
-```
+## Примечания
 
-Set up task dependencies:
-```json
-{"taskId": "2", "addBlockedBy": ["1"]}
-```
-</textarea>
+- `metadata` сливается ключ за ключом; передача `null` для ключа удаляет его. Сначала вызовите `TaskGet`, если не уверены в текущем содержимом.
+- `addBlocks` и `addBlockedBy` добавляют рёбра; они не удаляют существующие. Деструктивная правка графа требует выделенного процесса — проконсультируйтесь с владельцем команды перед переписью зависимостей.
+- Держите `activeForm` синхронным при изменении `subject`, чтобы текст-спиннер продолжал читаться естественно.
+- Не помечайте задачу `completed`, чтобы просто её заглушить. Если пользователь отменил работу, используйте `deleted` с кратким обоснованием в `description`.
+- Прочитайте последнее состояние задачи через `TaskGet` перед обновлением — сокомандники могли изменить его между вашим последним чтением и записью.

package/concepts/ru/Tool-TeamCreate.md

@@ -1,38 +1,53 @@
 # TeamCreate
 
-## Определение
+Учреждает новую команду для совместной работы с общим списком задач и каналом обмена сообщениями между агентами. Команда — примитив координации для многоагентной работы: основная сессия выступает лидером и порождает именованных сокомандников через инструмент `Agent`.
 
-Создаёт новую команду для координации нескольких агентов, работающих над проектом. Команды обеспечивают параллельное выполнение задач через общий список задач и межагентный обмен сообщениями.
+## Когда использовать
+
+- Пользователь явно запрашивает команду, swarm, crew или многоагентное сотрудничество.
+- Проект имеет несколько чётко независимых потоков работы, выигрывающих от выделенных специалистов (например, frontend, backend, тесты, документация).
+- Нужен постоянный общий список задач, который несколько агентов обновляют по мере прогресса.
+- Вам нужны именованные, адресуемые сокомандники, способные обмениваться сообщениями через `SendMessage`, а не одноразовые вызовы подагента.
+
+НЕ используйте для одиночного делегированного поиска или разового параллельного разветвления — обычные вызовы `Agent` легче и достаточны.
 
 ## Параметры
 
-| Параметр | Тип | Обязательный | Описание |
-|----------|-----|--------------|----------|
-| `team_name` | string | Да | Название новой команды |
-| `description` | string | Нет | Описание / назначение команды |
-| `agent_type` | string | Нет | Тип / роль руководителя команды |
+- `team_name` (string, обязательный): уникальный идентификатор команды. Используется как имя каталога под `~/.claude/teams/` и как аргумент `team_name` при порождении сокомандников.
+- `description` (string, обязательный): краткая формулировка цели команды. Показывается каждому сокомандник при старте и записывается в конфиг команды.
+- `agent_type` (string, необязательный): тип персоны подагента по умолчанию, применяемый к сокомандникам, не переопределяющим его. Типичные значения: `general-purpose`, `Explore` или `Plan`.
+
+## Примеры
+
+### Пример 1: создание команды рефакторинга
 
-## Что создаётся
+```
+TeamCreate(
+  team_name="refactor-crew",
+  description="Refactor the data access layer from raw SQL to Prisma, including migrations and tests.",
+  agent_type="general-purpose"
+)
+```
 
-- **Файл конфигурации команды**: `~/.claude/teams/{team-name}/config.json` — хранит список участников и метаданные
-- **Каталог списка задач**: `~/.claude/tasks/{team-name}/` — общий список задач для всех участников команды
+После создания порождайте сокомандников через `Agent` с `team_name: "refactor-crew"` и разными значениями `name`, такими как `db-lead`, `migrations` и `tests`.
 
-Команды имеют соответствие 1:1 со списками задач.
+### Пример 2: создание исследовательской команды
 
-## Рабочий процесс команды
+```
+TeamCreate(
+  team_name="perf-investigation",
+  description="Identify and rank the top three performance regressions introduced in the last release.",
+  agent_type="Explore"
+)
+```
 
-1. **TeamCreate** — создать команду и её список задач
-2. **TaskCreate** — определить задачи для команды
-3. **Agent** (с `team_name` + `name`) — запустить участников, вступающих в команду
-4. **TaskUpdate** — назначить задачи участникам через `owner`
-5. Участники работают над задачами и общаются через **SendMessage**
-6. Завершить работу участников, затем **TeamDelete** для очистки
+Каждый порождённый сокомандник наследует `Explore` как персону по умолчанию, соответствующую исследовательскому характеру работы только на чтение.
 
-## Связанные инструменты
+## Примечания
 
-| Инструмент | Назначение |
-|------------|------------|
-| `TeamDelete` | Удалить команду и каталоги задач |
-| `SendMessage` | Межагентное взаимодействие внутри команды |
-| `TaskCreate` / `TaskUpdate` / `TaskList` / `TaskGet` | Управление общим списком задач |
-| `Agent` | Запустить участников, вступающих в команду |
+- Из одной сессии можно лидировать только одну команду одновременно. Завершите или удалите текущую команду перед созданием новой.
+- Команда связана 1:1 с общим списком задач. Лидер владеет созданием, назначением и закрытием задач; сокомандники обновляют статус задач, над которыми работают.
+- Конфигурация команды сохраняется в `~/.claude/teams/{team_name}/config.json`, а каталог задач живёт рядом с ней. Эти файлы переживают сессии до явного удаления через `TeamDelete`.
+- Сокомандники порождаются инструментом `Agent` с совпадающим `team_name` плюс уникальным `name`. `name` становится адресом, используемым `SendMessage`.
+- Выбирайте `team_name`, безопасный для файловой системы (буквы, цифры, дефисы, подчёркивания). Избегайте пробелов или слэшей.
+- Пишите `description` так, чтобы совершенно новый сокомандник, читая его с чистого листа, понимал цель команды без дополнительного контекста. Оно становится частью стартового промпта каждого сокомандника.

package/concepts/ru/Tool-TeamDelete.md

@@ -1,30 +1,44 @@
 # TeamDelete
 
-## Определение
+Сносит текущую активную команду, удаляя её каталог конфигурации и каталог общих задач. Это очистительный антипод `TeamCreate`, обычно вызываемый после достижения цели команды и завершения работы всеми сокомандниками.
 
-Удаляет команду и связанные каталоги задач после завершения работы в рамках многоагентного взаимодействия. Является операцией очистки, обратной по отношению к TeamCreate.
+## Когда использовать
 
-## Поведение
+- Команда завершила работу и финальный отчёт доставлен пользователю.
+- Команда создана по ошибке, либо её область настолько изменилась, что стартовать с чистого листа чище, чем продолжать.
+- Нужно создать новую команду, но одна уже активна — сначала удалите старую, поскольку одновременно можно лидировать только одну команду.
+- Команда стала застойной между сессиями, и её сохранённое состояние под `~/.claude/teams/` больше не нужно.
 
-- Удаляет каталог команды: `~/.claude/teams/{team-name}/`
-- Удаляет каталог списка задач: `~/.claude/tasks/{team-name}/`
-- Очищает контекст команды из текущей сессии
+НЕ вызывайте, пока сокомандники всё ещё работают — сначала завершите их работу через `SendMessage` с `shutdown_request`, дождитесь каждого `shutdown_response`, затем удаляйте.
 
-**Важно**: TeamDelete завершится ошибкой, если в команде ещё есть активные участники. Сначала необходимо корректно завершить работу всех участников через запросы shutdown в SendMessage.
+## Параметры
 
-## Типичное использование
+`TeamDelete` в своём типичном вызове не принимает параметров. Действует на текущую активную команду, принадлежащую вызывающей сессии.
 
-TeamDelete вызывается в конце рабочего процесса команды:
+## Примеры
 
-1. Все задачи выполнены
-2. Участники завершают работу через `SendMessage` с `shutdown_request`
-3. **TeamDelete** удаляет каталоги команды и задач
+### Пример 1: штатное завершение работы после успеха
 
-## Связанные инструменты
+1. Разошлите запрос на завершение команде:
+   ```
+   SendMessage(to="*", message={ "type": "shutdown_request" })
+   ```
+2. Дождитесь, пока каждый сокомандник ответит `shutdown_response`.
+3. Вызовите `TeamDelete()`, чтобы удалить каталог команды и каталог задач.
 
-| Инструмент | Назначение |
-|------------|------------|
-| `TeamCreate` | Создать новую команду и её список задач |
-| `SendMessage` | Взаимодействие с участниками команды / отправка запросов shutdown |
-| `TaskCreate` / `TaskUpdate` / `TaskList` / `TaskGet` | Управление общим списком задач |
-| `Agent` | Запустить участников, вступающих в команду |
+### Пример 2: замена неверно сконфигурированной команды
+
+Если `TeamCreate` был вызван с неверным `agent_type` или `description`, сначала убедитесь, что сокомандники ещё не порождены (или заверши их работу), затем:
+
+```
+TeamDelete()
+TeamCreate(team_name="...", description="...", agent_type="...")
+```
+
+## Примечания
+
+- `TeamDelete` падает, если какой-либо сокомандник всё ещё активен. Ответ с ошибкой перечисляет живых сокомандников — отправьте каждому `shutdown_request` через `SendMessage`, дождитесь их `shutdown_response` и повторите.
+- Удаление с точки зрения инструмента необратимо. Конфиг команды в `~/.claude/teams/{team_name}/config.json` и её каталог задач удаляются с диска. Если нужен сохранённый список задач, экспортируйте или скопируйте каталог перед удалением.
+- Удалить команду может только лидерская сессия, которая её создала. Порождённый сокомандник не может вызвать `TeamDelete` на своей команде.
+- Удаление команды не откатывает никакие изменения файловой системы, сделанные сокомандниками в репозитории. Это обычные git-отслеживаемые правки, и их нужно откатывать отдельно, если они нежелательны.
+- После успешного возврата `TeamDelete` сессия свободна снова вызвать `TeamCreate` для новой команды.

package/concepts/ru/Tool-WebFetch.md

@@ -1,55 +1,50 @@
 # WebFetch
 
-## Определение
+Забирает содержимое публичной веб-страницы, конвертирует HTML в Markdown и прогоняет результат через небольшую вспомогательную модель с промптом на естественном языке, чтобы извлечь нужную информацию.
 
-Получает содержимое веб-страницы по указанному URL, конвертирует HTML в markdown и обрабатывает содержимое с помощью AI-модели согласно prompt.
+## Когда использовать
+
+- Чтение публичной страницы документации, записи в блоге или RFC, упомянутой в разговоре.
+- Извлечение конкретного факта, фрагмента кода или таблицы с известного URL без загрузки всей страницы в контекст.
+- Резюмирование release-ноут или чейнджлога из открытого веб-ресурса.
+- Проверка публичного API-справочника библиотеки, когда исходников нет в локальном репозитории.
+- Переход по ссылке, которую пользователь вставил в чат, чтобы ответить на follow-up вопрос.
 
 ## Параметры
 
-| Параметр | Тип | Обязательный | Описание |
-|------|------|------|------|
-| `url` | string (URI) | Да | Полный URL для получения |
-| `prompt` | string | Да | Описание информации для извлечения со страницы |
+- `url` (string, обязательный): полностью сформированный абсолютный URL. Обычный `http://` автоматически апгрейдится до `https://`.
+- `prompt` (string, обязательный): инструкция, передаваемая маленькой модели извлечения. Опишите точно, что вытащить со страницы, например «перечисли все экспортируемые функции» или «верни минимальную поддерживаемую версию 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, конвертирует в 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
-- URL GitHub — предпочитайте использование `gh` CLI
+Полезно, когда пользователь спрашивает «что изменилось в Node 20.11», а страница релиза длинная.
 
 ## Примечания
 
-- URL должен быть полным, валидным URL
-- HTTP автоматически обновляется до HTTPS
-- Слишком большое содержимое может быть сокращено
-- Включает 15-минутный самоочищающийся кеш
-- Когда URL перенаправляет на другой хост, инструмент возвращает URL перенаправления — необходимо повторить запрос с новым URL
-- Если доступен инструмент web fetch, предоставляемый MCP, предпочитайте его использование
-
-## Оригинальный текст
-
-<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` падает на любом URL, требующем аутентификации, cookies или VPN. Для Google Docs, Confluence, Jira, приватных ресурсов GitHub или внутренних вики используйте специализированный MCP-сервер, предоставляющий аутентифицированный доступ.
+- Для всего, что хостится на GitHub (PR, issues, блобы файлов, ответы API), предпочитайте CLI `gh` через `Bash`, а не скрейпинг веб-UI. `gh pr view`, `gh issue view` и `gh api` возвращают структурированные данные и работают с приватными репозиториями.
+- Результаты могут быть обобщены, когда забранная страница очень большая. Если нужен точный текст, сузьте `prompt` запросом дословной выдержки.
+- На каждый URL применяется самоочищающийся 15-минутный кэш. Повторные вызовы одной и той же страницы в рамках сессии почти мгновенны, но могут вернуть слегка устаревшее содержимое. Если свежесть важна, упомяните это в промпте или переждите кэш.
+- Если целевой хост выдаёт кросс-хост редирект, инструмент возвращает новый URL в специальном блоке ответа и не следует за ним автоматически. Перевызовите `WebFetch` с целью редиректа, если всё ещё хотите содержимое.
+- Промпт выполняется моделью меньше и быстрее основного ассистента. Держите его узким и конкретным; сложные многошаговые рассуждения лучше обработать, прочитав сырой Markdown самостоятельно после забора.
+- Никогда не передавайте секреты, токены или идентификаторы сессий, встроенные в URL, — содержимое страниц и строки запросов, отражённые в выводе, могут логироваться upstream-сервисами.

package/concepts/ru/Tool-WebSearch.md

@@ -1,58 +1,51 @@
 # WebSearch
 
-## Определение
+Выполняет живой веб-поиск и возвращает ранжированные результаты, которые ассистент использует, чтобы заземлить ответ в актуальной информации за пределами обучающего cutoff модели.
 
-Выполняет запрос к поисковой системе, возвращая результаты поиска для получения актуальной информации.
+## Когда использовать
+
+- Ответы на вопросы о текущих событиях, недавних релизах или срочных новостях.
+- Поиск последней версии библиотеки, фреймворка или CLI-инструмента.
+- Нахождение документации или записей в блоге, когда точный URL неизвестен.
+- Проверка факта, который мог измениться с момента обучения модели.
+- Изучение разных точек зрения по теме перед получением конкретной страницы через `WebFetch`.
 
 ## Параметры
 
-| Параметр | Тип | Обязательный | Описание |
-|------|------|------|------|
-| `query` | string | Да | Поисковый запрос (минимум 2 символа) |
-| `allowed_domains` | string[] | Нет | Включать только результаты с этих доменов |
-| `blocked_domains` | string[] | Нет | Исключать результаты с этих доменов |
+- `query` (string, обязательный): поисковый запрос. Минимальная длина 2 символа. Включайте текущий год при запросе «последней» или «недавней» информации, чтобы результаты были свежими.
+- `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 или попросите пользователя вставить релевантное содержимое.
+- Каждый вызов выполняет поиск за один round-trip — вы не можете стримить или пагинировать. Уточняйте запрос, если первый набор результатов не попал в цель.
+- Инструмент возвращает сниппеты и метаданные, а не полное содержимое страниц. Чтобы прочитать конкретное попадание в глубину, сделайте follow-up через `WebFetch` с возвращённым URL.
+- Используйте `allowed_domains`, чтобы обеспечить авторитетное сорсинг для вопросов, чувствительных к безопасности, таких как CVE или комплаенс, и `blocked_domains`, чтобы обрезать SEO-фермы, зеркалящие документацию.
+- Держите запросы короткими и ключево-ориентированными. Запросы на естественном языке работают, но склонны возвращать разговорные ответы, а не первичные источники.
+- Не изобретайте URL по поисковой интуиции — всегда запускайте поиск и цитируйте то, что инструмент действительно вернул.