Слэш-команды терминального агента образуют статический справочник - тот набор, который поставляется с продуктом и описан официально. Отдельно от него живут команды, приходящие с обновлениями и с установленными навыками; они вынесены в следующую главу, чтобы не смешивать три разные поверхности - редактор, командную строку и возможности аккаунта. Статический набор ценен именно предсказуемостью: на него можно ссылаться в командной инструкции, не выясняя у каждого, что у него установлено.
Это разделение полезно не ради аккуратности, а ради практики. Команда, увиденная в чужой статье про редактор, может отсутствовать в терминале, и наоборот. Когда справочники разведены, вы сразу знаете, где искать и чего ожидать: статический список описывает базу, динамический - то, что зависит от вашей установки. Смешанный список хуже обоих: по нему нельзя понять, отсутствует команда из-за версии, из-за поверхности или из-за того, что нужный набор просто не установлен.
Полезно один раз сгруппировать команды по назначению. Ниже такая карта: работа с режимами и моделью, управление сессиями и историей, вывод и диагностика, оболочка и обзор изменений, настройка интерфейса и терминала, служебные действия. Внутри группы команды легко вспоминаются по смыслу, а не по алфавиту - именно так их и ищут в реальной работе: человек помнит, что хотел сделать, а не как это называется.
| Группа | Команды | Назначение |
|---|---|---|
| Режимы и модель | /model, /plan, /ask, /debug, /max-mode | Выбор модели и переключение режима работы |
| Автономность | /run-everything и его псевдоним /auto-run | Переключение и просмотр уровня автономности |
| Сессии | /rename, /resume, /fork, /rewind, /clear | Создание, продолжение и ветвление работы |
| Контекст | /summarize и псевдоним /compress | Сжатие истории при длинной сессии |
| Оболочка | /shell с псевдонимами /sh и /run | Короткие проверки без выхода из разговора |
| Диагностика | /logs, /about, /copy-request-id, /copy-conversation-id | Журналы и идентификаторы для обращения в поддержку |
| Интерфейс |
| /vim, /line-numbers, /show-thinking, /status-indicators, /setup-terminal |
| Настройка ввода, вывода и интеграции с терминалом |
| Служебные | /help, /feedback, /update, /logout, /exit и /quit | Справка, обратная связь, обновление и выход |
|---|
Отдельно стоит отметить пары, где одна команда является псевдонимом другой. Они существуют по историческим причинам: имя менялось, а старое оставили ради совместимости. В скриптах и инструкциях лучше использовать основное имя - псевдоним однажды может исчезнуть, и это будет тихая поломка в самом неудобном месте. Тихая - потому что неизвестная команда обычно не роняет сессию, а просто не делает того, что от неё ждали, и человек замечает это не сразу.
Практическая привычка, которая экономит время: набирать слэш и смотреть подсказку вместо того, чтобы вспоминать. Живое меню отражает вашу версию, ваши плагины и возможности вашего аккаунта - то есть то, что реально доступно. Память отражает статью, прочитанную полгода назад, и статью, написанную для другой поверхности. Разница между этими двумя списками и есть источник большинства вопросов вида почему у меня этого нет.
Есть и обратная сторона динамического списка: он может быть длинным. Поэтому полезно один раз выбрать себе десяток команд, которыми вы пользуетесь ежедневно, и довести их до рефлекса. Обычно это проверка состояния, переключение режима, просмотр изменений, сжатие истории, запуск обзора и выход. Остальное ищется по мере надобности - и именно поэтому важно знать группы: поиск по смыслу работает и в незнакомой версии.
Команды работы с сессией стоит различать по цене, а не по названию. Начать новую сессию значит потерять весь набранный контекст: это дешёвая операция, когда предыдущая задача закрыта, и дорогая, когда вы просто устали от длинной переписки. Ветвление сохраняет исходную сессию нетронутой и потому подходит для попытки, в которой вы не уверены. Возврат к предыдущему сообщению отматывает разговор назад. Сжатие истории уменьшает контекст, но уменьшает вместе с ним и подробность: детали, которые агент помнил дословно, после сжатия остаются пересказом. Отсюда практическое правило: сжимать раньше, чем это станет вынужденной мерой.
Диагностическая группа нужна ровно один раз, но тогда она нужна сразу. Когда поведение выглядит неправильным, первое, что делают, - забирают путь к журналу отладки, идентификатор запроса и идентификатор разговора. Эти три вещи превращают сообщение сломалось в обращение, на которое можно ответить. К ним добавляют вывод о версии, системе и аккаунте: ответ на один и тот же вопрос зависит от сборки, и без версии разговор с поддержкой начинается с уточнений. Собирать всё это стоит до перезапуска, а не после - перезапуск часто и есть то, что стирает интересную часть журнала.
Инженерный вывод простой: справочник команд - это карта возможностей, а не список для заучивания. Знать группы полезнее, чем помнить имена: зная группу, вы находите нужное за секунды даже в новой версии, где часть имён изменилась. А знать цену команды полезнее, чем знать её синтаксис.
Типичные провалы предсказуемы. Использовать псевдоним в командной инструкции и однажды получить тихую поломку. Искать команду редактора в терминале. Заучивать список вместо использования подсказки. Начинать новую сессию там, где хватило бы ветвления. И строить процесс на команде, доступность которой в своей версии не проверена.