cc-viewer 1.6.182 → 1.6.183

package/concepts/ru/Tool-SendMessage.md

@@ -1,41 +1,68 @@
 # SendMessage
 
-## Определение
+Доставляет сообщение от одного участника команды к другому внутри активной команды или рассылает всем сокомандникам сразу. Это единственный канал, который слышат сокомандники — всё, что написано в обычный текстовый вывод, для них невидимо.
 
-Отправляет сообщения между агентами внутри команды. Используется для прямого общения, широковещательных рассылок и протокольных сообщений (запросы/ответы на завершение, утверждение планов).
+## Когда использовать
+
+- Назначение задачи или передача подпроблемы именованному сокоманднику во время командной работы.
+- Запрос статуса, промежуточных находок или ревью кода у другого агента.
+- Рассылка решения, общего ограничения или объявления о завершении работы всей команде через `*`.
+- Ответ на протокольный запрос, такой как запрос на завершение работы или запрос на одобрение плана от лидера команды.
+- Замыкание цикла в конце делегированной задачи, чтобы лидер мог отметить пункт завершённым.
 
 ## Параметры
 
-| Параметр | Тип | Обязательный | Описание |
-|----------|-----|--------------|----------|
-| `to` | string | Да | Получатель: имя участника или `"*"` для рассылки всем |
-| `message` | string / object | Да | Текстовое сообщение или структурированный протокольный объект |
-| `summary` | string | Нет | Превью из 5-10 слов, отображаемое в интерфейсе |
+- `to` (string, обязательный): `name` целевого сокомандника, зарегистрированное в команде, либо `*` для рассылки всем сокомандникам сразу.
+- `message` (string или object, обязательный): обычный текст для стандартного общения или структурированный объект для протокольных ответов, таких как `shutdown_response` и `plan_approval_response`.
+- `summary` (string, необязательный): превью из 5–10 слов, показываемое в журнале активности команды для текстовых сообщений. Обязателен для длинных строковых сообщений; игнорируется, когда `message` — протокольный объект.
+
+## Примеры
+
+### Пример 1: прямая передача задачи
+
+```
+SendMessage(
+  to="db-lead",
+  message="Please audit prisma/schema.prisma and list any model missing createdAt/updatedAt timestamps. Reply when done.",
+  summary="Audit schema for missing timestamps"
+)
+```
 
-## Типы сообщений
+### Пример 2: рассылка общего ограничения
 
-### Текст
-Прямые сообщения между участниками команды для координации, обновления статуса и обсуждения задач.
+```
+SendMessage(
+  to="*",
+  message="Reminder: do not touch files under legacy/ — that subtree is frozen until the migration PR lands.",
+  summary="Freeze legacy/ during migration"
+)
+```
 
-### Запрос на завершение
-Просит участника корректно завершить работу: `{ type: "shutdown_request", reason: "..." }`
+### Пример 3: протокольный ответ
 
-### Ответ на завершение
-Участник одобряет или отклоняет завершение: `{ type: "shutdown_response", approve: true/false }`
+Ответьте на запрос о завершении работы от лидера структурированным сообщением:
 
-### Ответ на утверждение плана
-Одобряет или отклоняет план участника: `{ type: "plan_approval_response", approve: true/false }`
+```
+SendMessage(
+  to="leader",
+  message={ "type": "shutdown_response", "ready": true, "final_report": "All assigned diff chunks committed on branch refactor-crew/db-lead." }
+)
+```
 
-## Широковещание vs. прямое
+### Пример 4: ответ на одобрение плана
 
-- **Прямое** (`to: "имя-участника"`): Отправить конкретному участнику — предпочтительно для большинства коммуникаций
-- **Широковещание** (`to: "*"`): Отправить всем участникам — использовать экономно, только для критических командных объявлений
+```
+SendMessage(
+  to="leader",
+  message={ "type": "plan_approval_response", "approved": true, "notes": "LGTM, but please split step 4 into migration + backfill." }
+)
+```
 
-## Связанные инструменты
+## Примечания
 
