Команды ZCode: как сохранить повторяющиеся промпты и вызывать их через /
Команды вызывают встроенные возможности ZCode Agent и одновременно позволяют сохранять промпты, которыми вы пользуетесь часто. Сохранив промпты для ревью кода, сообщений коммита, проверок релиза, объяснения файлов и подобных повторяемых задач, вы сможете вызывать их из поля ввода через /.
Команды спроектированы под рабочий процесс ZCode Agent. Для ежедневной работы внутри ZCode сохраняйте промпты, которые ваша команда повторяет регулярно, — так первопартийный агент сможет исполнять стабильные рутины.
Использование в ZCode Agent
- Введите
/в поле ввода — откроется панель команд. Она разбита на группы Commands и Skills, можно продолжать вводить текст для фильтрации. - Выберите команду или продолжайте набирать, чтобы отфильтровать по имени команды.
- Если команда ожидает аргументы, добавьте путь, имя модуля или дополнительную инструкцию после неё.
Сейчас в ZCode Agent входят две встроенные команды:
| Команда | Назначение |
|---|---|
/goal | Показать, задать, заменить, поставить на паузу, возобновить или очистить цель текущей сессии — полезно для долгих задач |
/compact | Сжать контекст текущего разговора, сохранив ключевую информацию, — полезно для продолжения длинных бесед |
Например, используйте /compact, чтобы почистить контекст в долгой задаче, или /goal, чтобы удерживать агента на долгосрочной цели. Чтобы вызвать скилл, используйте $ или выберите его из группы Skills в панели /.
Создание команды
Откройте Commands в настройках ZCode, затем создайте новую команду и заполните поля:
| Поле | Описание |
|---|---|
| Scope | Выберите User (доступно во всех воркспейсах) или Workspace (только текущий проект) |
| Name | Имя команды, после сохранения вызывается как /имя-команды |
| Description | Необязательное короткое описание, которое показывается в панели выбора команд |
| Argument hint | Необязательная подсказка по параметру, например <file-path> |
| Prompt | Содержимое промпта, которое отправляется агенту при запуске команды |
Пользовательские команды хранятся как .md-файлы в ~/.zcode/commands (команды уровня воркспейса лежат в каталоге проекта). После сохранения вызывайте команду через /имя-команды в поле ввода задачи.
Импорт из внешнего агента
Если вы уже поддерживаете команды во внешнем агенте вроде Claude Code, пересоздавать их в ZCode не нужно. На странице Commands нажмите Import commands from external Agent в правом верхнем углу, чтобы перенести существующие команды внешнего агента прямо в ZCode.
- Откройте страницу Commands в настройках ZCode.
- Нажмите Import commands from external Agent в правом верхнем углу.
- Отметьте нужные команды внешнего агента, подтвердите — и они импортируются в ZCode.
Импортированные команды ведут себя как созданные вами: они появляются в списке команд, вызываются через /имя-команды, а их имя, описание, подсказку по аргументам и промпт можно дальше редактировать внутри ZCode.
Замечания по использованию
Используйте команду, когда нужно сохранить простой промпт. Если же рабочему процессу нужны скрипты, шаблоны или файлы-примеры, рассмотрите вместо этого скилл (Skill).
Заметка практика: Команды в ZCode — это, по сути, более лёгкий аналог кастомных слеш-команд Claude Code и «prompt snippets» Cursor, и миграция между ними проходит без боли. Главное практическое правило выбора между командой и скиллом такое: команда = один промпт без состояния, скилл = сценарий с шаблонами/чек-листами/примерами. Сэкономит массу времени две встроенные команды:
/compact— настоящий спасатель при длинных сессиях на GLM-5.2, когда контекст раздувается и агент начинает тупить; жмите его, прежде чем переходить к новому большому этапу задачи. И/goal— отлично удерживает агента от «расползания» в долгих многочасовых рефакторингах: задали цель один раз и агент сам возвращает себя к ней после ответвлений.
Локализованный гайд по официальной документации ZCode. Оригинал на английском.
