cc-viewer 1.6.182 → 1.6.183

package/concepts/ru/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` передаёт только дифф, что быстрее, безопаснее и легче для ревью.
+- Не создавайте проактивно Markdown-документацию, `README.md` или файлы чейнджлога, если пользователь явно об этом не просит.
+- Не добавляйте эмодзи, маркетинговые формулировки или декоративные баннеры, если пользователь не запросил такой стиль.
+- Сначала убедитесь, что родительский каталог существует, вызовом `ls` через `Bash`; `Write` не создаёт промежуточные папки.
+- Предоставляйте содержимое ровно в том виде, в каком хотите сохранить; шаблонизации или постобработки нет.

package/concepts/ru/Tool-executeCode.md

@@ -1,41 +1,47 @@
-# executeCode (mcp__ide__executeCode)
+# executeCode
 
-## Определение
+Выполняет фрагмент кода внутри живого ядра или песочницы, предоставляемых IDE-интеграцией (например, ядра Jupyter, привязанного к открытому блокноту). Инструмент присутствует только тогда, когда Claude Code запущен вместе с совместимым IDE-мостом, таким как расширение VS Code с выбранным ядром Jupyter.
 
-Выполняет код Python в ядре Jupyter текущего файла notebook.
+## Когда использовать
+
+- Запуск быстрого вычисления, инспекции данных или графика против состояния, уже загруженного в активном ядре Jupyter.
+- Валидация фрагмента кода перед вставкой в ячейку блокнота.
+- Исследование dataframe, переменной или модели в памяти, которая существует в ядре, но не сериализована на диск.
+- Производство графика или численного результата, который пользователь хочет отрендерить inline в 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, состояние сохраняется между вызовами
-- Если пользователь явно не просит, следует избегать объявления переменных или изменения состояния ядра
-- После перезапуска ядра состояние теряется
-
-## Оригинальный текст
-
-<textarea readonly>Execute python code in the Jupyter kernel for the current notebook file.
-    
-    All code will be executed in the current Jupyter kernel.
-    
-    Avoid declaring variables or modifying the state of the kernel unless the user
-    explicitly asks for it.
-    
-    Any code executed will persist across calls to this tool, unless the kernel
-    has been restarted.</textarea>
+- `executeCode` — инструмент IDE-моста. Он недоступен в обычных терминальных сессиях Claude Code; появляется только когда сессия подключена к IDE, экспонирующей ядро (например, расширение VS Code Jupyter).
+- Состояние сохраняется в ядре. Переменные, определённые одним вызовом `executeCode`, остаются видимы последующим вызовам, ячейкам блокнота и пользователю — помните о побочных эффектах.
+- Долго идущий или блокирующий код блокирует ядро. Держите фрагменты короткими; для многоминутной работы напишите настоящий скрипт и запускайте через `Bash`.
+- Вывод (stdout, возвращаемые значения, изображения) возвращается в сессию. Очень большие выводы могут усекаться IDE-мостом.
+- Для правок файлов предпочитайте `Edit`, `Write` или `NotebookEdit` — `executeCode` не заменяет авторинг исходных файлов.

package/concepts/ru/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/ru/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/th/Tool-Agent.md

@@ -1,125 +1,60 @@
 # Agent
 
-## คำจำกัดความ
+สร้าง subagent ของ Claude Code แบบอัตโนมัติที่มี context window เป็นของตัวเองเพื่อจัดการงานเฉพาะทางและส่งผลลัพธ์รวมกลับมาเป็นก้อนเดียว นี่คือกลไกมาตรฐานสำหรับการมอบหมายงานวิจัยแบบเปิดกว้าง งานที่ทำขนานกัน หรือการทำงานร่วมกันเป็นทีม
 
-เริ่มต้น sub-agent (SubAgent) เพื่อจัดการงานหลายขั้นตอนที่ซับซ้อนอย่างอิสระ Sub-agent เป็นกระบวนการย่อยอิสระ แต่ละตัวมีชุดเครื่องมือและบริบทเฉพาะของตัวเอง Agent เป็นเวอร์ชันเปลี่ยนชื่อของเครื่องมือ Task ใน Claude Code เวอร์ชันใหม่
+## เมื่อใดควรใช้
 
-## พารามิเตอร์
-
-| พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย |
-|------|------|------|------|
-| `prompt` | string | ใช่ | คำอธิบายงานที่ sub-agent จะดำเนินการ |
-| `description` | string | ใช่ | สรุปสั้น 3-5 คำ |
-| `subagent_type` | string | ใช่ | ประเภท sub-agent กำหนดชุดเครื่องมือที่ใช้ได้ |
-| `model` | enum | ไม่ | ระบุโมเดล (sonnet / opus / haiku) ค่าเริ่มต้นสืบทอดจากพาเรนต์ |
-| `max_turns` | integer | ไม่ | จำนวนรอบ agentic สูงสุด |
-| `run_in_background` | boolean | ไม่ | รันในเบื้องหลังหรือไม่ งานเบื้องหลังส่งคืนพาธ output_file |
-| `resume` | string | ไม่ | ID ของ agent ที่จะกลับมาทำต่อ ดำเนินการต่อจากการรันครั้งก่อน มีประโยชน์สำหรับการกลับมาทำต่อ sub-agent ก่อนหน้าโดยไม่สูญเสียบริบท |
-| `isolation` | enum | ไม่ | โหมดแยกส่วน `worktree` สร้าง git worktree ชั่วคราว |
-
-## ประเภท Sub-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)
-- งานคู่ขนานที่ต้องการสภาพแวดล้อมแยก
-- งานที่ใช้เวลานานที่ต้องรันในเบื้องหลัง
-
-**ไม่เหมาะสำหรับ:**
-- อ่านพาธไฟล์เฉพาะ — ใช้ Read หรือ Glob โดยตรง
-- ค้นหาใน 2-3 ไฟล์ที่รู้จัก — ใช้ Read โดยตรง
-- ค้นหาคำจำกัดความคลาสเฉพาะ — ใช้ Glob โดยตรง
-
-## ข้อควรระวัง
-
-- หลังจากเสร็จสิ้น sub-agent จะส่งคืนข้อความเดียว ผลลัพธ์ไม่ปรากฏให้ผู้ใช้เห็น agent หลักต้องถ่ายทอดให้
-- สามารถเริ่มการเรียก Agent หลายรายการพร้อมกันในข้อความเดียวเพื่อเพิ่มประสิทธิภาพ
-- งานเบื้องหลังตรวจสอบความคืบหน้าผ่านเครื่องมือ TaskOutput
-- ประเภท Explore ช้ากว่าการเรียก Glob/Grep โดยตรง ใช้เฉพาะเมื่อการค้นหาง่ายๆ ไม่เพียงพอ
-- ใช้ `run_in_background: true` สำหรับงานที่ใช้เวลานานและไม่ต้องการผลลัพธ์ทันที ใช้โหมดเบื้องหน้า (ค่าเริ่มต้น) เมื่อต้องการผลลัพธ์ก่อนดำเนินการต่อ
-- พารามิเตอร์ `resume` ช่วยให้สามารถดำเนินการต่อเซสชัน sub-agent ที่เริ่มไว้ก่อนหน้า โดยรักษาบริบทที่สะสมไว้
+- การค้นหาแบบเปิดกว้างที่ยังไม่รู้ว่าไฟล์ใดเกี่ยวข้อง และคาดว่าจะต้องใช้ `Glob`, `Grep`, และ `Read` หลายรอบ
+- งานอิสระแบบขนาน — เรียกใช้ agent หลายตัวในข้อความเดียวเพื่อสำรวจพื้นที่ต่างกันพร้อมกัน
+- แยกการสำรวจที่ยุ่งเหยิงออกจาก conversation หลัก เพื่อให้ context ของ parent กระชับ
+- มอบหมายงานให้ subagent เฉพาะทาง เช่น `Explore`, `Plan`, `claude-code-guide`, หรือ `statusline-setup`
+- Spawn teammate ที่มีชื่อเข้าไปในทีมที่กำลังทำงานอยู่สำหรับการทำงานแบบหลาย agent ที่ประสานกัน
 
-## ข้อความต้นฉบับ
+อย่าใช้เมื่อรู้ไฟล์หรือ symbol เป้าหมายอยู่แล้ว — ให้ใช้ `Read`, `Grep`, หรือ `Glob` โดยตรง การค้นหาแบบ step เดียวผ่าน `Agent` สิ้นเปลือง context window เต็มหน้าต่างและเพิ่ม latency
 
-<textarea readonly>Launch a new agent to handle complex, multi-step tasks autonomously.
-
-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)
-
-When using the Agent tool, you must specify a subagent_type parameter to select which agent type to use.
-
-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
-
-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:
-
-<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>
-
-<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>
+- `description` (string, required): ป้ายสั้น 3–5 คำอธิบายงาน แสดงใน UI และ log
+- `prompt` (string, required): คำสั่งที่สมบูรณ์และเป็นอิสระที่ agent จะรันต้องรวม context ข้อจำกัด และ format ผลลัพธ์ที่คาดหวังทั้งหมด
+- `subagent_type` (string, optional): persona สำเร็จรูป เช่น `general-purpose`, `Explore`, `Plan`, `claude-code-guide`, หรือ `statusline-setup` ค่าเริ่มต้นคือ `general-purpose`
+- `run_in_background` (boolean, optional): ถ้า true, agent จะรันแบบ asynchronous และ parent สามารถทำงานต่อได้ ผลลัพธ์จะรับกลับในภายหลัง
+- `model` (string, optional): เปลี่ยน model สำหรับ agent นี้ — `opus`, `sonnet`, หรือ `haiku` ค่าเริ่มต้นคือ model ของ parent session
+- `isolation` (string, optional): ตั้งค่าเป็น `worktree` เพื่อรัน agent ใน git worktree ที่แยกต่างหาก เพื่อไม่ให้การเขียนไฟล์ชนกับ parent
+- `team_name` (string, optional): เมื่อ spawn เข้าไปในทีมที่มีอยู่แล้ว นี่คือตัวระบุทีมที่ agent จะเข้าร่วม
+- `name` (string, optional): ชื่อ teammate ที่สามารถระบุตำแหน่งได้ภายในทีม ใช้เป็น target `to` สำหรับ `SendMessage`
+
+## ตัวอย่าง
+
+### ตัวอย่างที่ 1: ค้นหาโค้ดแบบเปิดกว้าง
+
+```
+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."
+)
+```
+
+### ตัวอย่างที่ 2: การสืบสวนอิสระแบบขนาน
+
+เรียกใช้ agent สองตัวในข้อความเดียวกัน — ตัวหนึ่งตรวจสอบ build pipeline อีกตัวตรวจสอบ test harness แต่ละตัวได้ context window ของตัวเองและส่ง summary กลับ การ batch ใน tool-call block เดียวจะรันพร้อมกัน
+
+### ตัวอย่างที่ 3: Spawn teammate เข้าไปในทีมที่กำลังรันอยู่
+
+```
+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."
+)
+```
+
+## หมายเหตุ
+
+- Agent ไม่มีความจำของการรันก่อนหน้า ทุกการ invoke เริ่มจากศูนย์ ดังนั้น `prompt` ต้องเป็นอิสระสมบูรณ์ — รวม path ของไฟล์ convention คำถาม และรูปแบบที่แน่นอนของคำตอบที่คุณต้องการกลับมา
+- Agent ส่งข้อความสุดท้ายเพียงข้อความเดียว ไม่สามารถถามเพื่อชี้แจงกลางการรันได้ ดังนั้นความคลุมเครือใน prompt จะกลายเป็นการเดาในผลลัพธ์
+- การรัน agent หลายตัวพร้อมกันจะเร็วกว่าการเรียกแบบตามลำดับอย่างมีนัยสำคัญเมื่อ subtask เป็นอิสระต่อกัน Batch ทั้งหมดใน tool-call block เดียว
+- ใช้ `isolation: "worktree"` เมื่อ agent จะเขียนไฟล์ และคุณต้องการ review การเปลี่ยนแปลงก่อน merge เข้า working tree หลัก
+- ชอบ `subagent_type: "Explore"` สำหรับการสอดแนมแบบ read-only และ `Plan` สำหรับงานออกแบบ `general-purpose` เป็นค่าเริ่มต้นสำหรับงานแบบผสม read/write
+- Background agent (`run_in_background: true`) เหมาะกับงานที่ใช้เวลานาน หลีกเลี่ยงการ poll ใน sleep loop — parent จะได้รับแจ้งเมื่อเสร็จสิ้น

package/concepts/th/Tool-AskUserQuestion.md

@@ -1,75 +1,60 @@
 # AskUserQuestion
 
-## คำจำกัดความ
+แสดงคำถามแบบเลือกตอบหลายตัวเลือกที่มีโครงสร้างหนึ่งคำถามหรือมากกว่าให้ผู้ใช้ใน chat UI รวบรวมตัวเลือกของพวกเขา และส่งกลับไปให้ผู้ช่วย — มีประโยชน์สำหรับการคลายความกำกวมของเจตนาโดยไม่ต้องใช้การโต้ตอบแบบ free-form
 
-ถามคำถามผู้ใช้ระหว่างการดำเนินงาน เพื่อขอคำชี้แจง ตรวจสอบสมมติฐาน หรือขอการตัดสินใจ
+## เมื่อใดควรใช้
 
-## พารามิเตอร์
-
-| พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย |
-|------|------|------|------|
-| `questions` | array | ใช่ | รายการคำถาม (1-4 คำถาม) |
-| `answers` | object | ไม่ | คำตอบที่รวบรวมจากผู้ใช้ |
-| `annotations` | object | ไม่ | หมายเหตุสำหรับแต่ละคำถาม (เช่น บันทึกการแสดงตัวอย่างตัวเลือก) |
-| `metadata` | object | ไม่ | ข้อมูลเมตาสำหรับการติดตามและวิเคราะห์ |
-
-แต่ละอ็อบเจกต์ `question`:
-
-| ฟิลด์ | ประเภท | จำเป็น | คำอธิบาย |
-|------|------|------|------|
-| `question` | string | ใช่ | ข้อความคำถามแบบเต็ม ควรลงท้ายด้วยเครื่องหมายคำถาม |
-| `header` | string | ใช่ | ป้ายกำกับสั้น (สูงสุด 12 ตัวอักษร) แสดงเป็นชิปแท็ก |
-| `options` | array | ใช่ | 2-4 ตัวเลือก |
-| `multiSelect` | boolean | ใช่ | อนุญาตให้เลือกหลายรายการหรือไม่ |
-
-แต่ละอ็อบเจกต์ `option`:
-
-| ฟิลด์ | ประเภท | จำเป็น | คำอธิบาย |
-|------|------|------|------|
-| `label` | string | ใช่ | ข้อความแสดงตัวเลือก (1-5 คำ) |
-| `description` | string | ใช่ | คำอธิบายตัวเลือก |
-| `markdown` | string | ไม่ | เนื้อหาแสดงตัวอย่าง (สำหรับการเปรียบเทียบภาพของเลย์เอาต์ ASCII, โค้ดสนิปเป็ต ฯลฯ) |
-
-## สถานการณ์การใช้งาน
-
-**เหมาะสำหรับ:**
-- รวบรวมความต้องการหรือข้อกำหนดของผู้ใช้
-- ชี้แจงคำสั่งที่คลุมเครือ
-- รับการตัดสินใจระหว่างการดำเนินงาน
-- เสนอทางเลือกทิศทางให้ผู้ใช้
+- คำขอมีการตีความที่สมเหตุสมผลหลายแบบและผู้ช่วยต้องการให้ผู้ใช้เลือกก่อนดำเนินการ
+- ผู้ใช้ต้องเลือกจากตัวเลือกที่เป็นรูปธรรม (framework, library, file path, strategy) ซึ่งการตอบแบบ free-text จะเสี่ยงต่อข้อผิดพลาด
+- คุณต้องการเปรียบเทียบทางเลือกข้างเคียงกันโดยใช้ panel preview
+- การตัดสินใจที่เกี่ยวข้องหลายเรื่องสามารถรวมใน prompt เดียวเพื่อลดการโต้ตอบไปมา
+- แผนหรือ tool call ขึ้นอยู่กับ configuration ที่ผู้ใช้ยังไม่ได้ระบุ
 
-**ไม่เหมาะสำหรับ:**
-- ถามว่า "แผนนี้โอเคไหม?" — ควรใช้ ExitPlanMode
-
-## ข้อควรระวัง
-
-- ผู้ใช้สามารถเลือก "Other" เพื่อให้อินพุตที่กำหนดเองได้เสมอ
-- ตัวเลือกที่แนะนำควรอยู่ในลำดับแรก โดยเพิ่ม "(Recommended)" ที่ท้าย label
-- การแสดงตัวอย่าง `markdown` รองรับเฉพาะคำถามแบบเลือกรายการเดียว
-- ตัวเลือกที่มี `markdown` จะสลับเป็นเลย์เอาต์แบบเคียงข้างกัน
-- ในโหมดวางแผน ใช้เพื่อชี้แจงข้อกำหนดก่อนกำหนดแผน
-
-## ข้อความต้นฉบับ
-
-<textarea readonly>Use this tool when you need to ask the user questions during execution. This allows you to:
-1. Gather user preferences or requirements
-2. Clarify ambiguous instructions
-3. Get decisions on implementation choices as you work
-4. Offer choices to the user about what direction to take.
-
-Usage notes:
-- Users will always be able to select "Other" to provide custom text input
-- Use multiSelect: true to allow multiple answers to be selected for a question
-- If you recommend a specific option, make that the first option in the list and add "(Recommended)" at the end of the label
-
-Plan mode note: In plan mode, use this tool to clarify requirements or choose between approaches BEFORE finalizing your plan. Do NOT use this tool to ask "Is my plan ready?" or "Should I proceed?" - use ExitPlanMode for plan approval. IMPORTANT: Do not reference "the plan" in your questions (e.g., "Do you have feedback about the plan?", "Does the plan look good?") because the user cannot see the plan in the UI until you call ExitPlanMode. If you need plan approval, use ExitPlanMode instead.
-
-Preview feature:
-Use the optional `markdown` field on options when presenting concrete artifacts that users need to visually compare:
-- ASCII mockups of UI layouts or components
-- Code snippets showing different implementations
-- Diagram variations
-- Configuration examples
+## พารามิเตอร์
 
-When any option has a markdown, the UI switches to a side-by-side layout with a vertical option list on the left and preview on the right. Do not use previews for simple preference questions where labels and descriptions suffice. Note: previews are only supported for single-select questions (not multiSelect).
-</textarea>
+- `questions` (array, required): คำถามหนึ่งถึงสี่ข้อที่แสดงร่วมกันใน prompt เดียว แต่ละ object คำถามประกอบด้วย:
+  - `question` (string, required): ข้อความคำถามเต็ม ลงท้ายด้วยเครื่องหมายคำถาม
+  - `header` (string, required): ป้ายสั้น (ไม่เกิน 12 อักขระ) แสดงเป็น chip เหนือคำถาม
+  - `options` (array, required): Option object สองถึงสี่ตัว แต่ละ option มี `label` (1–5 คำ), `description`, และ `markdown` preview แบบ optional
+  - `multiSelect` (boolean, required): เมื่อ `true` ผู้ใช้สามารถเลือกได้มากกว่าหนึ่งตัวเลือก
+
+## ตัวอย่าง
+
+### ตัวอย่างที่ 1: เลือก framework เดียว
+
+```
+AskUserQuestion(questions=[{
+  "header": "Test runner",
+  "question": "Which test runner should I configure?",
+  "multiSelect": false,
+  "options": [
+    {"label": "Vitest (Recommended)", "description": "Fast, Vite-native, Jest-compatible API"},
+    {"label": "Jest",                  "description": "Mature, broadest plugin ecosystem"},
+    {"label": "Node --test",           "description": "Zero dependencies, built in"}
+  ]
+}])
+```
+
+### ตัวอย่างที่ 2: Preview สองเลย์เอาต์เคียงข้างกัน
+
+```
+AskUserQuestion(questions=[{
+  "header": "Layout",
+  "question": "Which dashboard layout do you prefer?",
+  "multiSelect": false,
+  "options": [
+    {"label": "Sidebar",  "description": "Nav on the left", "markdown": "```\n+------+---------+\n| NAV  | CONTENT |\n+------+---------+\n```"},
+    {"label": "Top bar",  "description": "Nav across top",  "markdown": "```\n+-----------------+\n|       NAV       |\n+-----------------+\n|     CONTENT     |\n+-----------------+\n```"}
+  ]
+}])
+```
+
+## หมายเหตุ
+
+- UI จะเพิ่มตัวเลือก free-text "Other" ต่อท้ายทุกคำถามโดยอัตโนมัติ อย่าเพิ่มรายการ "Other", "None", หรือ "Custom" ของคุณเอง — จะไปซ้ำกับทางออกที่มีในตัว
+- จำกัดแต่ละการเรียกระหว่างหนึ่งถึงสี่คำถาม และแต่ละคำถามระหว่างสองถึงสี่ตัวเลือก การเกินขอบเขตนี้จะถูก harness ปฏิเสธ
+- หากคุณแนะนำตัวเลือกเฉพาะ ให้วางไว้อันแรกและเพิ่ม "(Recommended)" ต่อท้าย label เพื่อให้ UI ไฮไลต์เส้นทางที่แนะนำ
+- Preview ผ่านฟิลด์ `markdown` รองรับเฉพาะคำถามแบบเลือกเดียว ใช้สำหรับ artifact แบบมองเห็นได้ เช่น ASCII layout, code snippet, หรือ configuration diff — ไม่ใช้กับคำถามแบบเลือกความชอบธรรมดาที่ label กับ description ก็เพียงพอ
+- เมื่อตัวเลือกใดในคำถามมีค่า `markdown` UI จะสลับเป็นเลย์เอาต์ข้างกัน โดยมีรายการตัวเลือกทางซ้ายและ preview ทางขวา
+- อย่าใช้ `AskUserQuestion` เพื่อถามว่า "แผนนี้ดูโอเคไหม?" — ให้เรียก `ExitPlanMode` แทน ซึ่งมีไว้เพื่อการอนุมัติแผนโดยเฉพาะ ในโหมด plan ก็หลีกเลี่ยงการกล่าวถึง "the plan" ในข้อความคำถามด้วย เพราะแผนยังไม่ปรากฏต่อผู้ใช้จนกว่า `ExitPlanMode` จะรัน
+- อย่าใช้ tool นี้เพื่อขอข้อมูลที่ sensitive หรือ free-form เช่น API key หรือรหัสผ่าน ให้ถามใน chat แทน