Своих скиллов для AI-агента было 20, осталось 3. И это не про минимализм

Гонял прототип интерфейса, модель третий раз подряд выдавала один и тот же паттерн. Начал раскручивать: почему именно так, покажи другие варианты, объясни выбор. А она сослалась на мой же скилл. Там написано использовать современные UI-паттерны, вот она и использует.

Эту строчку я туда положил сам.

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

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

Формулировка в том скилле звучала как усиление. Что-то вроде «при проектировании интерфейса используй современные UI-паттерны, ориентируйся на гайдлайны Apple, предлагай решения в актуальных трендах». Читается как «делай хорошо».

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

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

Через мои руки прошло штук полтораста скиллов. Ставил, смотрел, сносил. Был период, когда я обмазал агента тридцатью штуками под GameDev, половина дублировала другую половину, и вместо помощи я получил навигацию по собственному зоопарку. Это тот самый Defold, где я написал 57 тысяч слов инструкций, так что зоопарк вышел знатный. Своих самописных из этих полутора сотен было около двадцати.

Логика была простая, и я её тогда даже не проговаривал. Модель глупая. Сделает не так, как я задумал. Значит надо прописать всё заранее, чтобы не оставлять ей выбора.

«Да я с гитхаба сорок штук накачал, пусть лежат, хуже не будет». Примерно на этом уровне я и рассуждал.

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

Тут надо развести две вещи, иначе дальше будет каша.

Первое: скиллы для агентского конвейера. У вас есть цепочка действий, например найди упавший тест, запусти его, разбери причину падения, почини. Цель инженера в такой цепочке одна: детерминированность результата. Скилл там работает гардрейлом, режет разрушительные действия и ведёт агента по одной дороге, без самодеятельности. Процентов девяносто того, что я пишу сейчас, идёт именно в такие конвейеры. Философия там простая: все средства хороши, пока кошелёк позволяет и пока бенчмарк не дошёл до нужной зелёной отметки. Пишите хоть что.

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

Второе: скиллы для личной работы с агентом, вайб-кодинг или помощник. Тут всё разворачивается. Формулировка становится «не самовольничай, стоит спросить меня». Человек в этой цепочке не помеха. Его как раз и прокачивают.

Одна и та же технология, а цели противоположные. В конвейере скилл пишут, чтобы вас не спрашивать. В личной работе, чтобы спрашивать вас чаще.

Про конвейеры дальше не будет. Там своя механика, свои бенчмарки и группы по семь-восемь скиллов на цепочку, и это тема отдельного материала. Дальше только про личное. Если вам ближе конвейеры, пост про harness engineering закрывает соседнюю половину вопроса.

Если развести по цели, личные скиллы бывают двух видов. Одни отвечают за вас. Другие вас допрашивают.

Ответчик выглядит так: «ко всем продуктам делай базу на Supabase, сам продумай связь полей в разных таблицах, расставь индексы и типы колонок». Он сделает. Реально сделает, и в моменте вы почувствуете себя быстрым. Дерьма нахватаетесь потом, когда встанет вопрос расширения или масштабирования и окажется, что схему проектировал тот, кому с ней не жить.

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

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

Нулевой шаг появился после той истории с прототипом. Вопрос к себе: этот скилл будет отвечать за меня или допрашивать меня? Если первое, дальше можно не идти.

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

Чтобы было понятно. Недавно я разбирался с Sentry (система мониторинга ошибок), хотел научить агента им адекватно пользоваться. Работал я с ним очень давно, и многие вещи были для меня в новинку. Писать по типу «дорогой Claude, на тебе Sentry, вот те MCP, разбирайся сам, чё там бурлит и не работает» я не стал.

Вместо этого делаю первичные тезисы и параллельно гоняю дип-ресерчи через AI. Не советую сгружать книгу или любой другой найденный контент целиком, есть нехилый шанс сделать хуже. Всякие паттерны «загрузи book, получи скилл» полная туфта. С готовыми тезисами, которые вы сами вычитали, идёте в сессию по созданию скилла.

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

