🧩 Навык агента — это не длинный промпт
Самое частое заблуждение: «навык — это инструкция, которую я один раз написал, чтобы не повторять её каждый раз».
Инструкция там действительно есть. Но работает не она.
Главное в навыке — описание, когда он не должен включаться.
Звучит странно, пока не соберёшь второй десяток. Дальше начинается: на простой вопрос агент запускает тяжёлую процедуру на пять шагов, три навыка срабатывают одновременно и спорят друг с другом, а на действительно рискованной задаче не включается ни один. Инструкции при этом написаны прекрасно.
Что отличает рабочий навык от длинного промпта:
• 🎯 Условия срабатывания и условия молчания. Не только «применять, когда…», но и «не применять, когда…». Второй список обычно длиннее и важнее. • 🚪 Отделено «сработал» от «применён». Навык может определить, что он подходит, и на этом остановиться — спросить, нужен ли он вообще. До согласия он не читает свою же процедуру и ничего не меняет. • 📎 Тяжёлое вынесено наружу. В самом навыке — короткая логика, подробности в отдельных файлах, которые читаются только когда действительно понадобились. Иначе каждый запуск тащит килобайты текста, которые ни на что не влияют. • 🚧 Полномочия названы явно. Согласие на процедуру не даёт права лезть в боевой контур, читать секреты или расширять задачу. Это пишется прямо, иначе однажды будет истолковано иначе. • 🤝 Умеет уступить проекту. Если у проекта уже есть свои правила на ту же тему — навык молча пропускает себя, а не дублирует. Два регламента об одном хуже, чем один.
И принцип, который экономит больше всего времени: не грузить весь набор сразу. Один основной навык плюс один-два вспомогательных. Собранный стек из десяти штук работает медленнее и хуже, чем три подходящих.
Проверить свои навыки можно быстро. Возьмите любой и ответьте на два вопроса: в каком случае он не должен сработать, и что произойдёт, если он сработает не вовремя. Нет внятного ответа — это ещё промпт, просто длинный.
Дальше разберу по одному конкретные навыки: какие задачи закрывают и где ошибался при сборке.
