СтатьиQlikИнструментыUI Kit Поиск RSS →
← Все статьи
скилыClaude CodeCursorAI skillsdescriptionтриггерыMOEXкотировкиавтоматизацияИИЧернов пишет

description решает всё: триггеры скила

description решает всё: триггеры скила

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

Кажется, что дело в коде или в том, что скил “не подключился”. Почти никогда. Дело в одной строке - в описании, в description. Это первое, что читает ассистент, и именно по нему решает, звать скил или нет. Слабое описание - и скил живёт, но молчит.

Разберём на паре скилов, которые легко спутать: курс валют ЦБ (он у нас уже был в прошлом уроке) и котировки акций Московской биржи. Запросы похожи - “сколько стоит доллар” и “сколько стоит Сбербанк”, - и без аккуратных триггеров ассистент будет лезть не туда.

В чём идея

Ассистент выбирает скил не по названию папки и не по коду внутри. Он читает description и сопоставляет с твоей просьбой. Поэтому описание - это не пересказ того, что скил умеет. Это контракт срабатывания: КОГДА этот скил звать.

Из этого следуют два правила хорошего описания.

Первое - точные триггеры. Не “работа с биржей”, а живые формулировки, которыми реально спрашивает человек: “котировка Сбербанка”, “почём акции Газпрома”, “цена SBER на бирже”. Чем ближе описание к настоящей фразе пользователя, тем увереннее срабатывание.

Второе - отсечение чужого. Когда рядом есть похожий скил, мало описать свою зону - надо явно отодвинуть соседнюю. У валютного скила в описании стоит “про курс валют к рублю”, у биржевого - “про цену акции, НЕ про курс валют”. Эта короткая отсечка и разводит два скила: валюта к рублю идёт в один, цена акции компании - в другой. Ассистент перестаёт гадать.

Почему это работает именно так? Современная LLM хорошо сопоставляет смысл запроса с описанием, но плохо угадывает твои негласные намерения. Если две зоны пересекаются в описаниях, она честно выбирает наугад. Разведёшь границы словами - выбор станет однозначным. Контракт срабатывания - это и есть способ убрать догадки.

Как себе сделать

Не пиши скил руками - отдай своему ассистенту (Claude Code, Codex, Cursor, Gemini - любому). Он сам разберётся, куда положить файл и как настроить. Скопируй промпт:

Создай мне скил, который по запросу говорит биржевую цену акции на Московской бирже (MOEX).
Срабатывай на просьбы про акции и котировки: "котировка Сбербанка", "почём акции Газпрома",
"сколько стоит акция Лукойла", "цена SBER на бирже". По названию компании определяй тикер
(Сбербанк - SBER, Газпром - GAZP, Лукойл - LKOH), по умолчанию SBER.
Данные бери из открытого ISS API Московской биржи; цена - последняя сделка, а если торги
закрыты - цена закрытия прошлого дня.
Важно: разведи триггеры с моим скилом про курс валют (cbr-rate). В описании этого скила явно
укажи, что он про цену акций и НЕ про курс валют к рублю; а в cbr-rate - наоборот.
Не завязывайся на конкретную ОС или на Python - получай данные любым инструментом в системе.
Ответ давай одной фразой: тикер, название компании и цена в рублях.

Как понять, что заработало: задай подряд два похожих вопроса - “курс доллара” и “почём акции Сбербанка”. Если первый ушёл в валютный скил, а второй в биржевой, и ассистент ни разу не перепутал - триггеры разведены, контракт срабатывания держит. Если путает - вернись в описания и усиль отсечку чужого.

И это главный навык всей серии про скилы: скил начинает работать не когда написан код, а когда описание точно говорит, КОГДА его звать.

Смотреть полностью

Коротко