Лабораторная 4: делаем свой навык для ИИ-помощника

Выберите повторяющуюся задачу, опишите её инструкцией в отдельном файле в папке, которую читает ваш инструмент, и дайте короткое имя. Затем вызовите команду в чате и сравните результат с ожидаемым. Формат и папка зависят от инструмента, шаги практики одинаковы. Начните с самой простой задачи.

Для практики возьмём такую: «объясни файл простыми словами». Её удобно проверять, потому что вы сами видите, правильное ли объяснение.

Создайте учебную папку и откройте в ней агента. Затем попросите его подготовить два файла:

Создай в этой папке два маленьких учебных файла:
hello.py с одной строкой, которая печатает приветствие,
и price.txt с короткой формулой цены: «цена = 10 * 3».

Агент может спросить разрешение на создание файлов: для учебной папки это нормально, отвечайте «да». Если он добавил в файлы лишние комментарии или длинное приветствие, ничего страшного, учебным файлам хватит и пары строк.

Вы увидите: в папке два файла, hello.py и price.txt.

Опишите, когда навык применяется, что нужно сделать по шагам и как выглядит готовый результат. Добавьте ограничения и один короткий пример. Инструкция должна быть понятна новому сотруднику без устных пояснений: если вам пришлось бы ещё что-то объяснять, допишите это в файл.

По описанию в шапке агент решает, подключать ли навык, а «Пример результата» фиксирует форму ответа. Частая ошибка: расплывчатое описание вроде «Помогает с файлами», такой навык агент не узнает.

---
name: explain-file
description: Объясняет простыми словами, что делает указанный файл и что в нём можно безопасно менять. Используй, когда просят объяснить, разобрать или пересказать файл.
---

# Что сделать
1. Прочитай файл, который назвал пользователь.
2. Скажи одной фразой, что файл делает.
3. Перечисли его части по порядку, по одной строке на часть.
4. Отдельно напиши, что можно безопасно менять, а что лучше не трогать.

# Ограничения
- Файл не меняй.
- Пиши без жаргона. Если термин нужен, объясни его в скобках.

# Пример результата
Файл: hello.py
Что делает: печатает приветствие.
Части: одна строка с командой печати.
Можно менять: текст приветствия.

Вы увидите: инструкция помещается на один экран и не требует устных пояснений.

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

Положите файл в папку по таблице и вызовите:

Gemini CLI умеет и отдельные команды. Файл .gemini/commands/explain-file.toml:

description = "Объясняет файл простыми словами"
prompt = "Прочитай файл {{args}} и объясни простыми словами, что он делает. Файл не меняй."

Вызов: /explain-file hello.py.

Вы увидите: агент прочитал hello.py и ответил по структуре из вашей инструкции.

Запустите её на учебном примере с известным правильным ответом и сравните результат. Затем запустите на втором примере, чтобы убедиться, что она не подогнана под первый. Если результаты плавают, уточните инструкцию, добавив недостающее ограничение. Хорошая команда даёт предсказуемый результат на разных данных, а не только на удачном примере.

1. Вызовите навык для hello.py. Вы знаете, что файл печатает приветствие, значит, правильный ответ вам известен.
2. Вызовите его для price.txt. Там формула цены, и объяснение должно быть другим по смыслу, но тем же по форме.
3. Повторите вызов для hello.py ещё раз и сравните с первым ответом.

Если форма ответа каждый раз разная, добавьте в инструкцию строгий порядок: «всегда отвечай четырьмя строками: Файл, Что делает, Части, Можно менять».

Вы увидите: оба ответа построены по одной схеме, а содержание верное.

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

Например, положите текст инструкции в файл docs/explain-file.md и каждый раз пишите:

Прочитай файл docs/explain-file.md и выполни эту инструкцию для файла hello.py.

Если агент отвечает своими словами и пропускает пункты, добавьте в запрос «прочитай файл целиком и выполни все пункты по порядку». Проверка та же, что в предыдущем шаге: два файла, одинаковая форма ответа.

Подробнее про общий файл правил в модуле про файл AGENTS.md. Про то, где навыки есть, а где нет, в модуле про навыки и команды.

Вы увидите: даже без встроенных команд вы вызываете одну и ту же инструкцию, а не пишете её заново.

• Навык или запасной файл с инструкцией создан
• Он вызывается по слову (или по имени файла)
• На двух разных файлах ответ построен по одной схеме
• Повторный вызов даёт похожий результат
• Вы можете объяснить, чем навык отличается от обычного промпта