-| Инструмент | Назначение |
-|------------|------------|
-| `TeamCreate` | Создать новую команду |
-| `TeamDelete` | Удалить команду по завершении |
-| `Agent` | Запустить участников, вступающих в команду |
-| `TaskCreate` / `TaskUpdate` / `TaskList` | Управление общим списком задач |
+- Ваш обычный текстовый вывод ассистента НЕ передаётся сокомандникам. Если вы хотите, чтобы другой агент что-то увидел, это должно пройти через `SendMessage`. Это самая частая ошибка в командных рабочих процессах.
+- Рассылка (`to: "*"`) дорога — она будит каждого сокомандника и расходует его контекст. Резервируйте её для объявлений, которые действительно касаются всех. Предпочитайте адресные отправки.
+- Держите сообщения лаконичными и ориентированными на действие. Включайте пути файлов, ограничения и ожидаемый формат ответа, которые нужны получателю; помните, у них нет общей с вами памяти.
+- Объекты протокольных сообщений (`shutdown_response`, `plan_approval_response`) имеют фиксированную форму. Не смешивайте протокольные поля с текстовыми сообщениями и наоборот.
+- Сообщения асинхронны. Получатель увидит ваше на следующем ходу; не предполагайте, что он прочитал или подействовал на него, пока не ответит.
+- Хорошо написанный `summary` делает журнал активности команды легко сканируемым для лидера — относитесь к нему как к строке темы коммита.

package/concepts/ru/Tool-Skill.md

@@ -1,56 +1,47 @@
 # Skill
 
-## Определение
+Вызывает именованный навык внутри текущего разговора. Навыки — это упакованные комплекты возможностей: предметные знания, рабочие процессы и иногда доступ к инструментам, — которые каркас предоставляет ассистенту через системные напоминания.
 
-Выполняет навык (skill) в основном диалоге. Навыки — это специализированные возможности, которые пользователь может вызывать через slash command (например, `/commit`, `/review-pr`).
+## Когда использовать
 
-## Параметры
+- Пользователь вводит слэш-команду, такую как `/review` или `/init` — слэш-команды являются навыками и должны выполняться через этот инструмент.
+- Пользователь описывает задачу, которая соответствует условиям срабатывания объявленного навыка (например, просьба просканировать транскрипты на повторяющиеся запросы разрешений соответствует `fewer-permission-prompts`).
+- Заявленная цель навыка напрямую соответствует текущему файлу, запросу или контексту разговора.
+- Специализированные повторяемые рабочие процессы доступны как навыки, и канонической процедуре предпочтение перед ad-hoc подходом.
+- Пользователь спрашивает «какие навыки доступны» — перечислите объявленные имена, и вызывайте, только когда он подтвердит.
 
-| Параметр | Тип | Обязательный | Описание |
-|------|------|------|------|
-| `skill` | string | Да | Название навыка (например, "commit", "review-pr", "pdf") |
-| `args` | string | Нет | Аргументы навыка |
+## Параметры
 
-## Сценарии использования
+- `skill` (string, обязательный): точное имя навыка, перечисленного в текущем системном напоминании о доступных навыках. Для навыков с неймспейсом плагина используйте полностью квалифицированную форму `plugin:skill` (например, `skill-creator:skill-creator`). Не включайте ведущий слэш.
+- `args` (string, необязательный): аргументы в свободной форме, передаваемые навыку. Формат и семантика определяются документацией каждого конкретного навыка.
 
-**Подходящее применение:**
-- Пользователь ввёл slash command в формате `/<skill-name>`
-- Запрос пользователя соответствует функциональности зарегистрированного навыка
+## Примеры
 
-**Неподходящее применение:**
-- Встроенные команды CLI (например, `/help`, `/clear`)
-- Навык уже выполняется
-- Название навыка отсутствует в списке доступных навыков
+### Пример 1: запуск навыка review на текущей ветке
 
-## Примечания
+```
+Skill(skill="review")
+```
 
-- После вызова навык разворачивается в полный prompt
-- Поддерживает полностью квалифицированные имена (например, `ms-office-suite:pdf`)
-- Список доступных навыков предоставляется в сообщениях system-reminder
-- Когда виден тег `<command-name>`, это означает, что навык загружен — следует выполнить его напрямую, а не вызывать этот инструмент повторно
-- Не упоминайте навык без фактического вызова инструмента
+Навык `review` упаковывает шаги ревью pull request относительно текущей базовой ветки. Его вызов загружает определённую каркасом процедуру ревью в ход.
 
