cc-viewer 1.2.1 → 1.2.2

package/concepts/uk/CacheRebuild.md

@@ -0,0 +1,40 @@
+# Cache Rebuild (Перебудова кешу)
+
+## Передумови
+
+Механізм prompt caching від Anthropic послідовно об'єднує system → tools → messages (до cache breakpoint) у запиті для формування ключа кешу. Коли ключ кешу повністю збігається з попереднім запитом, API повертає `cache_read_input_tokens` (влучання в кеш); коли ключ кешу змінюється, API створює кеш заново і повертає велику кількість `cache_creation_input_tokens`, тобто відбувається перебудова кешу.
+
+Перебудова кешу означає додаткову тарифікацію токенів (ціна cache creation вища за cache read), тому визначення причини перебудови має пряму цінність для оптимізації витрат.
+
+## Класифікація причин перебудови кешу
+
+cc-viewer порівнює тіла двох послідовних запитів MainAgent для точного визначення причини перебудови кешу:
+
+| reason | Значення | Спосіб визначення |
+|--------|----------|-------------------|
+| `ttl` | Кеш протермінувався | З моменту попереднього запиту MainAgent минуло більше 5 хвилин |
+| `system_change` | Зміна system prompt | `JSON.stringify(prev.system) !== JSON.stringify(curr.system)` |
+| `tools_change` | Зміна визначень інструментів | `JSON.stringify(prev.tools) !== JSON.stringify(curr.tools)` |
+| `model_change` | Зміна моделі | `prev.model !== curr.model` |
+| `msg_truncated` | Стек повідомлень обрізано | Кількість messages у поточному запиті менша за попередній, зазвичай спричинено переповненням контекстного вікна |
+| `msg_modified` | Історичні повідомлення змінено | Вміст префіксних повідомлень не збігається (при нормальному додаванні префікс повинен бути ідентичним) |
+| `key_change` | Невідома зміна ключа | Fallback, коли жодна з вищезазначених умов не збігається |
+
+## Пріоритет визначення
+
+1. Спочатку перевіряється часовий інтервал — якщо минуло більше 5 хвилин, одразу визначається як `ttl`, порівняння body не виконується
+2. Потім послідовно перевіряються model, system, tools, messages
+3. Один запит може одночасно мати кілька причин (наприклад, зміна моделі + зміна system prompt), у цьому випадку масив `reasons` містить усі збіги, tooltip відображає їх порядково
+
+## Типові сценарії
+
+- **`ttl`**: Користувач призупинив роботу більш ніж на 5 хвилин і потім продовжив, кеш природно протермінувався
+- **`system_change`**: Claude Code оновив system prompt (наприклад, завантажено новий CLAUDE.md, змінилися project instructions)
+- **`tools_change`**: Підключення/відключення MCP server призвело до зміни списку доступних інструментів
+- **`model_change`**: Користувач змінив модель командою `/model`
+- **`msg_truncated`**: Занадто довга розмова спричинила управління контекстним вікном, Claude Code обрізав ранні повідомлення
+- **`msg_modified`**: Claude Code відредагував історичні повідомлення (наприклад, `/compact` стиснення замінило оригінальні повідомлення зведенням)
+
+## Відображення в cc-viewer
+
+У списку запитів запити з перебудовою кешу позначаються червоним індикатором-крапкою в рядку cache. При наведенні миші відображається tooltip з описом конкретної причини перебудови (підтримується 18 мов).

package/concepts/uk/MainAgent.md

