Навык агента — это не длинный промпт

Самое частое заблуждение: «навык — это инструкция, которую я один раз написал, чтобы не повторять её каждый раз».

Инструкция там действительно есть. Но работает не она.

Главное в навыке — описание, когда он не должен включаться.

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

Что отличает рабочий навык от длинного промпта:

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

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

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

Дальше разберу по одному конкретные навыки: какие задачи закрывают и где ошибался при сборке.