-## Оригинальный текст
+### Пример 2: вызов навыка из неймспейса плагина с аргументами
 
-<textarea readonly>Execute a skill within the main conversation
+```
+Skill(
+  skill="skill-creator:skill-creator",
+  args="create a skill that summarizes git log for a given date range"
+)
+```
 
-When users ask you to perform tasks, check if any of the available skills match. Skills provide specialized capabilities and domain knowledge.
+Маршрутизирует запрос через точку входа плагина `skill-creator`, чтобы запустился рабочий процесс авторинга.
 
-When users reference a "slash command" or "/<something>" (e.g., "/commit", "/review-pr"), they are referring to a skill. Use this tool to invoke it.
-
-How to invoke:
-- Use this tool with the skill name and optional arguments
-- Examples:
-  - `skill: "pdf"` - invoke the pdf skill
-  - `skill: "commit", args: "-m 'Fix bug'"` - invoke with arguments
-  - `skill: "review-pr", args: "123"` - invoke with arguments
-  - `skill: "ms-office-suite:pdf"` - invoke using fully qualified name
+## Примечания
 
-Important:
-- Available skills are listed in system-reminder messages in the conversation
-- When a skill matches the user's request, this is a BLOCKING REQUIREMENT: invoke the relevant Skill tool BEFORE generating any other response about the task
-- NEVER mention a skill without actually calling this tool
-- Do not invoke a skill that is already running
-- Do not use this tool for built-in CLI commands (like /help, /clear, etc.)
-- If you see a <command-name> tag in the current conversation turn, the skill has ALREADY been loaded - follow the instructions directly instead of calling this tool again
-</textarea>
+- Вызывайте только навыки, чьи имена дословно появляются в системном напоминании о доступных навыках, либо навыки, которые пользователь ввёл напрямую как `/name` в своём сообщении. Никогда не угадывайте и не изобретайте имена навыков из памяти или обучающих данных — если навык не объявлен, не вызывайте этот инструмент.
+- Когда запрос пользователя соответствует объявленному навыку, вызов `Skill` — это блокирующий предварительный шаг: вызывайте его до генерации любого другого ответа о задаче. Не описывайте, что сделал бы навык — запускайте его.
+- Никогда не упоминайте навык по имени, не вызывая его фактически. Анонсирование навыка без вызова инструмента вводит в заблуждение.
+- Не используйте `Skill` для встроенных CLI-команд, таких как `/help`, `/clear`, `/model` или `/exit`. Они обрабатываются каркасом напрямую.
+- Не вызывайте повторно навык, уже запущенный в текущем ходу. Если вы видите тег `<command-name>` в текущем ходу, навык уже загружен — следуйте его инструкциям на месте, а не вызывайте инструмент снова.
+- Если применимы несколько навыков, выбирайте наиболее специфичный. Для изменений конфигурации, таких как добавление разрешений или хуков, предпочитайте `update-config` общему подходу через настройки.
+- Выполнение навыка может ввести новые системные напоминания, инструменты или ограничения на остаток хода. Перечитайте состояние разговора после завершения навыка, прежде чем продолжать.

package/concepts/ru/Tool-TaskCreate.md

@@ -1,78 +1,56 @@
 # TaskCreate
 
-## Определение
+Создаёт новую задачу в списке задач текущей команды (или в списке задач сессии, когда команда не активна). Используйте, чтобы фиксировать рабочие пункты, которые нужно отслеживать, делегировать или вернуться к ним позже.
 
-Создаёт структурированную запись в списке задач для отслеживания прогресса, организации сложных задач и демонстрации пользователю хода работы.
+## Когда использовать
 
