aiogram-bot

Простым языком

Хочешь сделать бота в Телеграме, но не знаешь с чего начать? Этот скилл — как опытный программист рядом. Ты описываешь что бот должен делать, а Claude пишет весь код за тебя.

Просто напиши: «Сделай бота для записи к парикмахеру» — и получишь готовый проект. С кнопками, базой данных и инструкцией как запустить.

Что делает

Скилл aiogram-bot — полный набор шаблонов и паттернов для создания Telegram-ботов на Python с Aiogram v3. Генерирует структуру проекта, хендлеры, FSM-диалоги, инлайн-кнопки и интеграцию с PostgreSQL.

Claude подключает этот скилл автоматически, когда видит задачу про Telegram-бота. Все шаблоны строго под Aiogram v3 — старые версии не поддерживаются.

Когда использовать

• Создаёшь нового Telegram-бота с нуля
• Нужны FSM-диалоги (пошаговые формы, опросы, многошаговая регистрация)
• Требуется интеграция бота с базой данных PostgreSQL или SQLite
• Хочешь добавить инлайн-кнопки и callback-обработчики
• Нужен Docker-конфиг для деплоя бота на VPS
• Настраиваешь Webhook вместо Long Polling для продакшена

Как работает — пошагово

1. Claude анализирует задачу и определяет тип бота (утилита, магазин, Q&A, уведомления)
2. Генерируется структура: bot/handlers/, bot/keyboards/, bot/states/, bot/middlewares/
3. Создаются хендлеры для каждого сценария с FSM-состояниями и валидацией ввода
4. Настраивается middleware: логирование, rate-limit, авторизация по ролям
5. Добавляется docker-compose.yml + .env.example + alembic/ для миграций
6. Пишутся pytest-тесты для хендлеров и FSM-переходов

Промпты для Claude

Примеры промптов, которые активируют этот скилл:

Создай Telegram-бота для записи на стрижку.
Мастера: 3 человека, у каждого свой график.
Даты: на неделю вперёд, слоты по 30 минут.
После записи — подтверждение с деталями.
Стек: aiogram v3 + PostgreSQL + Docker.

Сделай бота-помощника для управления задачами:
- /add Название — добавить задачу
- /list — список задач
- /done ID — отметить выполненной
- /remind — напоминания через 24ч
БД: SQLite для простоты. Деплой в Docker.

Пример структуры проекта

bot/
├── __init__.py
├── main.py              # Точка входа, настройка диспетчера
├── config.py            # Настройки из .env
├── handlers/
│   ├── __init__.py
│   ├── start.py         # /start, /help
│   ├── booking.py       # FSM записи
│   └── admin.py         # Админ-панель
├── keyboards/
│   ├── inline.py        # Инлайн-кнопки
│   └── reply.py         # Reply-клавиатуры
├── states/
│   └── booking.py       # FSM-состояния
├── middlewares/
│   ├── auth.py          # Проверка прав
│   └── throttle.py      # Rate limiting
├── database/
│   ├── models.py        # SQLAlchemy модели
│   └── queries.py       # Запросы к БД
└── tests/
    └── test_booking.py  # Тесты FSM

Автоматизация

Claude подключает скилл автоматически, когда видит ключевые слова: telegram, бот, aiogram, хендлер. Для явного вызова укажи стек в задаче.

# В CLAUDE.md проекта укажи:
## Стек
- Telegram Bot API: aiogram v3
- БД: PostgreSQL + SQLAlchemy async
- Деплой: Docker + Webhook

# Тогда скилл будет активен во всех задачах проекта

Частые вопросы

Поддерживает ли aiogram v2?

Нет. Скилл заточен строго под Aiogram v3. У v2 кардинально другой API — нет роутеров, другой FSM. Если проект на v2 — рекомендуем мигрировать.

Можно ли использовать без Docker?

Да, Docker опционален. Скилл генерирует docker-compose.yml, но бот работает и без него — просто запусти python main.py.

Какую БД выбрать?

Для простых ботов — SQLite (нулевая настройка). Для ботов с >100 пользователями — PostgreSQL через SQLAlchemy async.