AiHub ✨ Приручаем ИИ | Вайб-кодинг | Ai-first development

Скилл для грамотной разработки Telegram-ботов 📱 Представляете, столкнулся с тем, что нет дельных скиллов для разработки телеграм-ботов. Оно и понятно: в большинстве случаев с базовым функционалом агенты справляются самостоятельно даже без документации. Но когда речь заходит о современном функционале Telegram Bot API, например rich messages или стилях кнопок, даже самые свежие модели о нём не знают, часто используют старые методы или вообще делают не самые приятные механики взаимодействия с пользователем. Особенно остро это стало ощущаться с Bot API 10, где завезли много новых полезностей. Решил оперативно исправить это недоразумение и сделал комплексный скилл, который включает в себя: • сверку с живой документацией Telegram: агент сам узнаёт текущую версию Bot API, читает всё, что поменялось, и страницу каждого метода, который трогает. Не по памяти, а по первоисточнику; • проверку библиотеки в проекте: умеет ли ваша версия aiogram, grammY, python-telegram-bot или любой другой нужный метод и параметр. Если нет, подскажет обновиться или вызвать метод напрямую; • 11 справочников по продакшен-разработке: вебхуки и доставка без дублей, кнопки и меню, безопасность, лимиты и рассылки, ошибки, оплата в Stars, Mini Apps, AI-боты со стримингом ответа и чек-лист перед релизом; • правила Telegram для разработчиков: нужный пункт агент достаёт дословно, будь то обязательства, запреты или комиссии. 👁‍🗨 Полезности: • Определяет ловушки между версиями. В июле (10.2) эфемерные сообщения отправлялись с одними параметрами, в августе (10.3) их заменили новым объектом. По памяти агент напишет июльский вариант, скилл палит замену. • Проверяет метод, а не просто имя. Не "есть ли имя где-то в библиотеке", а принимает ли его именно этот метод. На aiogram, grammY и python-telegram-bot ни одного ложного "да" на 1110 проверках. • Видит то, чего даже в оглавлении документации не всегда есть. Весь Rich Messages Telegram вынес на отдельную страницу, и обычный поиск его не находит. • Знает спрятанные лимиты. Черновик ответа при стриминге можно обновлять не чаще 20 раз за 5 секунд и 40 за 30 секунд на чат. Обновляешь "несколько раз в секунду", и ответ замирает на середине. • Знает про деньги. Включили темы в личке, и Telegram забирает 15% со всех покупок за Stars в боте. А стриминг ответов с версии 9.5 работает и без тем. • Любой язык и фреймворк. Скрипты на чистом Python без зависимостей, проверено на Linux и Windows (на Mac тоже должно работать, но проверить не успел). • Проверен вслепую. На трёх задачах-ловушках агент со скиллом не сделал ни одной фактической ошибки, без скилла сделал три. Эвалы погонял как положено. 💀 Неужели имеющиеся в сети скиллы не подходят? Вот это вообще интересно, чем больше делаю скиллов. тем больше удивляюсь, насколько некачественные и непроверенные в работе скиллы люди публикуют во всех возможных репозиториях и умудряются набирать звезды. • Самые популярные оказались статичными шпаргалками, застрявшими на старых версиях API: rich messages и эфемерных сообщений в них нет. • Свежие есть, но под один фреймворк и как снимок знаний на момент написания. Bot API обновляется почти каждый месяц, и со следующим релизом они устареют. • Ни один не просит агента проверить текущую версию API или библиотеку в проекте, и ни один не учитывает правила Telegram для разработчиков. • А большая часть "телеграм-скиллов" вообще не про разработку: отправить уведомление через бота или помочь вести сообщество. На выходе имеем экономию по времени работы агента, он сразу лезет в нужное место документации, сразу проверяет нужные версии библиотек, вместо того чтобы слопить, ошибаться, а потом исправляться. А пора бы уже ваншотить задачи! ➕ Добавляю в свой боевой арсенал. 🔗 https://github.com/nyxandro/telegram-bot-development-skill