-## Параметры
-
-| Параметр | Тип | Обязательный | Описание |
-|------|------|------|------|
-| `subject` | string | Да | Краткий заголовок задачи в повелительном наклонении (например, "Fix authentication bug") |
-| `description` | string | Да | Подробное описание, включающее контекст и критерии приёмки |
-| `activeForm` | string | Нет | Текст в настоящем продолженном времени, отображаемый во время выполнения (например, "Fixing authentication bug") |
-| `metadata` | object | Нет | Произвольные метаданные, прикреплённые к задаче |
-
-## Сценарии использования
-
-**Подходящее применение:**
-- Сложные многоэтапные задачи (более 3 шагов)
-- Пользователь предоставил несколько элементов для выполнения
-- Отслеживание работы в режиме планирования
-- Пользователь явно попросил использовать список todo
-
-**Неподходящее применение:**
-- Одиночная простая задача
-- Простые операции менее чем в 3 шага
-- Чистый диалог или информационный запрос
+- Пользователь описывает многошаговую работу, которая выигрывает от явного отслеживания.
+- Вы разбиваете большой запрос на меньшие, отдельно завершаемые единицы.
+- По ходу задачи обнаружен follow-up, который не должен быть забыт.
+- Нужна долговременная запись намерения перед передачей работы сокоманднику или подагенту.
+- Вы работаете в режиме планирования и хотите, чтобы каждый шаг плана был представлен конкретной задачей.
 
-## Примечания
-
-- Все вновь созданные задачи имеют начальный статус `pending`
-- `subject` использует повелительное наклонение ("Run tests"), `activeForm` — настоящее продолженное время ("Running tests")
-- После создания задачи можно установить зависимости (blocks/blockedBy) через TaskUpdate
-- Перед созданием следует вызвать TaskList для проверки на дубликаты
-
-## Оригинальный текст
+Пропускайте `TaskCreate` для тривиальных одноразовых действий, чистой беседы или всего, что выполнимо за два-три прямых вызова инструментов.
 
-<textarea readonly>Use this tool to create a structured task list for your current coding session. This helps you track progress, organize complex tasks, and demonstrate thoroughness to the user.
-It also helps the user understand the progress of the task and overall progress of their requests.
+## Параметры
 
-## When to Use This Tool
+- `subject` (string, обязательный): короткий императивный заголовок, например `Fix login redirect on Safari`. Держите примерно до восьмидесяти символов.
+- `description` (string, обязательный): подробный контекст — проблема, ограничения, критерии приёмки и любые файлы или ссылки, которые понадобятся будущему читателю. Пишите так, будто сокомандник возьмёт это с чистого листа.
+- `activeForm` (string, необязательный): текст-спиннер в настоящем продолженном времени, показываемый, пока задача `in_progress`, например `Fixing login redirect on Safari`. Отражайте `subject`, но в форме на -ing.
+- `metadata` (object, необязательный): произвольные структурированные данные, прикреплённые к задаче. Частые применения: метки, подсказки о приоритете, внешние идентификаторы тикетов или конфигурация, специфичная для агента.
 
-Use this tool proactively in these scenarios:
+Вновь созданные задачи всегда стартуют со статусом `pending` и без владельца. Зависимости (`blocks`, `blockedBy`) не устанавливаются во время создания — применяйте их позже через `TaskUpdate`.
 
-- Complex multi-step tasks - When a task requires 3 or more distinct steps or actions
-- Non-trivial and complex tasks - Tasks that require careful planning or multiple operations
-- Plan mode - When using plan mode, create a task list to track the work
-- User explicitly requests todo list - When the user directly asks you to use the todo list
-- User provides multiple tasks - When users provide a list of things to be done (numbered or comma-separated)
-- After receiving new instructions - Immediately capture user requirements as tasks
-- When you start working on a task - Mark it as in_progress BEFORE beginning work
-- After completing a task - Mark it as completed and add any new follow-up tasks discovered during implementation
+## Примеры
 
-## When NOT to Use This Tool
+### Пример 1
 
-Skip using this tool when:
-- There is only a single, straightforward task
-- The task is trivial and tracking it provides no organizational benefit
-- The task can be completed in less than 3 trivial steps
-- The task is purely conversational or informational
+Зафиксировать баг-репорт, который только что подал пользователь.
 
