# Инструкция для Claude Code — что сделать с этим архивом

Эсфирь только что прикрепила в этот чат два файла: `SMM-Kit-Swipix.zip` и этот
файл. Прочитай этот файл целиком и выполни шаги по порядку — без лишних
вопросов, если ниже уже есть ответ.

## Контекст (для тебя)

Это готовый набор для SMM-отдела Swipix: 4 Markdown-скилла, проверенные
референсы стиля (текст+визуал), 10 одобренных оператором картинок и рабочий
инструмент генерации новых картинок через Gemini. Собран другой сессией Claude
Code после 5 итераций правок с оператором Swipix. Твоя задача — развернуть это
в текущем проекте Эсфирь и подготовить всё к работе.

## Шаги

1. **Распакуй `SMM-Kit-Swipix.zip`** в текущий проект — например, в подпапку
   `smm-kit/` рядом с корнем проекта.
2. **Подключи скиллы**: скопируй содержимое `smm-kit/skills/*` в
   `.claude/skills/` текущего проекта (создай папку, если её нет). После
   этого 4 скилла (`crm-smm-voice-and-style`, `crm-smm-content-planner`,
   `crm-smm-visual-director`, `crm-smm-n8n-publisher`) должны появиться в
   списке доступных скиллов — проверь.
3. **Прочитай** `smm-kit/README.md` и `smm-kit/GOOGLE_AI_SETUP.md` целиком —
   там описана структура набора и как работает генерация картинок.
4. **Спроси у Эсфирь ключ Gemini** — он пришёл ей ОТДЕЛЬНО, в тексте
   Slack-сообщения (не в архиве, из соображений безопасности). Когда она его
   назовёт/вставит — сохрани его в `smm-kit/keys/smm_gemini_api_key.txt`
   (создай папку `keys/`, если её нет). Никогда не печатай ключ обратно в чат
   после сохранения и не коммить его в git — если в проекте есть `.gitignore`,
   добавь туда `smm-kit/keys/`.
5. **Установи зависимости**: `pip install -r smm-kit/tools/requirements.txt`.
6. **Сделай дымовой тест** — возьми любой готовый промпт из
   `smm-kit/PROMPT_TEMPLATES.md` (или один референс-файл из
   `smm-kit/images/brand-style-refs/` как `--ref`) и запусти
   `python smm-kit/tools/generate_image.py --prompt "..." --out smoke_test.jpg`.
   - **Если получилась картинка** — покажи её Эсфирь, ключ и окружение
     настроены верно, переходи к шагу 7.
   - **Если пришла ошибка `429` / "quota exceeded" / "check your plan and
     billing"** — это ИЗВЕСТНАЯ проблема тестового ключа, не баг скрипта и не
     твоя ошибка настройки. Не пытайся починить это сам (не подставляй другие
     ключи, не трогай `imageConfig`/модели). Скажи Эсфирь ровно следующее:
     ключ пока не работает (квота/биллинг), нужно попросить рабочий ключ у
     **Alexey Polennikov** в Slack, и предложи ей отправить ему готовый текст:

     > Привет, Алексей! Работаю с SMM-набором для Swipix (генерация картинок
     > через Gemini image-gen, модели gemini-3-pro-image /
     > gemini-3.1-flash-image). Тестовый ключ, который мне дали, каждый раз
     > отдаёт 429 quota exceeded — похоже, на нём не включён биллинг или лимит
     > нулевой. Можешь выдать рабочий ключ с квотой на generateContent, либо
     > подключить биллинг на этот? Спасибо!

     Когда Эсфирь принесёт новый ключ от Алексея — замени
     `smm-kit/keys/smm_gemini_api_key.txt` на него и повтори дымовой тест.
7. **После успешного теста** скажи Эсфирь, что всё готово, и предложи начать
   с `smm-kit/PROMPT_TEMPLATES.md` — там готовые формулировки под план
   постов, текст, mega-prompt и генерацию картинки.

## Важно — границы этой задачи

- Всё, что ты производишь этим набором — черновики (тексты, картинки, планы).
  Публикация в реальный Telegram-канал Swipix и любая автоматизация постинга
  (n8n) НЕ входят в эту задачу и требуют отдельного явного согласования —
  `smm-kit/skills/crm-smm-n8n-publisher/SKILL.md` фиксирует это прямо.
- Ключ Gemini — тестовый, будет ротирован после проверки. Если что-то в
  твоём проекте требует прав живой публикации/оплаты — остановись и спроси
  оператора, не предполагай согласие.
- Если распаковка/установка зависимостей не задалась — опиши точную ошибку
  Эсфирь, не пытайся обойти её произвольными хаками (менять версии
  библиотек, отключать проверки и т.п.) без объяснения, что и почему.