@@ -0,0 +1,30 @@
+# MainAgent
+
+## Визначення
+
+MainAgent — це основний ланцюг запитів Claude Code у стані без agent team. Кожна взаємодія користувача з Claude Code генерує серію API-запитів, серед яких запити MainAgent формують ядро ланцюга розмови — вони несуть повний system prompt, визначення інструментів та історію повідомлень.
+
+## Спосіб ідентифікації
+
+У cc-viewer MainAgent ідентифікується через `req.mainAgent === true` і автоматично позначається `interceptor.js` під час перехоплення запиту.
+
+Умови визначення (повинні виконуватися всі):
+- Тіло запиту містить поле `system` (system prompt)
+- Тіло запиту містить масив `tools` (визначення інструментів)
+- system prompt містить характерний текст "Claude Code"
+
+## Відмінності від SubAgent
+
+| Характеристика | MainAgent | SubAgent |
+|----------------|-----------|----------|
+| system prompt | Повний основний prompt Claude Code | Скорочений prompt для конкретного завдання |
+| Масив tools | Містить усі доступні інструменти | Зазвичай лише кілька інструментів, необхідних для завдання |
+| Історія повідомлень | Накопичує повний контекст розмови | Лише повідомлення, пов'язані з підзавданням |
+| Поведінка кешу | Є prompt caching (5 хвилин TTL) | Зазвичай без кешу або з невеликим кешем |
+
+## Значення в cc-viewer
+
+- **Відстеження кешу**: Стан prompt caching запитів MainAgent безпосередньо впливає на витрати. Моніторинг співвідношення `cache_creation_input_tokens` та `cache_read_input_tokens` дозволяє визначити рівень влучання в кеш
+- **Аналіз втрати кешу**: Коли в запиті MainAgent спостерігається велика кількість cache creation (замість cache read), це означає, що кеш було втрачено та перебудовано; cc-viewer позначає такі запити червоним індикатором-крапкою
+- **Аналіз основного ланцюга**: Послідовність запитів MainAgent відображає повний процес взаємодії користувача з Claude Code і є основними даними для аналізу поведінки сесії
+- **Відновлення сесії**: cc-viewer відновлює вигляд розмови (Chat Mode) через історію повідомлень запитів MainAgent

package/concepts/uk/Tool-AskUserQuestion.md

