Свой Telegram-агент: на примере копирайтера

mkdir tg-copywriter-bot
cd tg-copywriter-bot

tg-copywriter-bot/
  knowledge/
    style.md          ← правила стиля
    templates.md      ← шаблоны постов
    vocab.md          ← словарь: запрещённые и любимые слова
    archive.md        ← последние 20-30 опубликованных постов
  system-prompt.md    ← системный промпт для бота
  bot.py              ← сам бот (напишет Claude)
  .env.example        ← документация ключей (без значений)
  requirements.txt    ← зависимости Python
  CLAUDE.md           ← инструкция для Claude Code

# Telegram-агент-копирайтер

## Что это
Бот, который превращает мои голосовые в готовые посты в моём стиле.

## Стек
- Python 3.11
- python-telegram-bot 21.x
- httpx (для OpenRouter и Groq)
- SQLite для истории постов

## Внешние сервисы
- OpenRouter — API к Claude Sonnet
- Groq Whisper — расшифровка голосовых
- Telegram Bot API

## База знаний
Лежит в knowledge/. Один файл = одна тема. Бот читает её через простой grep.

## Правила
- Без enterprise-говна, бот для одного пользователя
- Не плодить конфигурацию без причины
- Логи через стандартный logging, не сторонние библиотеки
- Все ключи через .env, ничего не коммитить

# Стиль постов

## Тон
- На «ты», по-дружески, как с коллегой — без официоза
- Кратко и по делу, без воды и лишних «как видишь, я успешно сделал...»
- Без эмодзи в тексте
- От первого лица: «я», «мне», «у меня»

## Структура
- Короткие абзацы (1-3 предложения)
- Заход — конкретная сцена, факт, провокационный вопрос
- Развитие — 2-3 абзаца
- Финал — панчлайн без воды. НЕ «а как думаете вы?» — это убивает пост.

## Чего никогда не делаю
- Жирного текста
- Маркированных списков внутри текста статьи
- Канцелярита и «экспертного» языка
- Дайджеста без позиции (пересказал новости — и что?)

## Авторские фразы (не трогать никогда)
- «стоит немного подзаморочиться»
- «я ведь знаю что вам не охота»
- «копилка чтобы не наступать на те же грабли»

## Длина
- 800-1500 символов на пост

# Шаблоны постов

## Универсальная формула: КРЮЧОК → КОНТЕКСТ → КОНФЛИКТ → ВЫВОД → ПРИЗЫВ

КРЮЧОК — первые 1-2 строки, стоп-скролл. Решает читать или нет.
КОНТЕКСТ — почему тема важна, вводит в ситуацию.
КОНФЛИКТ — столкновение позиций, напряжение. Без конфликта пост — просто
информация.
ВЫВОД — неожиданный, честный, может быть спорным. НЕ мотивационный.
ПРИЗЫВ — конкретное действие. НЕ «а как думаете вы?».

Метрика: репосты и пересылки, не лайки.

## Типы крючков (выбираешь один на пост)

1. Историческая сторителлинг — конкретная дата, имя, место.
2. Свежее исследование — ссылка на авторитетный источник.
3. Провокация через абсурд — нелепая, но реальная ситуация.
4. Личное наблюдение — конкретная сцена, от первого лица.
5. Парадокс — утверждение которое кажется неверным, но это правда.
6. Провокационный вопрос — НЕ мягкий «а вы что думаете?», а цепляющий.

## 6 типов контента, которым делятся

1. Резонанс и закрытые темы — то о чём все думают, но никто не говорит.
2. Разрушение мифов — «все думают X, а на самом деле Y» с доказательствами.
3. Кейсы и гуру — разбор конкретного примера или авторитета.
4. Ретроградный взор — «раньше было так, а теперь...».
5. Смена призмы — посмотреть на привычное с неожиданного угла.
6. Неожиданные исследования — цифры и факты которые удивляют.

# Словарь

## Запрещённые слова и обороты
- погружение
- на стыке
- уникальная методика
- пассивный доход
- гарантированный результат
- в эпоху цифровой трансформации
- успешный успех
- мощный инструмент
- революционный подход

## Что всегда добивает пост (не делать)
- Дайджест без позиции
- Длинный пост без чёткой идеи
- Финал «а как думаете вы?»
- Канцелярский язык
- Пост без личности (мог написать кто угодно)

## Любимые слова и темы
- вайбкодинг
- второй мозг
- прикладной
- из коробки
- база знаний
- грабли (об ошибках)
- копилка
- система

# Архив постов

## 2026-05-07
[Полный текст последнего поста]

## 2026-05-05
[Полный текст]

...

Ты помощник [имя] по контенту в Telegram. Твоя задача — превращать
голосовые сообщения в готовые посты в его стиле.

Воронка:
1. Получаешь расшифрованное голосовое.
2. Определяешь тип поста: история, лайфхак, разбор, мнение.
3. Подтягиваешь релевантный шаблон из knowledge/templates.md.
4. Пишешь пост по правилам из knowledge/style.md.
5. Проверяешь по knowledge/vocab.md (нет запрещённых слов, есть любимые).
6. Сверяешь с knowledge/archive.md, чтобы тема не дублировалась.
7. Возвращаешь готовый пост.

Запрещено:
- Использовать запрещённые слова из vocab.md.
- Дублировать темы из archive.md (последние 30 постов).
- Менять авторские фразы.
- Делать пост длиннее 1500 символов или короче 800.

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

Создай Telegram-бот-копирайтер на Python + python-telegram-bot.

Что должен уметь:
- Принимать голосовые → расшифровывать через Groq Whisper → отдавать
  в Claude через OpenRouter
- Использовать knowledge/ как базу знаний (через простой grep по содержимому
  файлов на ключевые слова из голосового)
- Использовать system-prompt.md как системный промпт
- Хранить историю в SQLite (data/bot.db) — последние 30 постов в archive_db
- Команда /last — показать последние 5 постов
- Команда /save — сохранить только что сгенерированный пост в архив
- Whitelist по Telegram-id (только мой)
- .env с TELEGRAM_BOT_TOKEN, OPENROUTER_API_KEY, GROQ_API_KEY, MY_TELEGRAM_ID
- Модель: anthropic/claude-sonnet-4 (через OpenRouter)
- В контексте к модели передавать последние 5 сообщений диалога

Сделай максимально просто, без лишнего enterprise-говна — этим буду
пользоваться только я. Нейронка тренировалась на сложных open-source
решениях и любит over-engineering, мне это не надо.

Перед написанием кода — задай мне уточняющие вопросы.

Всё что можешь сделать сам — делай сам. Запускай в терминале сам,
ставь зависимости сам, тестируй сам. Если упёрся в реальный блокер —
только тогда зови меня. Я не хочу ничего устанавливать руками.

## Деплой обновлений
Когда я говорю «задеплой» или «обнови бота» — делай:
1. git add . && git commit -m "..." && git push
2. ssh root@MY_SERVER_IP
3. cd /root/tg-copywriter-bot && git pull
4. Если requirements.txt изменился — pip install -r requirements.txt
5. systemctl restart tg-copywriter-bot
6. systemctl status tg-copywriter-bot
7. journalctl -u tg-copywriter-bot -n 30 | покажи мне

Создай deploy.md в проекте. Опиши: где лежит проект на сервере,
как называется systemd-служба, как обновить код, как перезапустить,
как посмотреть статус и логи, где .env, что нельзя коммитить, что
делать если бот не отвечает. Не вставляй реальные пароли и IP.