diff --git a/uk/01-slash-commands/README.md b/uk/01-slash-commands/README.md new file mode 100644 index 0000000..0429321 --- /dev/null +++ b/uk/01-slash-commands/README.md @@ -0,0 +1,585 @@ + + + + + + + Claude How To + + +# Слеш-команди + +## Огляд + +Слеш-команди — це ярлики, що керують поведінкою Claude під час інтерактивної сесії. Вони бувають кількох типів: + +- **Вбудовані команди**: Надаються Claude Code (`/help`, `/clear`, `/model`) +- **Навички (Skills)**: Користувацькі команди, створені як файли `SKILL.md` (`/optimize`, `/pr`) +- **Команди плагінів**: Команди з встановлених плагінів (`/frontend-design:frontend-design`) +- **MCP-промпти**: Команди з MCP-серверів (`/mcp__github__list_prs`) + +> **Примітка**: Кастомні слеш-команди об'єднані з навичками. Файли в `.claude/commands/` все ще працюють, але навички (`.claude/skills/`) — рекомендований підхід. Обидва створюють ярлики `/command-name`. Див. [Посібник з навичок](../03-skills/) для повного довідника. + +## Довідник вбудованих команд + +Вбудовані команди — це ярлики для типових дій. Доступно **60+ вбудованих команд** та **5 вбудованих навичок**. Введіть `/` у Claude Code для повного списку, або `/` з літерами для фільтрації. + +| Команда | Призначення | +|---------|------------| +| `/add-dir ` | Додати робочий каталог | +| `/agents` | Управління конфігураціями агентів | +| `/branch [name]` | Розгалужити розмову в нову сесію (аліас: `/fork`). Примітка: `/fork` перейменовано на `/branch` у v2.1.77 | +| `/btw ` | Побічне запитання без додавання в історію | +| `/chrome` | Налаштування інтеграції з Chrome | +| `/clear` | Очистити розмову (аліаси: `/reset`, `/new`) | +| `/color [color\|default]` | Встановити колір рядка промпту | +| `/compact [instructions]` | Компактизувати розмову з необов'язковими інструкціями фокусу | +| `/config` | Відкрити налаштування (аліас: `/settings`) | +| `/context` | Візуалізація використання контексту кольоровою сіткою | +| `/copy [N]` | Скопіювати відповідь у буфер; `w` записує у файл | +| `/cost` | Показати статистику використання токенів | +| `/desktop` | Продовжити в десктопному застосунку (аліас: `/app`) | +| `/diff` | Інтерактивний перегляд незакомічених змін | +| `/doctor` | Діагностика стану встановлення | +| `/effort [low\|medium\|high\|max\|auto]` | Встановити рівень зусиль. `max` потребує Opus 4.6 | +| `/exit` | Вийти з REPL (аліас: `/quit`) | +| `/export [filename]` | Експортувати розмову у файл або буфер | +| `/extra-usage` | Налаштування додаткового використання для лімітів | +| `/fast [on\|off]` | Перемкнути швидкий режим | +| `/feedback` | Надіслати відгук (аліас: `/bug`) | +| `/help` | Показати довідку | +| `/hooks` | Переглянути конфігурації хуків | +| `/ide` | Управління IDE-інтеграціями | +| `/init` | Ініціалізувати `CLAUDE.md`. `CLAUDE_CODE_NEW_INIT=1` для інтерактивного потоку | +| `/insights` | Згенерувати звіт аналізу сесії | +| `/install-github-app` | Налаштувати GitHub Actions | +| `/install-slack-app` | Встановити Slack-застосунок | +| `/keybindings` | Відкрити налаштування клавіш | +| `/login` | Змінити обліковий запис Anthropic | +| `/logout` | Вийти з облікового запису Anthropic | +| `/mcp` | Управління MCP-серверами та OAuth | +| `/memory` | Редагувати `CLAUDE.md`, перемкнути автопам'ять | +| `/mobile` | QR-код для мобільного (аліаси: `/ios`, `/android`) | +| `/model [model]` | Вибір моделі зі стрілками вліво/вправо для рівня зусиль | +| `/passes` | Поділитися безкоштовним тижнем Claude Code | +| `/permissions` | Переглянути/оновити дозволи (аліас: `/allowed-tools`) | +| `/plan [description]` | Увійти в режим планування | +| `/plugin` | Управління плагінами | +| `/powerup` | Інтерактивні уроки з анімованими демо | +| `/privacy-settings` | Налаштування приватності (Pro/Max) | +| `/release-notes` | Переглянути журнал змін | +| `/reload-plugins` | Перезавантажити активні плагіни | +| `/remote-control` | Віддалене керування з claude.ai (аліас: `/rc`) | +| `/remote-env` | Налаштування стандартного віддаленого середовища | +| `/rename [name]` | Перейменувати сесію | +| `/resume [session]` | Відновити розмову (аліас: `/continue`) | +| `/review` | **Застаріла** — встановіть плагін `code-review` | +| `/rewind` | Відкат розмови та/або коду (аліас: `/checkpoint`) | +| `/sandbox` | Перемкнути режим пісочниці | +| `/schedule [description]` | Створити/управляти хмарними запланованими завданнями | +| `/security-review` | Аналіз гілки на вразливості безпеки | +| `/skills` | Список доступних навичок | +| `/stats` | Візуалізація щоденного використання, сесій, серій | +| `/stickers` | Замовити стікери Claude Code | +| `/status` | Показати версію, модель, обліковий запис | +| `/statusline` | Налаштування рядка стану | +| `/tasks` | Список/управління фоновими завданнями | +| `/terminal-setup` | Налаштування клавіш терміналу | +| `/theme` | Змінити колірну тему | +| `/ultraplan ` | Створити план в ultraplan-сесії, переглянути в браузері | +| `/upgrade` | Відкрити сторінку оновлення тарифу | +| `/usage` | Показати ліміти плану та статус обмежень | +| `/voice` | Перемкнути голосовий ввід push-to-talk | + +### Вбудовані навички + +Ці навички поставляються з Claude Code і викликаються як слеш-команди: + +| Навичка | Призначення | +|---------|------------| +| `/batch ` | Оркестрація масштабних паралельних змін через worktrees | +| `/claude-api` | Завантажити довідник Claude API для мови проекту | +| `/debug [description]` | Увімкнути налагоджувальне логування | +| `/loop [interval] ` | Запускати промпт повторно за інтервалом | +| `/simplify [focus]` | Перевірити змінені файли на якість коду | + +### Застарілі команди + +| Команда | Статус | +|---------|--------| +| `/review` | Застаріла — замінена плагіном `code-review` | +| `/output-style` | Застаріла з v2.1.73 | +| `/fork` | Перейменована на `/branch` (аліас працює, v2.1.77) | +| `/pr-comments` | Видалена в v2.1.91 — запитайте Claude напряму | +| `/vim` | Видалена в v2.1.92 — використовуйте /config → Editor mode | + +### Останні зміни + +- `/fork` перейменовано на `/branch`, `/fork` залишено як аліас (v2.1.77) +- `/output-style` застаріла (v2.1.73) +- `/review` застаріла на користь плагіна `code-review` +- Додано команду `/effort` з рівнем `max` для Opus 4.6 +- Додано команду `/voice` для голосового вводу push-to-talk +- Додано команду `/schedule` для запланованих завдань +- Додано команду `/color` для кастомізації рядка промпту +- `/pr-comments` видалена в v2.1.91 +- `/vim` видалена в v2.1.92 +- Додано `/ultraplan` для перегляду плану в браузері +- Додано `/powerup` для інтерактивних уроків +- Додано `/sandbox` для режиму пісочниці +- Вибір `/model` тепер показує зрозумілі назви (наприклад, "Sonnet 4.6") замість ID моделей +- `/resume` підтримує аліас `/continue` +- MCP-промпти доступні як команди `/mcp____` (див. [MCP-промпти як команди](#mcp-промпти-як-команди)) + +## Кастомні команди (тепер навички) + +Кастомні слеш-команди **об'єднані з навичками**. Обидва підходи створюють команди, які викликаються через `/command-name`: + +| Підхід | Розташування | Статус | +|--------|-------------|--------| +| **Навички (Рекомендовано)** | `.claude/skills//SKILL.md` | Поточний стандарт | +| **Legacy-команди** | `.claude/commands/.md` | Все ще працює | + +Якщо навичка і команда мають однакове ім'я, **навичка має пріоритет**. Наприклад, коли існують і `.claude/commands/review.md`, і `.claude/skills/review/SKILL.md`, використовується версія навички. + +### Шлях міграції + +Існуючі файли `.claude/commands/` продовжують працювати без змін. Для міграції на навички: + +**До (Команда):** + +``` +.claude/commands/optimize.md +``` + +**Після (Навичка):** + +``` +.claude/skills/optimize/SKILL.md +``` + +### Чому навички? + +Навички пропонують додаткові можливості порівняно з legacy-командами: + +- **Структура каталогів**: Пакування скриптів, шаблонів та довідкових файлів +- **Автовиклик**: Claude може запускати навички автоматично за потреби +- **Контроль виклику**: Вибір — користувач, Claude, або обидва можуть викликати +- **Виконання в субагенті**: Запуск навичок в ізольованих контекстах з `context: fork` +- **Прогресивне розкриття**: Завантаження додаткових файлів лише за потреби + +### Створення кастомної команди як навички + +Створіть каталог з файлом `SKILL.md`: + +```bash +mkdir -p .claude/skills/my-command +``` + +**Файл:** `.claude/skills/my-command/SKILL.md` + +```yaml +--- +name: my-command +description: Що робить ця команда і коли її використовувати +--- + +# My Command + +Інструкції для Claude при виклику цієї команди. + +1. Перший крок +2. Другий крок +3. Третій крок +``` + +### Довідник фронтматеру + +| Поле | Призначення | За замовчуванням | +|------|------------|-----------------| +| `name` | Ім'я команди (стає `/name`) | Ім'я каталогу | +| `description` | Короткий опис (допомагає Claude знати коли використовувати) | Перший абзац | +| `argument-hint` | Очікувані аргументи для автодоповнення | Немає | +| `allowed-tools` | Інструменти без запиту дозволу | Успадковується | +| `model` | Конкретна модель для використання | Успадковується | +| `disable-model-invocation` | Якщо `true`, тільки користувач може викликати | `false` | +| `user-invocable` | Якщо `false`, сховати з меню `/` | `true` | +| `context` | `fork` для запуску в ізольованому субагенті | Немає | +| `agent` | Тип агента при `context: fork` | `general-purpose` | +| `hooks` | Хуки на рівні навички (PreToolUse, PostToolUse, Stop) | Немає | + +### Аргументи + +Команди можуть отримувати аргументи: + +**Усі аргументи з `$ARGUMENTS`:** + +```yaml +--- +name: fix-issue +description: Fix a GitHub issue by number +--- + +Fix issue #$ARGUMENTS following our coding standards +``` + +Використання: `/fix-issue 123` → `$ARGUMENTS` стає "123" + +**Окремі аргументи з `$0`, `$1` тощо:** + +```yaml +--- +name: review-pr +description: Review a PR with priority +--- + +Review PR #$0 with priority $1 +``` + +Використання: `/review-pr 456 high` → `$0`="456", `$1`="high" + +### Динамічний контекст з shell-командами + +Виконуйте bash-команди перед промптом з допомогою `` !`command` ``: + +```yaml +--- +name: commit +description: Create a git commit with context +allowed-tools: Bash(git *) +--- + +## Context + +- Current git status: !`git status` +- Current git diff: !`git diff HEAD` +- Current branch: !`git branch --show-current` +- Recent commits: !`git log --oneline -5` + +## Your task + +Based on the above changes, create a single git commit. +``` + +### Посилання на файли + +Включайте вміст файлів з `@`: + +```markdown +Review the implementation in @src/utils/helpers.js +Compare @src/old-version.js with @src/new-version.js +``` + +## Команди плагінів + +Плагіни можуть надавати кастомні команди: + +``` +/plugin-name:command-name +``` + +Або просто `/command-name`, якщо немає конфліктів імен. + +**Приклади:** + +```bash +/frontend-design:frontend-design +/commit-commands:commit +``` + +## MCP-промпти як команди + +MCP-сервери можуть надавати промпти як слеш-команди: + +``` +/mcp____ [arguments] +``` + +**Приклади:** + +```bash +/mcp__github__list_prs +/mcp__github__pr_review 456 +/mcp__jira__create_issue "Bug title" high +``` + +### Синтаксис дозволів MCP + +Контроль доступу до MCP-серверів у дозволах: + +- `mcp__github` — Доступ до всього GitHub MCP-сервера +- `mcp__github__*` — Wildcard-доступ до всіх інструментів +- `mcp__github__get_issue` — Доступ до конкретного інструменту + +## Архітектура команд + +```mermaid +graph TD + A["User Input: /command-name"] --> B{"Command Type?"} + B -->|Built-in| C["Execute Built-in"] + B -->|Skill| D["Load SKILL.md"] + B -->|Plugin| E["Load Plugin Command"] + B -->|MCP| F["Execute MCP Prompt"] + + D --> G["Parse Frontmatter"] + G --> H["Substitute Variables"] + H --> I["Execute Shell Commands"] + I --> J["Send to Claude"] + J --> K["Return Results"] +``` + +## Життєвий цикл команди + +```mermaid +sequenceDiagram + participant User + participant Claude as Claude Code + participant FS as File System + participant CLI as Shell/Bash + + User->>Claude: Types /optimize + Claude->>FS: Searches .claude/skills/ and .claude/commands/ + FS-->>Claude: Returns optimize/SKILL.md + Claude->>Claude: Parses frontmatter + Claude->>CLI: Executes !`command` substitutions + CLI-->>Claude: Command outputs + Claude->>Claude: Substitutes $ARGUMENTS + Claude->>User: Processes prompt + Claude->>User: Returns results +``` + +## Доступні команди в цьому каталозі + +Ці приклади команд можна встановити як навички або legacy-команди. + +### 1. `/optimize` — Оптимізація коду + +Аналізує код на проблеми продуктивності, витоки пам'яті та можливості оптимізації. + +**Використання:** + +``` +/optimize +[Вставте ваш код] +``` + +### 2. `/pr` — Підготовка Pull Request + +Проводить через чекліст підготовки PR, включаючи лінтинг, тестування та форматування комітів. + +**Використання:** + +``` +/pr +``` + +**Скріншот:** +![/pr](../../01-slash-commands/pr-slash-command.png) + +### 3. `/generate-api-docs` — Генератор API-документації + +Генерує комплексну API-документацію з вихідного коду. + +**Використання:** + +``` +/generate-api-docs +``` + +### 4. `/commit` — Git-коміт з контекстом + +Створює git-коміт з динамічним контекстом вашого репозиторію. + +**Використання:** + +``` +/commit [необов'язкове повідомлення] +``` + +### 5. `/push-all` — Stage, Commit та Push + +Stage всіх змін, створення коміту та push на remote з перевірками безпеки. + +**Використання:** + +``` +/push-all +``` + +**Перевірки безпеки:** + +- Секрети: `.env*`, `*.key`, `*.pem`, `credentials.json` +- API-ключі: Виявлення реальних ключів vs. заповнювачів +- Великі файли: `>10MB` без Git LFS +- Артефакти збірки: `node_modules/`, `dist/`, `__pycache__/` + +### 6. `/doc-refactor` — Реструктуризація документації + +Реструктуризує документацію проекту для ясності та доступності. + +**Використання:** + +``` +/doc-refactor +``` + +### 7. `/setup-ci-cd` — Налаштування CI/CD-пайплайну + +Впроваджує pre-commit хуки та GitHub Actions для контролю якості. + +**Використання:** + +``` +/setup-ci-cd +``` + +### 8. `/unit-test-expand` — Розширення покриття тестами + +Збільшує покриття тестами, націлюючись на непротестовані гілки та крайові випадки. + +**Використання:** + +``` +/unit-test-expand +``` + +## Встановлення + +### Як навички (Рекомендовано) + +Скопіюйте у каталог навичок: + +```bash +# Створити каталог навичок +mkdir -p .claude/skills + +# Для кожного файлу команди створити каталог навички +for cmd in optimize pr commit; do + mkdir -p .claude/skills/$cmd + cp 01-slash-commands/$cmd.md .claude/skills/$cmd/SKILL.md +done +``` + +### Як legacy-команди + +Скопіюйте у каталог команд: + +```bash +# На рівні проекту (команда) +mkdir -p .claude/commands +cp 01-slash-commands/*.md .claude/commands/ + +# Персональне використання +mkdir -p ~/.claude/commands +cp 01-slash-commands/*.md ~/.claude/commands/ +``` + +## Створення власних команд + +### Шаблон навички (Рекомендовано) + +Створіть `.claude/skills/my-command/SKILL.md`: + +```yaml +--- +name: my-command +description: What this command does. Use when [trigger conditions]. +argument-hint: [optional-args] +allowed-tools: Bash(npm *), Read, Grep +--- + +# Command Title + +## Context + +- Current branch: !`git branch --show-current` +- Related files: @package.json + +## Instructions + +1. First step +2. Second step with argument: $ARGUMENTS +3. Third step + +## Output Format + +- How to format the response +- What to include +``` + +### Команда лише для користувача (без автовиклику) + +Для команд з побічними ефектами, які Claude не повинен запускати автоматично: + +```yaml +--- +name: deploy +description: Deploy to production +disable-model-invocation: true +allowed-tools: Bash(npm *), Bash(git *) +--- + +Deploy the application to production: + +1. Run tests +2. Build application +3. Push to deployment target +4. Verify deployment +``` + +## Найкращі практики + +| Робіть | Не робіть | +|--------|-----------| +| Використовуйте чіткі, орієнтовані на дію назви | Не створюйте команди для одноразових завдань | +| Додавайте `description` з умовами тригеру | Не вбудовуйте складну логіку в команди | +| Тримайте команди зосередженими на одному завданні | Не хардкодьте чутливу інформацію | +| Використовуйте `disable-model-invocation` для побічних ефектів | Не пропускайте поле description | +| Використовуйте `!` для динамічного контексту | Не вважайте, що Claude знає поточний стан | +| Організуйте пов'язані файли в каталогах навичок | Не кладіть все в один файл | + +## Усунення неполадок + +### Команда не знайдена + +**Рішення:** + +- Перевірте, що файл у `.claude/skills//SKILL.md` або `.claude/commands/.md` +- Перевірте поле `name` у фронтматері +- Перезапустіть сесію Claude Code +- Запустіть `/help` для перегляду доступних команд + +### Команда працює не як очікувалось + +**Рішення:** + +- Додайте більш конкретні інструкції +- Включіть приклади у файл навички +- Перевірте `allowed-tools` при використанні bash-команд +- Спочатку тестуйте з простими вхідними даними + +### Конфлікт навички та команди + +Якщо обидві існують з однаковим ім'ям, **навичка має пріоритет**. Видаліть одну або перейменуйте. + +## Пов'язані посібники + +- **[Навички](../03-skills/)** — Повний довідник навичок (автоматично викликані можливості) +- **[Пам'ять](../02-memory/)** — Постійний контекст з CLAUDE.md +- **[Субагенти](../04-subagents/)** — Делеговані AI-агенти +- **[Плагіни](../07-plugins/)** — Пакетні набори команд +- **[Хуки](../06-hooks/)** — Автоматизація на основі подій + +## Додаткові ресурси + +- [Офіційна документація інтерактивного режиму](https://code.claude.com/docs/en/interactive-mode) — Довідник вбудованих команд +- [Офіційна документація навичок](https://code.claude.com/docs/en/skills) — Повний довідник навичок +- [Довідник CLI](https://code.claude.com/docs/en/cli-reference) — Опції командного рядка + +--- + +**Останнє оновлення**: 9 квітня 2026 +**Версія Claude Code**: 2.1.97 +**Сумісні моделі**: Claude Sonnet 4.6, Claude Opus 4.6, Claude Haiku 4.5 + +*Частина серії посібників [Claude How To](../)* diff --git a/uk/08-checkpoints/README.md b/uk/08-checkpoints/README.md new file mode 100644 index 0000000..781d855 --- /dev/null +++ b/uk/08-checkpoints/README.md @@ -0,0 +1,335 @@ + + + + + + + Claude How To + + +# Контрольні точки та відкат + +Контрольні точки дозволяють зберігати стан розмови та повертатися до попередніх моментів у сесії Claude Code. Це незамінно для дослідження різних підходів, відновлення після помилок або порівняння альтернативних рішень. + +## Огляд + +Контрольні точки — це знімки стану вашої розмови, що включають: + +- Усі повідомлення розмови +- Модифікації файлів +- Історію використання інструментів +- Контекст сесії + +Контрольні точки незамінні при дослідженні різних підходів, відновленні після помилок або порівнянні альтернативних рішень. + +## Ключові поняття + +| Поняття | Опис | +|---------|------| +| **Контрольна точка (Checkpoint)** | Знімок стану розмови, включаючи повідомлення, файли та контекст | +| **Відкат (Rewind)** | Повернення до попередньої контрольної точки з відкиданням подальших змін | +| **Точка розгалуження (Branch Point)** | Контрольна точка, з якої досліджуються кілька підходів | + +## Доступ до контрольних точок + +Ви можете отримати доступ та управляти контрольними точками двома способами: + +### Клавіатурне скорочення + +Натисніть `Esc` двічі (`Esc` + `Esc`), щоб відкрити інтерфейс контрольних точок та переглянути збережені точки. + +### Слеш-команда + +Використовуйте команду `/rewind` (аліас: `/checkpoint`) для швидкого доступу: + +```bash +# Відкрити інтерфейс відкату +/rewind + +# Або використайте аліас +/checkpoint +``` + +## Варіанти відкату + +При відкаті вам пропонується меню з п'яти варіантів: + +1. **Відновити код і розмову** — Повернути і файли, і повідомлення до цієї контрольної точки +2. **Відновити розмову** — Відкотити лише повідомлення, залишити поточний код як є +3. **Відновити код** — Повернути зміни файлів, зберегти повну історію розмови +4. **Підсумувати звідси** — Стиснути розмову від цієї точки вперед в AI-згенерований підсумок, звільняючи контекстне вікно. Повідомлення до обраної точки залишаються недоторканими. Жодні файли на диску не змінюються. Оригінальні повідомлення зберігаються в транскрипті сесії. Можна додатково вказати інструкції для фокусування підсумку на конкретних темах. +5. **Скасувати** — Скасувати та повернутися до поточного стану + +> **Примітка**: Після відновлення розмови або підсумовування оригінальний промпт з обраного повідомлення відновлюється в полі вводу, щоб ви могли повторно надіслати або відредагувати його. + +## Автоматичні контрольні точки + +Claude Code автоматично створює контрольні точки: + +- **Кожен промпт користувача** — Нова контрольна точка створюється з кожним введенням +- **Постійні** — Контрольні точки зберігаються між сесіями +- **Автоочищення** — Контрольні точки автоматично очищуються через 30 днів + +Це означає, що ви завжди можете повернутися до будь-якого попереднього моменту розмови — від кількох хвилин тому до днів. + +## Сценарії використання + +| Сценарій | Процес | +|----------|--------| +| **Дослідження підходів** | Зберегти → Спробувати A → Зберегти → Відкат → Спробувати B → Порівняти | +| **Безпечний рефакторинг** | Зберегти → Рефакторити → Тест → Якщо не вдалось: Відкат | +| **A/B тестування** | Зберегти → Дизайн A → Зберегти → Відкат → Дизайн B → Порівняти | +| **Відновлення після помилки** | Помітити проблему → Відкат до останнього робочого стану | + +## Використання контрольних точок + +### Перегляд та відкат + +Натисніть `Esc` двічі або використайте `/rewind`, щоб відкрити браузер контрольних точок. Ви побачите список усіх доступних точок з мітками часу. Оберіть будь-яку для відкату. + +### Деталі контрольної точки + +Кожна контрольна точка показує: + +- Мітку часу створення +- Модифіковані файли +- Кількість повідомлень у розмові +- Використані інструменти + +## Практичні приклади + +### Приклад 1: Дослідження різних підходів + +``` +User: Let's add a caching layer to the API + +Claude: I'll add Redis caching to your API endpoints... +[Makes changes at checkpoint A] + +User: Actually, let's try in-memory caching instead + +Claude: I'll rewind to explore a different approach... +[User presses Esc+Esc and rewinds to checkpoint A] +[Implements in-memory caching at checkpoint B] + +User: Now I can compare both approaches +``` + +### Приклад 2: Відновлення після помилки + +``` +User: Refactor the authentication module to use JWT + +Claude: I'll refactor the authentication module... +[Makes extensive changes] + +User: Wait, that broke the OAuth integration. Let's go back. + +Claude: I'll help you rewind to before the refactoring... +[User presses Esc+Esc and selects the checkpoint before the refactor] + +User: Let's try a more conservative approach this time +``` + +### Приклад 3: Безпечне експериментування + +``` +User: Let's try rewriting this in a functional style +[Creates checkpoint before experiment] + +Claude: [Makes experimental changes] + +User: The tests are failing. Let's rewind. +[User presses Esc+Esc and rewinds to the checkpoint] + +Claude: I've rewound the changes. Let's try a different approach. +``` + +### Приклад 4: Розгалуження підходів + +``` +User: I want to compare two database designs +[Takes note of checkpoint - call it "Start"] + +Claude: I'll create the first design... +[Implements Schema A] + +User: Now let me go back and try the second approach +[User presses Esc+Esc and rewinds to "Start"] + +Claude: Now I'll implement Schema B... +[Implements Schema B] + +User: Great! Now I have both schemas to choose from +``` + +## Збереження контрольних точок + +Claude Code автоматично управляє контрольними точками: + +- Контрольні точки створюються автоматично з кожним промптом +- Старі контрольні точки зберігаються до 30 днів +- Автоматичне очищення запобігає необмеженому зростанню сховища + +## Патерни процесів + +### Стратегія розгалуження для дослідження + +При дослідженні кількох підходів: + +``` +1. Початкова реалізація → Контрольна точка A +2. Спроба Підходу 1 → Контрольна точка B +3. Відкат до Контрольної точки A +4. Спроба Підходу 2 → Контрольна точка C +5. Порівняння результатів B та C +6. Вибір найкращого підходу та продовження +``` + +### Патерн безпечного рефакторингу + +При значних змінах: + +``` +1. Поточний стан → Контрольна точка (авто) +2. Початок рефакторингу +3. Запуск тестів +4. Якщо тести пройшли → Продовжити роботу +5. Якщо тести не пройшли → Відкат та спроба іншого підходу +``` + +## Найкращі практики + +Оскільки контрольні точки створюються автоматично, ви можете зосередитися на роботі, не турбуючись про ручне збереження стану. Але пам'ятайте: + +### Ефективне використання контрольних точок + +✅ **Робіть:** + +- Переглядайте доступні контрольні точки перед відкатом +- Використовуйте відкат для дослідження різних напрямків +- Зберігайте контрольні точки для порівняння підходів +- Розумійте, що робить кожен варіант відкату + +❌ **Не робіть:** + +- Не покладайтесь лише на контрольні точки для збереження коду +- Не очікуйте, що контрольні точки відстежують зовнішні зміни файлової системи +- Не використовуйте контрольні точки замість git-комітів + +## Конфігурація + +Контрольні точки — вбудована поведінка Claude Code за замовчуванням, не потребує конфігурації. Кожен промпт автоматично створює контрольну точку. + +Єдине налаштування — `cleanupPeriodDays`, що контролює тривалість зберігання: + +```json +{ + "cleanupPeriodDays": 30 +} +``` + +- `cleanupPeriodDays`: Кількість днів зберігання історії сесій та контрольних точок (за замовчуванням: `30`) + +## Обмеження + +Контрольні точки мають такі обмеження: + +- **Bash-команди НЕ відстежуються** — Операції `rm`, `mv`, `cp` у файловій системі не фіксуються +- **Зовнішні зміни НЕ відстежуються** — Зміни, зроблені поза Claude Code (у редакторі, терміналі тощо), не фіксуються +- **Не заміна системі контролю версій** — Використовуйте git для постійних, аудитованих змін + +## Усунення неполадок + +### Відсутні контрольні точки + +**Проблема**: Очікувана контрольна точка не знайдена + +**Рішення**: + +- Перевірте, чи контрольні точки не були очищені +- Перевірте дисковий простір +- Переконайтесь, що `cleanupPeriodDays` встановлено достатньо високо (за замовчуванням: 30 днів) + +### Невдалий відкат + +**Проблема**: Не вдається відкотити до контрольної точки + +**Рішення**: + +- Переконайтесь, що немає конфліктуючих незакомічених змін +- Перевірте, чи контрольна точка не пошкоджена +- Спробуйте відкат до іншої контрольної точки + +## Інтеграція з Git + +Контрольні точки доповнюють (але не замінюють) git: + +| Характеристика | Git | Контрольні точки | +|----------------|-----|-----------------| +| Область | Файлова система | Розмова + файли | +| Постійність | Постійна | На рівні сесії | +| Деталізація | Коміти | Будь-яка точка | +| Швидкість | Повільніше | Миттєво | +| Спільний доступ | Так | Обмежено | + +Використовуйте обидва разом: + +1. Контрольні точки для швидкого експериментування +2. Git-коміти для фіналізованих змін +3. Створення контрольної точки перед git-операціями +4. Коміт успішних станів до git + +## Швидкий старт + +### Базовий процес + +1. **Працюйте як зазвичай** — Claude Code створює контрольні точки автоматично +2. **Хочете повернутись?** — Натисніть `Esc` двічі або `/rewind` +3. **Оберіть контрольну точку** — Виберіть зі списку +4. **Оберіть що відновити** — Код і розмову, лише розмову, лише код, підсумувати або скасувати +5. **Продовжуйте роботу** — Ви повернулись до тієї точки + +### Клавіатурні скорочення + +- **`Esc` + `Esc`** — Відкрити браузер контрольних точок +- **`/rewind`** — Альтернативний спосіб доступу +- **`/checkpoint`** — Аліас для `/rewind` + +## Коли відкочуватися: Моніторинг контексту + +Контрольні точки дозволяють повернутись — але як зрозуміти, *коли* це потрібно? З ростом розмови контекстне вікно Claude заповнюється, і якість моделі непомітно знижується. Ви можете відправляти код, згенерований напівсліпою моделлю, навіть не усвідомлюючи цього. + +**[cc-context-stats](https://github.com/luongnv89/cc-context-stats)** вирішує це, додаючи **зони контексту** в реальному часі до рядка стану Claude Code. Інструмент відстежує, де ви знаходитесь у контекстному вікні — від **Plan** (зелений, безпечно планувати та кодити) через **Code** (жовтий, уникайте нових планів) до **Dump** (оранжевий, завершуйте та відкочуйте). Коли бачите зміну зони — час створити контрольну точку та почати заново. + +## Пов'язані концепції + +- **[Розширені функції](../09-advanced-features/)** — Режим планування та інші просунуті можливості +- **[Управління пам'яттю](../02-memory/)** — Управління історією розмови та контекстом +- **[Слеш-команди](../01-slash-commands/)** — Ярлики користувача +- **[Хуки](../06-hooks/)** — Автоматизація на основі подій +- **[Плагіни](../07-plugins/)** — Пакетні розширення + +## Додаткові ресурси + +- [Офіційна документація контрольних точок](https://code.claude.com/docs/en/checkpointing) +- [Посібник з розширених функцій](../09-advanced-features/) — Розширене мислення та інші можливості + +## Підсумок + +Контрольні точки — автоматична функція Claude Code, що дозволяє безпечно досліджувати різні підходи без страху втратити роботу. Кожен промпт автоматично створює нову контрольну точку, тож ви можете відкотитися до будь-якого попереднього моменту сесії. + +Ключові переваги: + +- Безстрашне експериментування з кількома підходами +- Швидке відновлення після помилок +- Порівняння різних рішень пліч-о-пліч +- Безпечна інтеграція з системами контролю версій + +Пам'ятайте: контрольні точки не замінюють git. Використовуйте контрольні точки для швидкого експериментування, а git — для постійних змін коду. + +--- + +**Останнє оновлення**: 9 квітня 2026 +**Версія Claude Code**: 2.1.97 +**Сумісні моделі**: Claude Sonnet 4.6, Claude Opus 4.6, Claude Haiku 4.5 diff --git a/uk/TRANSLATION_QUEUE.md b/uk/TRANSLATION_QUEUE.md index 9787084..179040b 100644 --- a/uk/TRANSLATION_QUEUE.md +++ b/uk/TRANSLATION_QUEUE.md @@ -2,111 +2,44 @@ # Прогрес перекладу українською -**Загальний прогрес:** 0/67 файлів (0%) +**Загальний прогрес:** 5/67 файлів (7%) -**Статус:** 🚧 В ПРОЦЕСІ +**Статус:** 🚧 В ПРОЦЕСІ — P1 ядро завершено ✅ -## Пріоритет 1 — Ядро (5 файлів) +## Пріоритет 1 — Ядро (5 файлів) ✅ -| Файл | Статус | Дата | Перекладач | -|------|--------|------|------------| -| README.md | ✅ Готово | 2026-04-09 | edocltd | -| INDEX.md | ⏳ Очікує | | | -| CATALOG.md | ⏳ Очікує | | | -| QUICK_REFERENCE.md | ⏳ Очікує | | | -| LEARNING-ROADMAP.md | ⏳ Очікує | | | +| Файл | Статус | Дата | +|------|--------|------| +| README.md | ✅ | 2026-04-09 | +| INDEX.md | ✅ | 2026-04-09 | +| CATALOG.md | ✅ | 2026-04-09 | +| QUICK_REFERENCE.md | ✅ | 2026-04-09 | +| LEARNING-ROADMAP.md | ✅ | 2026-04-09 | -**Прогрес P1:** 1/5 (20%) +**Прогрес P1:** 5/5 (100%) ✅ ## Пріоритет 2 — Модулі README (10 файлів) -| Модуль | Файл | Статус | Дата | -|--------|------|--------|------| -| 01 | 01-slash-commands/README.md | ⏳ Очікує | | -| 02 | 02-memory/README.md | ⏳ Очікує | | -| 03 | 03-skills/README.md | ⏳ Очікує | | -| 04 | 04-subagents/README.md | ⏳ Очікує | | -| 05 | 05-mcp/README.md | ⏳ Очікує | | -| 06 | 06-hooks/README.md | ⏳ Очікує | | -| 07 | 07-plugins/README.md | ⏳ Очікує | | -| 08 | 08-checkpoints/README.md | ⏳ Очікує | | -| 09 | 09-advanced-features/README.md | ⏳ Очікує | | -| 10 | 10-cli/README.md | ⏳ Очікує | | +| Модуль | Рядків | Статус | Дата | +|--------|--------|--------|------| +| 01 slash-commands | 565 | ⏳ | | +| 02 memory | 1156 | ⏳ | | +| 03 skills | 811 | ⏳ | | +| 04 subagents | 1142 | ⏳ | | +| 05 mcp | 1113 | ⏳ | | +| 06 hooks | 1170 | ⏳ | | +| 07 plugins | 949 | ⏳ | | +| 08 checkpoints | 320 | ⏳ | | +| 09 advanced | 1945 | ⏳ | | +| 10 cli | 837 | ⏳ | | **Прогрес P2:** 0/10 (0%) -## Пріоритет 3 — Приклади модулів (47 файлів) +## Пріоритет 3 — Приклади (47 файлів) · P4 — Допоміжні (5 файлів) -### Модуль 01 — Слеш-команди (8 файлів) +Деталі — див. попередню версію цього файлу. -| Файл | Статус | Дата | -|------|--------|------| -| commit.md | ⏳ | | -| doc-refactor.md | ⏳ | | -| generate-api-docs.md | ⏳ | | -| optimize.md | ⏳ | | -| pr.md | ⏳ | | -| push-all.md | ⏳ | | -| setup-ci-cd.md | ⏳ | | -| unit-test-expand.md | ⏳ | | - -### Модуль 02 — Пам'ять (3 файли) - -| Файл | Статус | Дата | -|------|--------|------| -| directory-api-CLAUDE.md | ⏳ | | -| personal-CLAUDE.md | ⏳ | | -| project-CLAUDE.md | ⏳ | | - -### Модуль 03 — Навички (6 файлів) - -| Файл | Статус | Дата | -|------|--------|------| -| blog-draft/SKILL.md | ⏳ | | -| brand-voice/SKILL.md | ⏳ | | -| brand-voice/tone-examples.md | ⏳ | | -| claude-md/SKILL.md | ⏳ | | -| code-review/SKILL.md | ⏳ | | -| doc-generator/SKILL.md | ⏳ | | -| refactor/SKILL.md | ⏳ | | - -### Модуль 04 — Субагенти (8 файлів) - -| Файл | Статус | Дата | -|------|--------|------| -| clean-code-reviewer.md | ⏳ | | -| code-reviewer.md | ⏳ | | -| data-scientist.md | ⏳ | | -| debugger.md | ⏳ | | -| documentation-writer.md | ⏳ | | -| implementation-agent.md | ⏳ | | -| performance-optimizer.md | ⏳ | | -| secure-reviewer.md | ⏳ | | -| test-engineer.md | ⏳ | | - -### Модуль 05-10 — Приклади - -Код-файли (`.sh`, `.py`, `.json`) **не копіюються** — посилаємося на оригінали. -Файли прикладів перекладаються за потреби. - -| Файл | Статус | Дата | -|------|--------|------| -| 08-checkpoints/checkpoint-examples.md | ⏳ | | -| 09-advanced-features/planning-mode-examples.md | ⏳ | | - -**Прогрес P3:** 0/47 (0%) - -## Пріоритет 4 — Допоміжні документи (5 файлів) - -| Файл | Статус | Дата | -|------|--------|------| -| CONTRIBUTING.md | ⏳ Очікує | | -| SECURITY.md | ⏳ Очікує | | -| CODE_OF_CONDUCT.md | ⏳ Очікує | | -| STYLE_GUIDE.md | ⏳ Очікує | | -| CHANGELOG.md | ⏳ Очікує | | - -**Прогрес P4:** 0/5 (0%) +**Прогрес P3:** 0/47 · **P4:** 0/5 ---