-NOTE that you should not use this tool if there is only one trivial task to do. In this case you are better off just doing the task directly.
+```
+TaskCreate(
+  subject: "Repair broken PDF export on Windows",
+  description: "Users on Windows 11 report the export button produces a 0-byte file. Reproduce with sample doc in test/fixtures/export/, then fix the code path in src/export/pdf.ts. Acceptance: export writes a valid PDF and the existing export test suite passes.",
+  activeForm: "Repairing broken PDF export on Windows"
+)
+```
 
-## Task Fields
+### Пример 2
 
-- **subject**: A brief, actionable title in imperative form (e.g., "Fix authentication bug in login flow")
-- **description**: Detailed description of what needs to be done, including context and acceptance criteria
-- **activeForm**: Present continuous form shown in spinner when task is in_progress (e.g., "Fixing authentication bug"). This is displayed to the user while you work on the task.
+Разбить эпик на отслеживаемые единицы в начале сессии.
 
-**IMPORTANT**: Always provide activeForm when creating tasks. The subject should be imperative ("Run tests") while activeForm should be present continuous ("Running tests"). All tasks are created with status `pending`.
+```
+TaskCreate(
+  subject: "Draft migration plan for auth service",
+  description: "Produce a written plan covering rollout stages, rollback strategy, and monitoring. Output: docs/auth-migration.md.",
+  activeForm: "Drafting migration plan for auth service",
+  metadata: { "priority": "P1", "linearId": "AUTH-214" }
+)
+```
 
-## Tips
+## Примечания
 
-- Create tasks with clear, specific subjects that describe the outcome
-- Include enough detail in the description for another agent to understand and complete the task
-- After creating tasks, use TaskUpdate to set up dependencies (blocks/blockedBy) if needed
-- Check TaskList first to avoid creating duplicate tasks
-</textarea>
+- Пишите `subject` в повелительном наклонении, а `activeForm` — в настоящем продолженном, чтобы UI читался естественно, когда задача переходит в `in_progress`.
+- Вызывайте `TaskList` перед созданием, чтобы избежать дубликатов — список команды общий с сокомандниками и подагентами.
+- Не включайте секреты или учётные данные в `description` или `metadata`; записи задач видны всем с доступом к команде.
+- После создания перемещайте задачу по её жизненному циклу через `TaskUpdate`. Не оставляйте работу молча брошенной в `in_progress`.

package/concepts/ru/Tool-TaskGet.md

@@ -1,56 +1,47 @@
 # TaskGet
 
-## Определение
+Забирает полную запись одной задачи по ID, включая её описание, текущий статус, владельца, метаданные и рёбра зависимостей. Используйте, когда сводки, возвращаемой `TaskList`, недостаточно для действия по задаче.
 
-Получает полные детали задачи по её ID.
+## Когда использовать
 
-## Параметры
-
-| Параметр | Тип | Обязательный | Описание |
-|------|------|------|------|
-| `taskId` | string | Да | ID задачи для получения |
-
-## Возвращаемое содержимое
+- Вы подхватили задачу из `TaskList` и нужно полное описание перед началом работы.
+- Вы собираетесь пометить задачу `completed` и хотите перепроверить критерии приёмки.
+- Нужно инспектировать, какие задачи эта блокирует (`blocks`) или чем заблокирована (`blockedBy`), чтобы решить следующий шаг.
+- Вы расследуете историю — кто владеет, какие метаданные прикреплены, когда она меняла состояние.
+- Сокомандник или прежняя сессия сослались на ID задачи, и вам нужен контекст.
 
-- `subject` — заголовок задачи
-- `description` — подробные требования и контекст
-- `status` — статус: `pending`, `in_progress` или `completed`
-- `blocks` — список задач, заблокированных этой задачей
-- `blockedBy` — список предшествующих задач, блокирующих эту задачу
+Предпочитайте `TaskList`, когда нужен лишь общий обзор; резервируйте `TaskGet` для конкретной записи, которую вы собираетесь читать внимательно или модифицировать.
 
-## Сценарии использования
+## Параметры
 
-**Подходящее применение:**
-- Получение полного описания и контекста задачи перед началом работы
-- Понимание зависимостей задачи
-- Получение полных требований после назначения задачи
+- `taskId` (string, обязательный): идентификатор задачи, возвращённый `TaskCreate` или `TaskList`. ID стабильны на всё время жизни задачи.
 
