Типовые сценарии ​

Пошаговые рецепты для повседневных задач. Каждый сценарий показывает конкретную ситуацию, промпты, которые нужно использовать, и то, чего ожидать.

Содержание ​

Разузнать новую кодовую базу ​

Запустите Command Code в корне проекта, попросите общий обзор, а затем углубитесь в частности.

1. Получите общий обзор ​

Попросите обзор:

text
> give me a brief overview of this codebase - structure, key packages, and entry points

2. Изучите архитектуру ​

Архитектура:

text
> explain the architecture patterns used here and how the modules connect

3. Углубитесь в конкретную область ​

Глубже:

text
> how is the payment system implemented? walk me through the flow from checkout to confirmation

TIP

Обучение вкусу (taste) видно прямо в процессе: в транскрипте появляется зелёная строка TASTE с тем, что было изучено, его уверенностью и ссылкой на taste.md, в который это записано.

Ссылаться на файлы и каталоги ​

Используйте @, чтобы включить файлы или каталоги в любой промпт. Это даёт Command Code ровно тот контекст, который нужен.

1. Сошлитесь на один файл ​

Ссылка на файл:

text
> explain the validation logic in @src/lib/auth.ts

Это помогает Command Code сосредоточиться на нужном файле и дать точные предложения.

2. Сошлитесь на каталог ​

Ссылка на каталог:

text
> look at @src/app/api and explain the route structure

Command Code читает список файлов каталога и объясняет, как они связаны.

3. Используйте расширение для IDE, чтобы контекст был мгновенным ​

Если вы пользуетесь VS Code или Cursor, подключите Command Code к редактору через /ide или cmd --ide-setup. После подключения выделенный код и открытые файлы автоматически добавляются к промптам как контекст. Вручную указывать пути через @ больше не нужно.

Чтобы запускать Command Code прямо в VS Code, используйте расширение VS Code. Оно даёт чат, управление сессиями и подтверждения в нативной панели редактора.

TIP

@ вызывает автодополнение по файлам и каталогам — начните печатать и нажмите tab, чтобы выбрать.

Найти и исправить ошибки ​

Поделитесь ошибкой, дайте Command Code проследить корневую причину и примените исправление.

1. Поделитесь ошибкой ​

Сообщите об ошибке:

text
> I'm seeing a TypeError when I run `pnpm dev` - "Cannot read properties of undefined (reading 'map')"

2. Найдите корневую причину ​

Проследите ошибку:

text
> find where this error originates and explain why it happens

3. Примените исправление и проверьте ​

Исправьте ошибку:

text
> fix the bug in @src/components/UserList.tsx and run `pnpm dev` to verify

TIP

Вставьте в промпт полный стек-трейс — Command Code использует его, чтобы точно определить файл и строку, вызывающие ошибку.

Рефакторинг кода ​

Освежите модуль, сохранив поведение неизменным.

1. Определите, что рефакторить ​

Цель рефакторинга:

text
> refactor @src/api/client.ts from callbacks to async/await - keep the same public API

2. Проверьте и примените изменения ​

Command Code показывает дифф. Одобрите правки или попросите их скорректировать до того, как они будут записаны.

3. Запустите тесты для подтверждения ​

Проверка:

text
> run the tests for the API client to make sure nothing broke

Подстраховка

Нажмите Esc дважды, чтобы открыть список чекпоинтов и откатиться, если рефакторинг пошёл не так.

Написать тесты ​

Добавьте тесты для модуля на том тестовом фреймворке, который в проекте уже используется.

1. Сгенерируйте тесты ​

Добавьте тесты:

text
> add tests for @src/lib/auth.ts using Vitest - cover the happy path, invalid tokens, and expired sessions

2. Запустите и дорабатывайте ​

Запустите тесты:

text
> run the tests and fix any failures

3. Добавьте краевые случаи ​

Краевые случаи:

text
> add edge case tests for concurrent session limits and malformed JWTs

TIP

Попросите Command Code запустить тесты после их написания — он поймает сбои и будет дорабатывать, пока набор не пройдёт.

Создать pull request ​

Проверьте изменения, сгенерируйте PR и отшлифуйте описание — не выходя из терминала.

1. Проверьте свои изменения ​

Резюме:

text
> summarize the changes I've made to the auth module and check for anything I missed

2. Создайте PR ​

Создайте PR:

text
> create a pull request for these changes with a clear description and test plan

Command Code генерирует заголовок, описание и план тестирования, используя историю коммитов и дифф.

3. Отшлифуйте описание ​

Улучшите PR:

text
> add a section about migration steps and link to the relevant RFC

4. Следите за CI, не спрашивая заново ​

Следите за проверками:

text
> /loop 5m check the CI status on my PR and tell me when it goes green or fails

/loop выполняет задачу сейчас и повторяет её с интервалом. Уберите 5m, и агент сам выберет момент каждой следующей проверки. См. Фоновые задачи.

TIP

Для создания PR Command Code нужен GitHub CLI (gh). Установите и авторизуйте его заранее.

Исправить баг интерфейса по скриншоту ​

Вставьте скриншот сломанного интерфейса прямо в терминал и дайте Command Code найти и исправить проблему.

1. Поделитесь скриншотом ​

Скопируйте скриншот в буфер обмена и вставьте его в терминал или сошлитесь на файл изображения:

Ссылка на изображение:

text
> the modal is broken - here's what QA reported @screenshots/broken-modal.png