Глобально на машине стоит один Superpowers. Чужой фреймворк, гоняет агента через brainstorming, спеку, план, TDD и ревью. В счёт своих я его не беру, но посмотрите, как он устроен: он ничего за вас не решает и не даёт начать, пока вы не ответили на его вопросы. Тоже допросчик.

Своих осталось три. Два работают, третий пишется прямо сейчас.

Первый закрывает SVG и Lottie. Я не умею делать анимации и картинки. Даже самые всратые. Claude умеет.

Второй тот самый, с которого всё началось: дизайн интерфейсов и макеты. Я его не снёс, я его развернул. За эти месяцы я стал чуть лучше понимать дизайн, и философия скилла поменялась целиком. Раньше внутри было примерно так:

При проектировании интерфейса используй современные UI-паттерны, ориентируйся на гайдлайны Apple. Предлагай решения в актуальных трендах.

Сейчас примерно так:

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

Он не рисует, а находит проблемные места и объясняет, в чём с ними беда. Последняя строка это тот самый «спроси меня» из предыдущей секции, и стоит она там не для красоты. Без неё скилл сползает обратно в режим «вот тебе готовый экран, пользуйся».

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

Но внутрь я заложил не только транспорт. Там логика авто-RCA (root cause analysis). Скилл не останавливается на причине падения, он идёт к первоисточнику её рождения: лезет в спецификации, которые формировались по этой фиче, смотрит, как я их ревьюил, разбирается, почему другой агент это упустил. И начинает меня душнить. Почему было сделано так. Что ты имел в виду вот здесь. Ты вообще читал это, когда апрувил.

По сути я собираю себе постмортем на одного человека. В компаниях после громкого падения садятся с холодной головой и разбирают все причины, чтобы не допустить такого впредь. Тут то же самое, только разбирают меня.

И вот что бросается в глаза, когда смотришь на эти три штуки рядом. Ни одного скилла про код, архитектуру, тесты или базы. Мне не нужен скилл по планированию автотестов и подходу TDD, я это организую сам. Хорошему архитектору скиллы вообще не упёрлись: он опишет в спецификации, как связаны модули, как поведёт себя база под нагрузкой, какие предусмотрены запасные каналы, как сработает деградация, и почему эта сраная кнопка должна быть тут, а вот не в том углу. Я не такой классный. Три моих скилла лежат ровно по границе моей компетенции: дизайн, картинки, наблюдаемость. Там, где насмотренности нет и быстро её взять негде.

Уверен, что столкнусь ещё с рядом скрытых слабостей, например с маркетингом и продвижением. Но пока обкладываю себя скиллами только там, где начинается «ежедневность».

Трещин хватает, и начну с самой неудобной для себя.

SVG и Lottie ничему меня не учат. И не будут. Рисовать я не научусь, этот скилл живёт по старым правилам, как заместитель, и оставил я его сознательно. Вся затея ведь не про то, чтобы думать за всё подряд. Она про то, куда уходит освободившийся ресурс, и на рисование я его тратить не собираюсь. Но сама идея каждой иконки всё же лежит у меня в голове, просто реализация идёт не моими руками.

Superpowers избыточен процентах на пятнадцать задач. Прогоняет какую-нибудь банальщину через полный TDD и жжёт токены на ровном месте. Когда делаю сырой MVP, прототип на коленке из говна и палок, просто вырубаю его и беру голого агента.

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

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

Посчитайте свои скиллы отдельно от чужих. Это разные болезни: чужие лечатся удалением, свои разговором с собой.

По каждому спросите: он отвечает за меня или допрашивает меня.

Проверьте себя, а не скилл. Стали ли вы сильнее в этой теме за то время, что он у вас лежит? Можете сейчас сформулировать без него то, что он формулирует за вас? Если нет, он не помогает, а прячет проблему, и чем дольше лежит, тем дороже обойдётся.

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

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

Скиллов у меня, скорее всего, снова станет больше. Просто теперь каждый обязан меня чему-то научить.