-## Примечания
+## Примеры
 
-- После получения задачи следует проверить, пуст ли список `blockedBy`, прежде чем начинать работу
-- Используйте TaskList для просмотра сводки всех задач
+### Пример 1
 
-## Оригинальный текст
+Посмотреть задачу, только что увиденную в списке.
 
-<textarea readonly>Use this tool to retrieve a task by its ID from the task list.
+```
+TaskGet(taskId: "t_01HXYZ...")
+```
 
-## When to Use This Tool
+Типичные поля ответа: `id`, `subject`, `description`, `activeForm`, `status`, `owner`, `blocks`, `blockedBy`, `metadata`, `createdAt`, `updatedAt`.
 
-- When you need the full description and context before starting work on a task
-- To understand task dependencies (what it blocks, what blocks it)
-- After being assigned a task, to get complete requirements
+### Пример 2
 
-## Output
+Разрешить зависимости перед началом.
 
-Returns full task details:
-- **subject**: Task title
-- **description**: Detailed requirements and context
-- **status**: 'pending', 'in_progress', or 'completed'
-- **blocks**: Tasks waiting on this one to complete
-- **blockedBy**: Tasks that must complete before this one can start
+```
+TaskGet(taskId: "t_01HXYZ...")
+# Inspect blockedBy — if any referenced task is still pending
+# or in_progress, work on the blocker first.
+```
 
-## Tips
+## Примечания
 
-- After fetching a task, verify its blockedBy list is empty before beginning work.
-- Use TaskList to see all tasks in summary form.
-</textarea>
+- `TaskGet` работает только на чтение и безопасен для повторных вызовов; он не меняет статус или владение.
+- Если `blockedBy` непустой и содержит задачи, не являющиеся `completed`, не начинайте эту задачу — сначала разрешите блокеры (или скоординируйтесь с их владельцем).
+- Поле `description` может быть длинным. Прочитайте его полностью перед действием; беглый просмотр ведёт к пропущенным критериям приёмки.
+- Неизвестный или удалённый `taskId` возвращает ошибку. Перезапустите `TaskList`, чтобы выбрать актуальный ID.
+- Если вы собираетесь править задачу, сначала вызовите `TaskGet`, чтобы не перезаписать поля, которые только что изменил сокомандник.

package/concepts/ru/Tool-TaskList.md

@@ -1,56 +1,62 @@
 # TaskList
 
-## Определение
+Возвращает каждую задачу в текущей команде (или сессии) в обобщённой форме. Используйте, чтобы обозреть невыполненную работу, решить, что взять следующим, и избежать создания дубликатов.
 
-Отображает список всех задач в списке задач, позволяя просмотреть общий прогресс и доступную работу.
+## Когда использовать
+
+- В начале сессии, чтобы увидеть, что уже отслеживается.
+- Перед вызовом `TaskCreate`, чтобы подтвердить, что работа ещё не зафиксирована.
+- При выборе, какую задачу взять следующей как сокомандник или подагент.
+- Для быстрой проверки зависимостей между задачами команды.
+- Периодически во время длинных сессий для ре-синхронизации с сокомандниками, которые могли взять, завершить или добавить задачи.
+
+`TaskList` работает только на чтение и дёшев; вызывайте свободно, когда нужен обзор.
 
 ## Параметры
 
-Без параметров.
+`TaskList` не принимает параметров. Всегда возвращает полный набор задач активного контекста.
 
-## Возвращаемое содержимое
+## Форма ответа
 
-Сводка по каждой задаче:
-- `id` — идентификатор задачи
-- `subject` — краткое описание
-- `status` — статус: `pending`, `in_progress` или `completed`
-- `owner` — ответственный (ID агента), пустое означает не назначено
-- `blockedBy` — список ID незавершённых задач, блокирующих эту задачу
+Каждая задача в списке — сводка, а не полная запись. Ожидайте примерно:
 
