# SMM-Kit-Swipix — набор инструментов для SMM-отдела

Это готовая «SMM-машина» для Telegram-канала Swipix: скиллы для Claude Code,
проверенные референсы стиля (текст + визуал) и рабочий инструмент генерации
картинок через Google Gemini ("nanobanana 2"). Собрано из результатов
5 итераций правок с оператором — от «не достаточно круто» до одобренного
глянцевого fashion-editorial стиля (см. `images/approved-posts/`).

## Что внутри

```
skills/                         4 скилла Claude Code (Markdown, без кода)
  crm-smm-voice-and-style/      войс канала + визуальные треки + gambling-lexicon ban
  crm-smm-content-planner/      баланс типов постов, календарь, банк геймификации
  crm-smm-visual-director/      как собрать mega-prompt для картинки
  crm-smm-n8n-publisher/        дизайн автопостинга в n8n (НЕ строит и не запускает)

references/
  STYLE_TOKENS.md                ЕДИНСТВЕННЫЙ источник правды по визуалу бренда
                                  (hex-палитра, типографика, DON'T-лист)
  voice-and-visual-audit.md      аудит реального канала (тон + визуал, пост-ребренд)
  content-plan-10-posts-v2.md    рабочий пример: 10 текстов + 10 mega-prompt'ов
  copy-swipe-file.md             референсы копирайтинга (Monzo/Cash App/Duolingo/…)
  formatting-rules.md            правила реальной вёрстки ТГ-постов

images/
  approved-posts/                 10 ОДОБРЕННЫХ картинок (v5, glossy fashion editorial)
                                   + prompts_used.json — точный промпт под каждую
  brand-style-refs/               реальные референс-фото от команды (3 категории)
    fashion-editorial/            трек 1 — fashion/lifestyle
    mascot/                       трек 2 — 3D-маскот
    icons-3d/                     3D-иконки/предметы, впечённый текст

tools/
  generate_image.py               рабочий скрипт генерации картинки через Gemini
  requirements.txt

GOOGLE_AI_SETUP.md                как подключить/использовать ключ Gemini
PROMPT_TEMPLATES.md               готовые промпты — просто вставляй в чат с Claude Code
```

## Быстрый старт

1. Установи зависимости: `pip install -r tools/requirements.txt`.
2. Положи ключ Gemini в `keys/smm_gemini_api_key.txt` — сам ключ пришёл ОТДЕЛЬНО,
   в тексте Slack-сообщения (не в архиве, из соображений безопасности). Если
   генерация отдаёт `429 quota exceeded` — это известная проблема тестового
   ключа, не твоя ошибка; см. `GOOGLE_AI_SETUP.md` за готовым текстом для
   Alexey Polennikov.
3. Открой Claude Code в папке, куда распаковал архив. Скопируй `skills/*` в
   `.claude/skills/` своего проекта — тогда 4 скилла подключатся автоматически.
4. Бери готовые формулировки из `PROMPT_TEMPLATES.md` и проси Claude Code
   собрать план/текст/картинку.

## Как это устроено

- **Текст поста** — правила войса и структуры в `crm-smm-voice-and-style`
  (структура: хук → 2-4 абзаца с эмодзи-маркером → явный CTA), обязательный
  gambling-lexicon бан (raffle/odds/winner/jackpot — инцидент 28.07.2026, детали
  в `voice-and-visual-audit.md`).
- **Календарь/план** — `crm-smm-content-planner`: баланс типов постов (релизы
  ≤60% окна), банк геймификации, "готово к посту / отложить" гейт по реальному
  статусу фичи.
- **Картинка** — `crm-smm-visual-director` собирает mega-prompt (один абзац:
  медиум+сюжет → композиция → палитра/свет → формат+негативное пространство →
  явный запрет на текст/лого) по одному из 3 визуальных треков
  (`crm-smm-voice-and-style` §B). `tools/generate_image.py` отправляет этот
  промпт + 1-3 референс-фото в Gemini и возвращает готовый квадратный JPEG.
- **Источник правды по стилю** — только `references/STYLE_TOKENS.md` (вытяжка
  из официального брендбука). Не изобретай палитру/шрифты заново.

## Важно — где эта машина останавливается

- Все результаты этого набора — ЧЕРНОВИКИ (тексты + картинки). Публикация в
  реальный Telegram-канал Swipix, автопостинг через n8n, любая внешняя отправка
  — отдельный шаг с отдельным согласованием оператора. `crm-smm-n8n-publisher`
  прямо это фиксирует: скилл только описывает, что нужно построить, но никогда
  сам не создаёт и не включает автоматизацию.
- Ключ Gemini, который вы получили — тестовый, будет РОТИРОВАН после проверки.
  Не публикуйте его в открытых каналах/репозиториях.
