Перейти к содержимому

Слеш-команды

Слеш-команды — это специальные инструкции, которые начинаются с / и вводятся в поле чата. Они позволяют быстро запускать определённые рабочие процессы: компактировать контекст, создавать новую задачу, устанавливать шаблоны и выполнять собственные сценарии.

Команда Описание
/goal Открывает панель Goal или запускает долговременную цель, которую Kodik выполняет в нескольких ходах. Подробнее
/compact Суммирует и сжимает текущий разговор, освобождая контекстное окно. Подробнее
/newtask Создаёт копию текущего разговора в виде новой задачи («Копия …») для ответвления работы. Подробнее
/create-skill Запускает мастер создания нового Skill для текущего проекта или глобально
/create-command Создаёт новую пользовательскую слеш-команду (.md-файл в .kodik/commands/)
/create-rule Создаёт новый файл правил для управления поведением агента
/create-hook Создаёт хук жизненного цикла — shell-команду, привязанную к событию агента. Подробнее
/install-template Запускает управляемый процесс установки шаблона из Kodik Marketplace
/analyze-workspace Анализирует рабочую директорию и предоставляет сводную информацию о проекте

Помимо встроенных команд, вы можете создавать собственные слеш-команды — это обычные Markdown-файлы, которые Kodik обнаруживает и предоставляет агенту.

Команды загружаются из нескольких мест. При конфликте имён побеждает источник с более высоким приоритетом:

Расположение Область
<выбранный-workspace>/.kodik/commands/ Workspace выбранного чата (наивысший приоритет)
<выбранный-workspace>/.agents/commands/ Совместимость workspace, только чтение
~/.kodik/commands/ Глобальный уровень пользователя
~/.agents/commands/ Глобальная совместимость, только чтение
Директория команд установленного плагина Namespaced-команда плагина

Точная корневая папка определяется выбранной сессией чата, в том числе в multi-root и remote-окнах. Команды из .agents можно просматривать в Settings, но нельзя изменять; workspace-команды совместимости неактивны до предоставления доверия workspace. Другие файлы .agents игнорируются. При совпадении идентификаторов действует приоритет таблицы, а дубликаты одного уровня помечаются как неоднозначные и не добавляются в меню /.

Kodik обнаруживает и записывает собственные команды только в строчной .kodik/commands. Uppercase-каталоги Commands не перемещаются, не объединяются и не удаляются; они остаются неактивными. Нужное содержимое перенесите вручную в строчный каталог. Совместимые .agents/commands остаются доступными read-only источниками.

Kodik не переходит по символическим ссылкам внутри принадлежащих ему путей команд и плагинов. Связанные корни, категории, файлы команд, манифесты и конфигурация плагинов отображаются как неактивные. Чтобы команда появилась в меню / и могла управляться Kodik, скопируйте её в каноническую строчную директорию вместо создания ссылки.

Файл команды — это .md-файл, имя которого (без расширения) становится именем команды. В файле может быть опциональный YAML-фронтматтер:

---
name: deploy
title: Deploy to staging
description: Собирает проект и деплоит в стейджинговое окружение
argument-hint: "[branch]"
mode: code
---
Собери проект, запусти тесты и задеплой ветку `$ARGUMENTS` в стейджинг.
Если тесты упали — остановись и сообщи о проблеме.

Поддерживаемые поля фронтматтера:

Поле Описание
name Имя команды (по умолчанию — имя файла без .md)
id Стабильный идентификатор команды (по умолчанию — name)
title Человекочитаемое название, отображаемое в UI
description Краткое описание команды
argument-hint Подсказка для аргументов, отображаемая в меню автодополнения
mode Режим выполнения (например, code, plan, ask)

Команды, поставляемые плагинами, именуются по схеме pluginId:commandName. Используйте полное имя, например /pluginId:commandName, чтобы Kodik выбрал нужный плагин. Меню слеш-команд вставляет полное имя автоматически. Подробнее о плагинах — в разделе Плагины и Marketplace.