2. Определите проблему ​

Command Code анализирует изображение, находит визуальную ошибку (перекрывающиеся элементы, неверные отступы, отсутствующие стили) и определяет ответственный компонент.

3. Примените исправление ​

Исправьте интерфейс:

text
> fix the z-index and padding issues in @src/components/Modal.tsx

TIP

Ссылайтесь на изображения через @path/to/screenshot.png — Command Code читает их как любой другой файл. Чтобы вставить изображение прямо из буфера обмена, нажмите ctrl+v (alt+v в Windows и WSL) — см. Вставка изображений.

Продолжить предыдущие разговоры ​

Продолжите с того места, где остановились, через --continue (самый недавний) или --resume (список разговоров).

1. Продолжите самый недавний разговор ​

Продолжить:

bash
cmd --continue

Это сразу возобновляет ваш последний разговор.

2. Просмотрите и выберите прошлый разговор ​

Список возобновления:

bash
cmd --resume

Показывается интерактивный список:

text
  Modified      # Messages  Git Branch        Summary
❯ 1. 20 hours ago  172       main              Follow this practice and out...
  2. 21 hours ago  13        main              Add the common workflows he...
  3. 22 hours ago  2         main              does this {src/components/u...
  4. 22 hours ago  82        main              pnpm dlx shadcn@latest add ...
  5. 1 day ago     2         ankit/features    all tools support you have
  6. 2 days ago    20        ankit/commands    Update the content in each ...

Управляйте стрелками, Enter — выбрать, Esc — выйти.

Вкус

Ваш профиль вкуса переносится между сессиями — Command Code помнит ваши предпочтения даже в новых разговорах.

Спланировать до реализации ​

Используйте режим планирования, чтобы изучить кодовую базу и продумать подход до того, как изменится хоть один файл.

1. Войдите в режим планирования ​

Запустите режим планирования:

bash
cmd --plan

Или нажмите shift+tab в активной сессии, чтобы переключиться в режим планирования.

2. Опишите, что хотите построить ​

Промпт плана:

text
> design a role-based access control system for the API - explore the current auth setup first

Command Code читает файлы и предлагает план реализации, ничего не меняя.

3. Просмотрите план и выполните его ​

Просмотрите предложенные шаги. Одобрите их, чтобы Command Code реализовал план, или сначала доработайте его.

Только чтение

Режим планирования только читает — Command Code исследует, но не меняет файлы, пока вы не одобрите. См. Режим планирования.

Синхронизировать вкус между машинами ​

Отправьте свой профиль вкуса в облако и загрузите его на другой машине.

1. Отправьте со своей текущей машины ​

Отправьте вкус:

bash
cmd taste push

2. Загрузите на другой машине ​

Загрузите вкус:

bash
cmd taste pull

3. Проверьте свои профили ​

Список вкусов:

bash
cmd taste list

Показываются все профили вкуса, синхронизированные с вашим аккаунтом. Управляйте вкусом в Command Code Studio.

Эквиваленты

cmd taste и npx taste эквивалентны. Полный список — в разделе Команды taste.

Провести ревью pull request ​

Используйте команду /review, чтобы получить разбор PR, не выходя из терминала.

1. Начните ревью ​

Ревью PR:

text
/review 42

Command Code забирает дифф PR, анализирует изменения и выдаёт структурированный разбор.

2. Прочитайте разбор ​

Ревью охватывает качество кода, потенциальные баги, отсутствующие тесты и проблемы стиля.

3. Получите комментарии PR, чтобы ответить на замечания ​

Получите комментарии PR:

text
/pr-comments

Забирает все комментарии PR — комментарии к issue и построчные комментарии ревью — из pull request, связанного с вашей текущей веткой, чтобы вы могли отвечать на замечания прямо в сессии.

4. Оставьте комментарии ​

Комментируйте PR:

text
> add a comment on the PR about the missing error handling in the webhook handler

TIP

Используйте /pr-comments в своей ветке с фичей, чтобы подтянуть все замечания ревью и ответить на комментарии, не выходя из терминала.

Поделиться сессией отладки ​

Опубликуйте сессию как секретный gist на GitHub, чтобы показать коллегам, что вы уже пробовали.

1. Отлаживайте с Command Code ​

Проработайте проблему в обычной сессии: воспроизведите баг, исследуйте, пробуйте исправления.

2. Поделитесь сессией ​

Поделитесь:

text
/share gist

Это публикует сессию как секретный gist через GitHub CLI (gh) и копирует URL gist в буфер обмена.

Общий доступ по ссылке

Общий доступ по ссылке через голый /share перестраивается. Используйте /export, чтобы сохранить сессию в файл.

Писать сложные промпты во внешнем редакторе ​

Нажмите ctrl+g, чтобы открыть свой $EDITOR для многострочных промптов с примерами кода.

1. Откройте редактор ​

Нажмите ctrl+g в строке ввода. Ваш настроенный $EDITOR открывается с временным файлом.

2. Напишите промпт ​

Напишите подробный промпт на несколько абзацев. Добавьте примеры кода, ограничения или ссылки. Сохраните и закройте редактор.

3. Отправьте ​

Содержимое редактора становится вашим промптом и отправляется автоматически.

Настройка

Задайте редактор: export EDITOR=vim или export EDITOR="code --wait". См. Настройка редактора.

Что дальше ​

Источник

Сверено с оригиналом 13 ноября 2026.