-## Сценарии использования
+- `id` — стабильный идентификатор для `TaskGet` / `TaskUpdate`.
+- `subject` — короткий императивный заголовок.
+- `status` — один из `pending`, `in_progress`, `completed`, `deleted`.
+- `owner` — handle агента или сокомандника, либо пусто, если задача невостребована.
+- `blockedBy` — массив ID задач, которые должны завершиться первыми.
 
-**Подходящее применение:**
-- Просмотр доступных задач (статус pending, без owner, не заблокированы)
-- Проверка общего прогресса проекта
-- Поиск заблокированных задач
-- Поиск следующей задачи после завершения текущей
+За полным описанием, критериями приёмки или метаданными конкретной задачи обращайтесь через `TaskGet`.
 
-## Примечания
+## Примеры
 
-- Предпочитайте обработку задач в порядке ID (наименьший ID первым), так как ранние задачи обычно предоставляют контекст для последующих
-- Задачи с `blockedBy` не могут быть взяты до снятия зависимости
-- Используйте TaskGet для получения полных деталей конкретной задачи
+### Пример 1
 
-## Оригинальный текст
+Быстрая проверка статуса.
 
-<textarea readonly>Use this tool to list all tasks in the task list.
+```
+TaskList()
+```
 
-## When to Use This Tool
+Просмотрите вывод на предмет `in_progress` без `owner` (застарелая работа) и `pending` с пустым `blockedBy` (готова к взятию).
 
-- To see what tasks are available to work on (status: 'pending', no owner, not blocked)
-- To check overall progress on the project
-- To find tasks that are blocked and need dependencies resolved
-- After completing a task, to check for newly unblocked work or claim the next available task
-- **Prefer working on tasks in ID order** (lowest ID first) when multiple tasks are available, as earlier tasks often set up context for later ones
+### Пример 2
 
-## Output
+Сокомандник выбирает следующую задачу.
 
-Returns a summary of each task:
-- **id**: Task identifier (use with TaskGet, TaskUpdate)
-- **subject**: Brief description of the task
-- **status**: 'pending', 'in_progress', or 'completed'
-- **owner**: Agent ID if assigned, empty if available
-- **blockedBy**: List of open task IDs that must be resolved first (tasks with blockedBy cannot be claimed until dependencies resolve)
+```
+TaskList()
+# Filter to: status == pending AND blockedBy is empty AND owner is empty.
+# Among those, prefer the lower ID (tasks are typically numbered in
+# creation order, so lower IDs are older and usually higher priority).
+TaskGet(taskId: "<chosen id>")
+TaskUpdate(taskId: "<chosen id>", status: "in_progress", owner: "<your handle>")
+```
+
+## Примечания
 
-Use TaskGet with a specific task ID to view full details including description and comments.
-</textarea>
+- Эвристика сокомандника: когда несколько задач `pending` разблокированы и без владельца, берите с наименьшим ID. Это сохраняет FIFO и предотвращает захват двумя агентами одной и той же заметной задачи.
+- Уважайте `blockedBy`: не начинайте задачу, чьи блокеры ещё `pending` или `in_progress`. Сначала обработайте блокер или скоординируйтесь с его владельцем.
+- `TaskList` — единственный механизм обнаружения задач. Поиска нет; если список длинный, сканируйте структурно (по статусу, затем по владельцу).
+- Удалённые задачи могут по-прежнему появляться в списке со статусом `deleted` для отслеживания. Игнорируйте их для планирования.
+- Список отражает живое состояние команды, поэтому сокомандники могут добавлять или брать задачи между вызовами. Перелистайте перед взятием, если прошло время.

package/concepts/ru/Tool-TaskOutput.md

@@ -1,40 +1,50 @@
 # TaskOutput
 
-## Определение
+Забирает накопленный вывод запущенной или завершённой фоновой задачи — фоновой shell-команды, локального агента или удалённой сессии. Используйте, когда нужно осмотреть, что произвела долго идущая задача на данный момент.
 
