Что такое слеш-команды в Cloud Code

Когда мы работаем с Cloud Code, у нас есть так называемые слеш-команды. Что это такое? Это команды, которые начинаются со знака слеш (/) и далее идёт имя команды.

Существует два типа команд: встроенные слеш-команды и кастомные слеш-команды, которые мы можем создавать сами.

Как это работает? Многие слеш-команды мы уже знаем и даже использовали. Просто мы не знали, что это называется именно слеш-командами. Для того чтобы использовать какую-либо слеш-команду, мы должны поставить знак слеш и клавишами вверх-вниз выбрать нужную команду. Например, мы можем вызвать команду Help. Здесь нам покажут все слеш-команды, которые мы можем использовать для работы с Cloud Code.

Самое важное, что здесь мы можем сделать — это создавать так называемые кастомные слеш-команды. Для чего это нужно? Чаще всего это нужно для того, чтобы написать заготовку какого-то промпта, который вы сможете в дальнейшем использовать для работы с вашим проектом. У вас появятся не только встроенные команды, но и вы сможете выбрать какую-то свою команду, которая будет что-то делать в вашем проекте.

Создание кастомных слеш-команд

Давайте посмотрим, как создавать кастомные слеш-команды. Для кастомной слеш-команды синтаксис будет такой: имя команды и опционально можно передавать аргументы к этой команде.

Для того чтобы создать слеш-команду, она может находиться у нас на двух уровнях. Либо уровень проекта — эта команда будет применяться только в текущем проекте, либо на уровне персональных команд — на уровне пользователя это можно тоже создавать.

В документации есть инструкции, как мы можем это сделать и где это находится. В папочке .cloud/commands — в случае с проектом. В случае же с пользователем точно так же, только в домашней директории пользователя операционной системы: .cloud/commands — команды, которые у вас будут использоваться.

Давайте посмотрим, как это можно сделать на уровне проекта. Создаётся это довольно просто. Предположим, я работаю в директории My Project. Вот он, мой проект. Здесь запущен Cloud Code.

Для того чтобы я мог использовать кастомные команды, я должен создать с помощью команды mkdir .cloud/commands такую структуру директории. Если она у вас есть, вы просто это не делаете. Либо вы можете это создать вручную с помощью новой директории и создать такую структуру директорий .cloud и commands.

Я перейду в директорию моего проекта и выполню эту команду. У меня создалась заготовка для команд, которые мы можем использовать.

Команды — это обычные текстовые файлы, которые вы можете редактировать для того, чтобы с ними работать. Нам предлагают создать файл с произвольным названием на английском языке в формате Markdown. Это всё создаётся в формате Markdown, и вы можете прописать там тот промпт, который будет выполнять эта команда.

Всё достаточно просто. Либо с помощью Linux команды это всё можно сделать, взять просто текст и разместить в этот файл. Либо вы можете вручную создать этот файл. Допустим, назову её test.md — обычный текстовый файл в формате Markdown.

Пишем здесь какой-то промпт, например: "Расскажи мне о текущем проекте". Здесь вы можете вписать всё, что угодно, что вам будет нужно, какая команда вам будет нужна и что должна сделать эта команда при её вызове. Просто пишем текстовым языком, как это должно происходить.

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

Теперь, когда вы попробуете набрать слеш, то у вас появляется эта самая команда test. Как вы видите, в скобках здесь указан уровень проекта. Это означает, что эта команда выполняется на уровне проекта.

Давайте её вызовем и посмотрим, что произойдёт. Он увидел, что ему надо рассказать о текущем проекте, и он начинает его изучать. Он выдал результат: что это такое, что за проект, из чего он состоит, как используется и так далее. Здесь вы просто пишете человеческим языком, что должен сделать Cloud Code при вызове этой команды.

Точно так же, если вы хотите, чтобы эта команда была доступна на уровне всех проектов, вы переходите в домашнюю директорию вашего пользователя cd ~. У меня здесь есть папка .cloud, так как у меня всё установлено. Мы в неё переходим и точно так же создаём здесь mkdir commands и создаём в них текстовые Markdown файлы с содержимым слеш-команд, которые вы сможете использовать независимо от того проекта, где вы сейчас находитесь. Это будут команды на уровне пользователя.

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

Это может делать некое подобие программы. Вы можете здесь написать некий скрипт, что должен сделать для вас Cloud Code, а потом вызывать её через какой-то SDK интерфейс. Например, через Python скрипт вызвать эту команду, не набирая там какой-то большой кусок текста инструкции — это всё будет уже встроено.

Либо через CLI интерфейс, через командную строку это тоже можно вызвать, не заходя напрямую в Cloud Code. Это даёт достаточно большое удобство при использовании Cloud Code. Вот это основы создания кастомных слеш-команд в Cloud Code, которые вы можете использовать.