@@ -0,0 +1,54 @@
+# AskUserQuestion
+
+## Визначення
+
+Використовується для запитань користувачу під час виконання з метою отримання уточнень, перевірки припущень або запиту рішень.
+
+## Параметри
+
+| Параметр | Тип | Обов'язковий | Опис |
+|----------|-----|--------------|------|
+| `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-макетів, фрагментів коду тощо) |
+
+## Сценарії використання
+
+**Підходить для:**
+- Збір уподобань або вимог користувача
+- Уточнення нечітких інструкцій
+- Прийняття рішень під час реалізації
+- Надання користувачу вибору напрямку
+
+**Не підходить для:**
+- Запитання "Чи підходить план?" — слід використовувати ExitPlanMode
+
+## Примітки
+
+- Користувач завжди може вибрати "Other" для надання власного введення
+- Рекомендований варіант розміщується першим, і в кінці label додається "(Recommended)"
+- Попередній перегляд `markdown` підтримується лише для запитань з одиничним вибором
+- Варіанти з `markdown` перемикаються на паралельний макет
+- У режимі планування використовується для уточнення вимог перед визначенням плану
+
+## Значення в cc-viewer
+
+Виклик AskUserQuestion відображається в журналі запитів як `tool_use` content block, що містить визначення запитань та варіантів. Відповідь користувача з'являється в історії повідомлень наступних запитів.

package/concepts/uk/Tool-Bash.md

@@ -0,0 +1,47 @@
+# Bash
+
+## Визначення
+
+Виконує shell-команду з підтримкою необов'язкового налаштування тайм-ауту. Робочий каталог зберігається між командами, але стан shell (змінні середовища тощо) не зберігається.
+
+## Параметри
+
+| Параметр | Тип | Обов'язковий | Опис |
+|----------|-----|--------------|------|
+| `command` | string | Так | Bash-команда для виконання |
+| `description` | string | Ні | Короткий опис команди |
+| `timeout` | number | Ні | Тайм-аут (мілісекунди), максимум 600000, за замовчуванням 120000 |
+| `run_in_background` | boolean | Ні | Чи запускати у фоновому режимі |
+
+## Сценарії використання
+
+**Підходить для:**
+- Операції git (commit, push, branch тощо)
+- Команди менеджерів пакетів npm/yarn
+- Операції docker
+- Команди компіляції та збірки
+- Перегляд вмісту каталогу (`ls`)
+- Інші системні команди, що потребують виконання в shell
+
+**Не підходить для:**
+- Читання файлів — слід використовувати Read
+- Пошук за іменем файлу — слід використовувати Glob
+- Пошук вмісту файлів — слід використовувати Grep
+- Редагування файлів — слід використовувати Edit
+- Запис файлів — слід використовувати Write
+- Виведення інформації користувачу — виводити безпосередньо в тексті відповіді
+- Довготривалі процеси (dev server, режим watch) — рекомендується запускати вручну
+
+## Примітки
+
+- Шляхи з пробілами повинні бути обгорнуті подвійними лапками
+- Вивід понад 30000 символів буде обрізано
+- Результати фонових команд отримуються через TaskOutput
+- Бажано використовувати абсолютні шляхи, уникаючи `cd`
+- Незалежні команди можна викликати паралельно кількома Bash-викликами
+- Залежні команди з'єднуються через `&&`
+- Середовище shell ініціалізується з профілю користувача (bash або zsh)
+
+## Значення в cc-viewer
+
+Виклики Bash відображаються в журналі запитів як пара content block `tool_use` (містить команду) та `tool_result` (містить вивід). Вивід виконання команди може використовуватися для аналізу операційної поведінки моделі.

package/concepts/uk/Tool-Edit.md

@@ -0,0 +1,38 @@
+# Edit
+
+## Визначення
+
+Редагує файл через точну заміну рядків. Замінює `old_string` на `new_string` у файлі.
+
+## Параметри
+
+| Параметр | Тип | Обов'язковий | Опис |
+|----------|-----|--------------|------|
+| `file_path` | string | Так | Абсолютний шлях до файлу для зміни |
+| `old_string` | string | Так | Оригінальний текст для заміни |
+| `new_string` | string | Так | Новий текст після заміни (повинен відрізнятися від old_string) |
+| `replace_all` | boolean | Ні | Чи замінювати всі збіги, за замовчуванням `false` |
+
+## Сценарії використання
+
+**Підходить для:**
+- Зміна конкретних ділянок коду в існуючому файлі
+- Виправлення помилок, оновлення логіки
+- Перейменування змінних (у поєднанні з `replace_all: true`)
+- Будь-які сценарії, що потребують точної зміни вмісту файлу
+
+**Не підходить для:**
+- Створення нових файлів — слід використовувати Write
+- Масштабне переписування — може знадобитися Write для перезапису всього файлу
+
+## Примітки
+
+- Перед використанням файл повинен бути прочитаний через Read, інакше буде помилка
+- `old_string` повинен бути унікальним у файлі, інакше редагування не вдасться. Якщо не унікальний, надайте більше контексту для забезпечення унікальності або використовуйте `replace_all`
+- При редагуванні тексту необхідно зберігати оригінальний відступ (tab/пробіли), не включайте префікс номера рядка з виводу Read
+- Надавайте перевагу редагуванню існуючих файлів, а не створенню нових
+- `new_string` повинен відрізнятися від `old_string`
+
+## Значення в cc-viewer
+
+Виклики Edit відображаються в журналі запитів як `tool_use` content block, де `input` містить `old_string` та `new_string`, що дозволяє відстежувати, які зміни модель внесла до файлу.

package/concepts/uk/Tool-EnterPlanMode.md

@@ -0,0 +1,43 @@
+# EnterPlanMode
+
+## Визначення
+
+Перемикає Claude Code у режим планування для дослідження кодової бази та проєктування плану перед реалізацією.
+
+## Параметри
+
+Без параметрів.
+
+## Сценарії використання
+
+**Підходить для:**
+- Реалізація нової функціональності — потрібні архітектурні рішення
+- Існує кілька можливих підходів — потрібен вибір користувача
+- Зміна коду впливає на існуючу поведінку або структуру
+- Зміни в кількох файлах — можуть стосуватися 2-3 і більше файлів
+- Вимоги нечіткі — потрібно спочатку дослідити та зрозуміти обсяг
+- Уподобання користувача важливі — реалізація може мати кілька обґрунтованих напрямків
+
+**Не підходить для:**
+- Виправлення одного рядка або кількох рядків (друкарська помилка, очевидний баг)
+- Користувач дав дуже конкретні інструкції
+- Суто дослідницьке/розвідувальне завдання — слід використовувати Task (тип Explore)
+
+## Поведінка в режимі планування
+
+Після входу в режим планування Claude Code:
+1. Використовує інструменти Glob, Grep, Read для глибокого дослідження кодової бази
+2. Розуміє існуючі патерни та архітектуру
+3. Проєктує план реалізації
+4. Подає план на затвердження користувачем
+5. За потреби може використовувати AskUserQuestion для уточнення
+6. Коли план готовий, виходить через ExitPlanMode
+
+## Примітки
+
+- Цей інструмент потребує згоди користувача для входу в режим планування
+- Якщо не впевнені, чи потрібне планування, схиляйтеся до планування — попереднє узгодження краще за переробку
+
+## Значення в cc-viewer
+
+Виклик EnterPlanMode відображається в журналі запитів як `tool_use` content block. Послідовність запитів після входу в режим планування зазвичай складається переважно з дослідницьких викликів інструментів (Glob, Grep, Read) до моменту виклику ExitPlanMode.

package/concepts/uk/Tool-ExitPlanMode.md

@@ -0,0 +1,39 @@
+# ExitPlanMode
+
+## Визначення
+
+Виходить з режиму планування та подає план на затвердження користувачем. Вміст плану зчитується з раніше записаного файлу плану.
+
+## Параметри
+
+| Параметр | Тип | Обов'язковий | Опис |
+|----------|-----|--------------|------|
+| `allowedPrompts` | array | Ні | Список описів дозволів, необхідних для плану реалізації |
+
+Кожен елемент масиву `allowedPrompts`:
+
+| Поле | Тип | Обов'язковий | Опис |
+|------|-----|--------------|------|
+| `tool` | enum | Так | Застосовний інструмент, наразі підтримується лише `Bash` |
+| `prompt` | string | Так | Семантичний опис операції (наприклад, "run tests", "install dependencies") |
+
+## Сценарії використання
+
+**Підходить для:**
+- У режимі планування план завершено, готовий до подання на затвердження користувачем
+- Лише для завдань реалізації, що потребують написання коду
+
+**Не підходить для:**
+- Суто дослідницьке/розвідувальне завдання — не потрібно виходити з режиму планування
+- Запитання користувачу "Чи підходить план?" — це саме функція цього інструменту, не використовуйте AskUserQuestion
+
+## Примітки
+
+- Цей інструмент не приймає вміст плану як параметр — він зчитує з раніше записаного файлу плану
+- Користувач побачить вміст файлу плану для затвердження
+- Не запитуйте "чи підходить план?" через AskUserQuestion перед викликом цього інструменту — це дублювання
+- Не згадуйте "план" у запитаннях, оскільки користувач не бачить вміст плану до ExitPlanMode
+
+## Значення в cc-viewer
+
+Виклик ExitPlanMode позначає завершення етапу планування. У журналі запитів після цього виклику запити зазвичай переходять до операцій реалізації (Edit, Write, Bash тощо).

package/concepts/uk/Tool-Glob.md

@@ -0,0 +1,34 @@
+# Glob
+
+## Визначення
+
+Швидкий інструмент зіставлення шаблонів імен файлів, що підтримує кодові бази будь-якого розміру. Повертає шляхи файлів, що збіглися, відсортовані за часом модифікації.
+
+## Параметри
+
+| Параметр | Тип | Обов'язковий | Опис |
+|----------|-----|--------------|------|
+| `pattern` | string | Так | Шаблон glob (наприклад, `**/*.js`, `src/**/*.ts`) |
+| `path` | string | Ні | Каталог пошуку, за замовчуванням поточний робочий каталог. Не передавайте "undefined" або "null" |
+
+## Сценарії використання
+
+**Підходить для:**
+- Пошук файлів за шаблоном імені файлу
+- Пошук усіх файлів певного типу (наприклад, усіх файлів `.tsx`)
+- Локалізація файлу при пошуку конкретного визначення класу (наприклад, `class Foo`)
+- Можна паралельно запускати кілька викликів Glob в одному повідомленні
+
+**Не підходить для:**
+- Пошук вмісту файлів — слід використовувати Grep
+- Відкрите дослідження, що потребує кількох раундів — слід використовувати Task (тип Explore)
+
+## Примітки
+
+- Підтримує стандартний синтаксис glob: `*` збігається з одним рівнем, `**` з кількома рівнями, `{}` для множинного вибору
+- Результати відсортовані за часом модифікації
+- Рекомендується більше, ніж команда `find` у Bash
+
+## Значення в cc-viewer
+
+Виклики Glob відображаються в журналі запитів як пара content block `tool_use` / `tool_result`. `tool_result` містить список шляхів файлів, що збіглися.

package/concepts/uk/Tool-Grep.md

@@ -0,0 +1,47 @@
+# Grep
+
+## Визначення
+
+Потужний інструмент пошуку вмісту на основі ripgrep. Підтримує регулярні вирази, фільтрацію за типом файлу та кілька режимів виводу.
+
+## Параметри
+
+| Параметр | Тип | Обов'язковий | Опис |
+|----------|-----|--------------|------|
+| `pattern` | string | Так | Шаблон пошуку регулярного виразу |
+| `path` | string | Ні | Шлях пошуку (файл або каталог), за замовчуванням поточний робочий каталог |
+| `glob` | string | Ні | Фільтр імені файлу (наприклад, `*.js`, `*.{ts,tsx}`) |
+| `type` | string | Ні | Фільтр типу файлу (наприклад, `js`, `py`, `rust`), ефективніший за glob |
+| `output_mode` | enum | Ні | Режим виводу: `files_with_matches` (за замовчуванням), `content`, `count` |
+| `-i` | boolean | Ні | Пошук без урахування регістру |
+| `-n` | boolean | Ні | Показувати номери рядків (лише режим content), за замовчуванням true |
+| `-A` | number | Ні | Кількість рядків після збігу |
+| `-B` | number | Ні | Кількість рядків перед збігом |
+| `-C` / `context` | number | Ні | Кількість рядків до та після збігу |
+| `head_limit` | number | Ні | Обмеження кількості записів виводу, за замовчуванням 0 (без обмежень) |
+| `offset` | number | Ні | Пропустити перші N результатів |
+| `multiline` | boolean | Ні | Увімкнути багаторядковий режим зіставлення, за замовчуванням false |
+
+## Сценарії використання
+
+**Підходить для:**
+- Пошук конкретних рядків або шаблонів у кодовій базі
+- Пошук місць використання функцій/змінних
+- Фільтрація результатів пошуку за типом файлу
+- Підрахунок кількості збігів
+
+**Не підходить для:**
+- Пошук файлів за іменем — слід використовувати Glob
+- Відкрите дослідження, що потребує кількох раундів — слід використовувати Task (тип Explore)
+
+## Примітки
+
+- Використовує синтаксис ripgrep (не grep), спеціальні символи як фігурні дужки потребують екранування
+- Режим `files_with_matches` повертає лише шляхи файлів, найефективніший
+- Режим `content` повертає вміст рядків зі збігами, підтримує контекстні рядки
+- Для багаторядкового зіставлення потрібно встановити `multiline: true`
+- Завжди надавайте перевагу інструменту Grep замість команд `grep` або `rg` у Bash
+
+## Значення в cc-viewer
+
+Виклики Grep відображаються в журналі запитів як пара content block `tool_use` / `tool_result`. `tool_result` містить результати пошуку.

package/concepts/uk/Tool-NotebookEdit.md

@@ -0,0 +1,33 @@
+# NotebookEdit
+
+## Визначення
+
+Замінює, вставляє або видаляє конкретну комірку в Jupyter notebook (файл .ipynb).
+
+## Параметри
+
+| Параметр | Тип | Обов'язковий | Опис |
+|----------|-----|--------------|------|
+| `notebook_path` | string | Так | Абсолютний шлях до файлу notebook |
+| `new_source` | string | Так | Новий вміст комірки |
+| `cell_id` | string | Ні | ID комірки для редагування. У режимі вставки нова комірка вставляється після цього ID |
+| `cell_type` | enum | Ні | Тип комірки: `code` або `markdown`. Обов'язковий у режимі вставки |
+| `edit_mode` | enum | Ні | Режим редагування: `replace` (за замовчуванням), `insert`, `delete` |
+
+## Сценарії використання
+
+**Підходить для:**
+- Зміна коду або markdown комірок у Jupyter notebook
+- Додавання нових комірок до notebook
+- Видалення комірок з notebook
+
+## Примітки
+
+- `cell_number` має індексацію з 0
+- Режим `insert` вставляє нову комірку у вказану позицію
+- Режим `delete` видаляє комірку у вказаній позиції
+- Шлях повинен бути абсолютним
+
+## Значення в cc-viewer
+
+Виклики NotebookEdit відображаються в журналі запитів як `tool_use` content block і фіксують конкретні операції зміни notebook.

package/concepts/uk/Tool-Read.md

@@ -0,0 +1,41 @@
+# Read
+
+## Визначення
+
+Читає вміст файлу з локальної файлової системи. Підтримує текстові файли, зображення, PDF та Jupyter notebook.
+
+## Параметри
+
+| Параметр | Тип | Обов'язковий | Опис |
+|----------|-----|--------------|------|
+| `file_path` | string | Так | Абсолютний шлях до файлу |
+| `offset` | number | Ні | Початковий номер рядка (для посегментного читання великих файлів) |
+| `limit` | number | Ні | Кількість рядків для читання (для посегментного читання великих файлів) |
+| `pages` | string | Ні | Діапазон сторінок PDF (наприклад, "1-5", "3", "10-20"), лише для PDF |
+
+## Сценарії використання
+
+**Підходить для:**
+- Читання текстових файлів: файлів коду, конфігураційних файлів тощо
+- Перегляд файлів зображень (Claude — мультимодальна модель)
+- Читання PDF-документів
+- Читання Jupyter notebook (повертає всі комірки та їх вивід)
+- Паралельне читання кількох файлів для отримання контексту
+
+**Не підходить для:**
+- Читання каталогу — слід використовувати команду `ls` у Bash
+- Відкрите дослідження кодової бази — слід використовувати Task (тип Explore)
+
+## Примітки
+
+- Шлях повинен бути абсолютним, не відносним
+- За замовчуванням читає перші 2000 рядків файлу
+- Рядки довші за 2000 символів будуть обрізані
+- Вивід у форматі `cat -n`, нумерація рядків починається з 1
+- Для великих PDF (понад 10 сторінок) обов'язково вказувати параметр `pages`, максимум 20 сторінок за раз
+- Читання неіснуючого файлу поверне помилку (не призведе до збою)
+- Можна паралельно викликати кілька Read в одному повідомленні
+
+## Значення в cc-viewer
+
+Виклики Read відображаються в журналі запитів як пара content block `tool_use` (виклик) та `tool_result` (повернений вміст). `tool_result` містить фактичний вміст файлу і може використовуватися для аналізу того, які файли модель прочитала.

package/concepts/uk/Tool-Skill.md

@@ -0,0 +1,35 @@
+# Skill
+
+## Визначення
+
+Виконує навичку (skill) в основній розмові. Навички — це спеціалізовані можливості, які користувач може викликати через slash command (наприклад, `/commit`, `/review-pr`).
+
+## Параметри
+
+| Параметр | Тип | Обов'язковий | Опис |
+|----------|-----|--------------|------|
+| `skill` | string | Так | Назва навички (наприклад, "commit", "review-pr", "pdf") |
+| `args` | string | Ні | Параметри навички |
+
+## Сценарії використання
+
+**Підходить для:**
+- Користувач ввів slash command у форматі `/<skill-name>`
+- Запит користувача відповідає функціональності зареєстрованої навички
+
+**Не підходить для:**
+- Вбудовані CLI-команди (наприклад, `/help`, `/clear`)
+- Навичка, що вже виконується
+- Назви навичок, яких немає у списку доступних
+
+## Примітки
+
+- Після виклику навичка розгортається у повний prompt
+- Підтримуються повні кваліфіковані назви (наприклад, `ms-office-suite:pdf`)
+- Список доступних навичок надається в повідомленнях system-reminder
+- Коли видно тег `<command-name>`, навичка вже завантажена — слід виконувати безпосередньо, а не викликати цей інструмент знову
+- Не згадуйте навичку, не викликавши інструмент фактично
+
+## Значення в cc-viewer
+
+Виклики Skill відображаються в журналі запитів як `tool_use` content block. Prompt, розгорнутий після навички, впливає на system prompt або вміст повідомлень наступних запитів.

package/concepts/uk/Tool-Task.md

@@ -0,0 +1,53 @@
+# Task
+
+## Визначення
+
+Запускає підагента (SubAgent) для автономної обробки складних багатокрокових завдань. Підагенти — це незалежні підпроцеси, кожен з яких має власний набір інструментів та контекст.
+
+## Параметри
+
+| Параметр | Тип | Обов'язковий | Опис |
+|----------|-----|--------------|------|
+| `prompt` | string | Так | Опис завдання для виконання підагентом |
+| `description` | string | Так | Короткий опис у 3-5 слів |
+| `subagent_type` | string | Так | Тип підагента, визначає доступний набір інструментів |
+| `model` | enum | Ні | Вказати модель (sonnet / opus / haiku), за замовчуванням успадковується від батьківського |
+| `max_turns` | integer | Ні | Максимальна кількість агентних раундів |
+| `run_in_background` | boolean | Ні | Чи запускати у фоновому режимі; фонові завдання повертають шлях output_file |
+| `resume` | string | Ні | ID агента для відновлення, продовжує з останнього виконання |
+| `isolation` | enum | Ні | Режим ізоляції, `worktree` створює тимчасовий git worktree |
+
+## Типи підагентів
+
+| Тип | Призначення | Доступні інструменти |
+|-----|-------------|---------------------|
+| `Bash` | Виконання команд, операції git | Bash |
+| `general-purpose` | Загальні багатокрокові завдання | Усі інструменти |
+| `Explore` | Швидке дослідження кодової бази | Усі інструменти, крім Task/Edit/Write/NotebookEdit/ExitPlanMode |
+| `Plan` | Проєктування плану реалізації | Усі інструменти, крім Task/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
+
+## Примітки
+
+- Після завершення підагент повертає одне повідомлення; його результати не видимі користувачу, основний агент повинен їх передати
+- Для підвищення ефективності можна запускати кілька паралельних викликів Task в одному повідомленні
+- Прогрес фонових завдань перевіряється через інструмент TaskOutput
+- Тип Explore повільніший за прямий виклик Glob/Grep, використовуйте лише коли простого пошуку недостатньо
+
+## Значення в cc-viewer
+
+Виклики Task створюють ланцюг запитів SubAgent; у списку запитів можна побачити послідовності підзапитів, незалежні від MainAgent. Запити SubAgent зазвичай мають скорочений system prompt та менше визначень інструментів, що створює помітний контраст з MainAgent.

package/concepts/uk/Tool-TaskCreate.md

@@ -0,0 +1,38 @@
+# TaskCreate
+
+## Визначення
+
+Створює запис структурованого списку завдань для відстеження прогресу, організації складних завдань та демонстрації ходу роботи користувачу.
+
+## Параметри
+
+| Параметр | Тип | Обов'язковий | Опис |
+|----------|-----|--------------|------|
+| `subject` | string | Так | Короткий заголовок завдання, використовується наказовий спосіб (наприклад, "Fix authentication bug") |
+| `description` | string | Так | Детальний опис, включаючи контекст та критерії прийняття |
+| `activeForm` | string | Ні | Текст у теперішньому тривалому часі, що відображається під час виконання (наприклад, "Fixing authentication bug") |
+| `metadata` | object | Ні | Довільні метадані, прикріплені до завдання |
+
+## Сценарії використання
+
+**Підходить для:**
+- Складні багатокрокові завдання (більше 3 кроків)
+- Користувач надав кілька справ для виконання
+- Відстеження роботи в режимі планування
+- Користувач явно просить використовувати список todo
+
+**Не підходить для:**
+- Одне просте завдання
+- Прості операції менш ніж за 3 кроки
+- Суто розмова або інформаційний запит
+
+## Примітки
+
+- Усі нові завдання мають початковий статус `pending`
+- `subject` використовує наказовий спосіб ("Run tests"), `activeForm` — теперішній тривалий час ("Running tests")
+- Після створення можна встановити залежності (blocks/blockedBy) через TaskUpdate
+- Перед створенням слід перевірити наявність дублікатів через TaskList
+
+## Значення в cc-viewer
+
+TaskCreate — це внутрішня операція управління завданнями Claude Code, яка не генерує окремого API-запиту. Проте в Chat Mode можна побачити tool_use block виклику цього інструменту моделлю.

package/concepts/uk/Tool-TaskGet.md

@@ -0,0 +1,35 @@
+# TaskGet
+
+## Визначення
+
+Отримує повні деталі завдання за його ID.
+
+## Параметри
+
+| Параметр | Тип | Обов'язковий | Опис |
+|----------|-----|--------------|------|
+| `taskId` | string | Так | ID завдання для отримання |
+
+## Вміст відповіді
+
+- `subject` — Заголовок завдання
+- `description` — Детальні вимоги та контекст
+- `status` — Статус: `pending`, `in_progress` або `completed`
+- `blocks` — Список завдань, заблокованих цим завданням
+- `blockedBy` — Список попередніх завдань, що блокують це завдання
+
+## Сценарії використання
+
+**Підходить для:**
+- Отримання повного опису та контексту завдання перед початком роботи
+- Розуміння залежностей завдання
+- Отримання повних вимог після призначення завдання
+
+## Примітки
+
+- Після отримання завдання слід перевірити, чи порожній список `blockedBy`, перш ніж починати роботу
+- Використовуйте TaskList для перегляду зведеної інформації про всі завдання
+
+## Значення в cc-viewer
+
+TaskGet — це внутрішня операція управління завданнями, яка не генерує окремого API-запиту.