-Получает вывод работающей или завершённой фоновой задачи. Применимо к фоновым оболочкам, асинхронным агентам и удалённым сессиям.
+## Когда использовать
+
+- Удалённая сессия (например, облачная песочница) выполняется, и нужен её stdout.
+- Локальный агент был запущен в фоне, и вы хотите частичный прогресс до его возврата.
+- Фоновая shell-команда работает достаточно долго, и вы хотите проверить её, не останавливая.
+- Нужно подтвердить, что фоновая задача действительно продвигается, прежде чем ждать дальше или вызывать `TaskStop`.
+
+Не тянитесь к `TaskOutput` рефлекторно. Для большинства фоновой работы есть более прямой путь — см. примечания ниже.
 
 ## Параметры
 
-| Параметр | Тип | Обязательный | Описание |
-|------|------|------|------|
-| `task_id` | string | Да | ID задачи |
-| `block` | boolean | Да | Блокировать ли до завершения задачи, по умолчанию `true` |
-| `timeout` | number | Да | Максимальное время ожидания (миллисекунды), по умолчанию 30000, макс. 600000 |
+- `task_id` (string, обязательный): идентификатор задачи, возвращённый при старте фоновой работы. Не то же, что `taskId` из списка задач; это runtime-handle конкретного выполнения.
+- `block` (boolean, необязательный): если `true` (по умолчанию), ждать, пока задача не произведёт новый вывод или не завершится, прежде чем вернуть. Если `false`, возвращает немедленно с тем, что есть в буфере.
+- `timeout` (number, необязательный): максимальное число миллисекунд блокировки перед возвратом. Имеет значение только когда `block` равен `true`. По умолчанию `30000`, максимум `600000`.
 
-## Сценарии использования
+## Примеры
 
-**Подходящее применение:**
-- Проверка прогресса фонового агента, запущенного через Task (`run_in_background: true`)
-- Получение результатов команд Bash, запущенных в фоне
-- Ожидание завершения асинхронной задачи и получение вывода
+### Пример 1
 
-**Неподходящее применение:**
-- Задачи переднего плана — задачи переднего плана возвращают результат напрямую, этот инструмент не нужен
+Подсмотреть в удалённую сессию без блокировки.
 
-## Примечания
+```
+TaskOutput(task_id: "sess_01HXYZ...", block: false)
+```
+
+Возвращает всё, что было выведено в stdout/stderr с момента старта задачи (или с последнего вызова `TaskOutput`, в зависимости от runtime).
 
-- `block: true` блокирует до завершения задачи или истечения тайм-аута
-- `block: false` используется для неблокирующей проверки текущего состояния
-- ID задачи можно найти через команду `/tasks`
-- Применимо ко всем типам задач: фоновые оболочки, асинхронные агенты, удалённые сессии
+### Пример 2
 
-## Оригинальный текст
+Коротко подождать, пока локальный агент выдаст больше вывода.
+
+```
+TaskOutput(
+  task_id: "agent_01ABCD...",
+  block: true,
+  timeout: 10000
+)
+```
+
+## Примечания
 
-<textarea readonly>- Retrieves output from a running or completed task (background shell, agent, or remote session)
-- Takes a task_id parameter identifying the task
-- Returns the task output along with status information
-- Use block=true (default) to wait for task completion
-- Use block=false for non-blocking check of current status
-- Task IDs can be found using the /tasks command
-- Works with all task types: background shells, async agents, and remote sessions</textarea>
+- Фоновые bash-команды: `TaskOutput` фактически устарел для этого случая. Когда вы стартуете фоновую shell-задачу, результат уже включает путь к её файлу вывода — читайте этот путь напрямую инструментом `Read`. `Read` даёт вам случайный доступ, смещения по строкам и стабильный вид; `TaskOutput` — нет.
+- Локальные агенты (инструмент `Agent`, запущенный в фоне): когда агент завершится, результат инструмента `Agent` уже содержит его финальный ответ. Используйте его напрямую. Не читайте файл-символическую ссылку с транскриптом — он содержит полный поток tool-call и переполнит окно контекста.
+- Удалённые сессии: `TaskOutput` — правильный и часто единственный способ стримить вывод. Предпочитайте `block: true` со скромным `timeout` вместо плотных циклов опроса.
+- Неизвестный `task_id` или задача, чей вывод был собран сборщиком мусора, возвращает ошибку. Перезапустите работу, если она всё ещё нужна.
+- `TaskOutput` не останавливает задачу. Для завершения используйте `TaskStop`.