AI Seller Master
Единый мастер: анализ → ТЗ → production-скилл → деплой в Suvvy.
Нишевые факты (цены, адрес, SKU) живут в sources/* конкретного бота. Здесь — универсальная логика с Avito + Suvvy (камень и разборы живых чатов) плюс правила платформы.
Нишевый пак (например Ein-Stein) не удалять и не заменять этим мастером: мастер его аудирует и расширяет.
Справочники (читать по задаче)
| Файл |
Когда |
| suvvy-platform.md |
слои знаний, DQ, CRM, каналы |
| suvvy-prompt-rules.md |
как писать Instructions по доке Suvvy |
| seller-logic.md |
ценность, soft call, large/medium/small, CRM A–D |
| scenario-playbooks.md |
визит, наличие, продукт, «дорого», out of scope |
| instructions-template.md |
полный скелет ROLE…IMPORTANT |
| hard-bans-universal.md |
запреты в Restrictions |
| prompt-pack.md |
files-map, wrap, Excel |
| table-setup.md |
CSV, две функции, поиск |
| failure-patterns.md |
регрессии из живых чатов |
| brief-template.md |
ТЗ CONFIRMED/INFERRED/TODO |
| wrap_sources.py / build_xlsx.py |
синхронизация DQ |
| examples.md |
сценарии применения |
Документация Suvvy: https://docs.suvvy.ai/ru/llms.txt
Когда включать
Переписки Авито, логи бота, PDF/скрины, «почему не находит в таблице», промпт Suvvy, Direct Questions, Bitrix/воронка, квалификация, телефон, chat-only, антигаллюцинации, новый бот с нуля.
Источник правды
Отвечать только из:
- Instructions (
prompt.md / prompt-suvvy-paste.md)
- Direct Questions —
get_file_text("Exact Title"), заголовок байт-в-байт, тумблер вкл
- Табличные функции (CSV/XLS/Sheets)
- Факты клиента во всей переписке
- Публичные ссылки каталога компании (навигация, не выдуманные цены)
Нет в источниках → не выдумывать → менеджер. Клиенту не писать «не найден в базе» / «такого нет».
Конфликт промпт vs DQ: промпт побеждает; факты прайса/адреса — в DQ/таблице, не дублировать противоречиво.
Phase 1 — Discovery
Прочитать все вложения: чаты, скрины, PDF (включая картинки внутри), TXT, текущий промпт, список DQ, таблицы, скрины UI Suvvy (Integrations, имена функций).
Пометить: CONFIRMED / INFERRED / TODO.
Снять:
| Блок |
Что извлечь |
| Бизнес |
роль, канал, продукт vs услуга, out of scope, сайт |
| Интенты |
цена, наличие, «где посмотреть», услуга, «дорого», только чат |
| Квалификация |
large / medium / small внутри; клиенту ярлыки не говорить |
| Экономика |
материал vs под ключ; порог «от X»; что входит; формулу клиенту не говорить |
| Данные |
таблица, прайс, адрес, каталог, колонки поиска |
| CRM |
A–D, один раз за диалог, после вызова продолжать чат; ID через шестерёнку |
| Телефон |
Notification DQ; не переспрашивать; после валидного номера не раздувать анкету |
| Провалы |
телефон вместо ответа, дубли, тишина, пропуск таблицы, CRM слишком поздно |
Группы сбоев: логика / дыры в знаниях / приоритеты / тон / интеграции / имена функций.
Phase 2 — Architecture
skill-name/
├── SKILL.md # disable-model-invocation: true у нишевой базы
├── prompt.md
├── prompt-suvvy-paste.md # → Instructions
├── files-map.md
├── sources/ # править здесь
│ ├── qualification-by-scale.md
│ ├── pricing-factors.md
│ ├── warehouse-address.md (или coverage)
│ ├── availability-rules.md
│ ├── catalog-assortment.md
│ ├── scenario-playbooks.md
│ ├── chat-only-mode.md
│ ├── hard-bans.md
│ ├── bitrix-funnel-stage.md # CRM DQ
│ ├── notification-telegram.md
│ ├── stock-prices.md # если есть listed unit prices
│ ├── follow-ups-reference.md # НЕ грузить в бота
│ └── *.csv
└── suvvy-qa/
├── wrap_sources.py
├── build_xlsx.py
└── NN-*.md
Оркестрация в промпте. Факты в sources/*. Ситуация → файл → DQ в files-map.md.
Phase 3 — Реализация
- Brief по brief-template.md.
prompt-suvvy-paste.md из instructions-template.md; цифры и имена функций — из ниши.
#WORKING WITH FUNCTIONS: когда какой get_file_text и какая таблица (primary → fallback).
#RESTRICTIONS из hard-bans-universal.md + нишевые.
sources/* → suvvy-qa/* через wrap. Не править qa в одиночку.
- CSV UTF-8 без BOM; поиск токеном из всего чата;
search_text + алиасы; см. table-setup.md.
- Каждый повторный сбой из чатов → ban в hard-bans и Restrictions.
- Писать Instructions по suvvy-prompt-rules.md: без противоречий, запреты утвердительные, «шаг за шагом если ещё не известно».
Phase 4 — Деплой Suvvy
- app.suvvy.ai → Instructions ←
prompt-suvvy-paste.md (заголовки UI можно адаптировать, правила не резать).
- База знаний → Вопрос — ответ ←
suvvy-qa/* или Excel. Тумблеры вкл. Title = вызов в промпте. < ~50 DQ.
- Follow-ups-reference не импортировать в бота.
- Таблица: один CSV, при необходимости два имени функции, описание LIKE, «только токен».
- CRM: Integrations на DQ (статус «куда» + свободный оператор) или одно LLM-действие с тем же смыслом A–D. Не три параллельных механизма.
- Temperature 0–0.3.
- Платформенные фоллоу-апы Suvvy не дублировать с отдельным приложением дожимов. Бот не обещает «напомню».
- Регрессии: failure-patterns.md.
Поведение бота (кратко)
Полностью: seller-logic + scenario-playbooks + instructions-template.
- Ценность первой. Весь диалог как один контекст.
- Не телефон вместо ответа на факт-вопрос.
- Soft call: «удобно созвониться?» → номер после «да» или если уже прислали. Не повторять запрос номера.
- Chat-only — полный сервис в чате.
- Large → CRM сразу, без вопроса бюджета. Medium/small → мягкий «от X» → CRM на согласие.
- После CRM продолжать писать. Клиенту не говорить про воронку.
- После валидного телефона: Notification DQ; не раздувать новую анкету.
- Не дублировать смысл за ход. Не тупик «всё на заказ».
- ≤5 уточнений за диалог; ≤2 в сообщении.
- Ярлыки масштаба — только внутри.
Deliverables
A) ТЗ
B) Production pack + чеклист деплоя
C) Список регрессий из живых чатов
1---2name: ai-seller-master3description: Analyze Avito/Suvvy seller chats, logs, PDFs, screenshots, and business notes, then design or refactor a production AI seller skill with Instructions, files-map, source-of-truth docs, Direct Questions (get_file_text), tables, CRM/Bitrix handoff, qualification, anti-hallucination bans, and deploy checklist. Use when creating, auditing, universalizing, or fixing marketplace sales bots on Suvvy.ai.4---56# AI Seller Master78Единый мастер: **анализ → ТЗ → production-скилл → деплой в Suvvy**. 9Нишевые факты (цены, адрес, SKU) живут в `sources/*` конкретного бота. Здесь — **универсальная логика** с Avito + Suvvy (камень и разборы живых чатов) плюс правила платформы.1011Нишевый пак (например Ein-Stein) **не удалять и не заменять** этим мастером: мастер его аудирует и расширяет.1213## Справочники (читать по задаче)1415| Файл | Когда |16|------|--------|17| [suvvy-platform.md](references/suvvy-platform.md) | слои знаний, DQ, CRM, каналы |18| [suvvy-prompt-rules.md](references/suvvy-prompt-rules.md) | как писать Instructions по доке Suvvy |19| [seller-logic.md](references/seller-logic.md) | ценность, soft call, large/medium/small, CRM A–D |20| [scenario-playbooks.md](references/scenario-playbooks.md) | визит, наличие, продукт, «дорого», out of scope |21| [instructions-template.md](references/instructions-template.md) | полный скелет ROLE…IMPORTANT |22| [hard-bans-universal.md](references/hard-bans-universal.md) | запреты в Restrictions |23| [prompt-pack.md](references/prompt-pack.md) | files-map, wrap, Excel |24| [table-setup.md](references/table-setup.md) | CSV, две функции, поиск |25| [failure-patterns.md](references/failure-patterns.md) | регрессии из живых чатов |26| [brief-template.md](references/brief-template.md) | ТЗ CONFIRMED/INFERRED/TODO |27| [wrap_sources.py](references/wrap_sources.py) / [build_xlsx.py](references/build_xlsx.py) | синхронизация DQ |28| [examples.md](examples.md) | сценарии применения |2930Документация Suvvy: https://docs.suvvy.ai/ru/llms.txt3132## Когда включать3334Переписки Авито, логи бота, PDF/скрины, «почему не находит в таблице», промпт Suvvy, Direct Questions, Bitrix/воронка, квалификация, телефон, chat-only, антигаллюцинации, новый бот с нуля.3536## Источник правды3738Отвечать **только** из:39401. Instructions (`prompt.md` / `prompt-suvvy-paste.md`)412. Direct Questions — `get_file_text("Exact Title")`, заголовок байт-в-байт, тумблер вкл423. Табличные функции (CSV/XLS/Sheets)434. Факты клиента **во всей** переписке445. Публичные ссылки каталога компании (навигация, не выдуманные цены)4546Нет в источниках → не выдумывать → менеджер. Клиенту **не** писать «не найден в базе» / «такого нет».4748Конфликт промпт vs DQ: **промпт побеждает**; факты прайса/адреса — в DQ/таблице, не дублировать противоречиво.4950---5152## Phase 1 — Discovery5354Прочитать **все** вложения: чаты, скрины, PDF (включая картинки внутри), TXT, текущий промпт, список DQ, таблицы, скрины UI Suvvy (Integrations, имена функций).5556Пометить: **CONFIRMED** / **INFERRED** / **TODO**.5758Снять:5960| Блок | Что извлечь |61|------|-------------|62| Бизнес | роль, канал, продукт vs услуга, out of scope, сайт |63| Интенты | цена, наличие, «где посмотреть», услуга, «дорого», только чат |64| Квалификация | large / medium / small **внутри**; клиенту ярлыки не говорить |65| Экономика | материал vs под ключ; порог «от X»; что входит; формулу клиенту не говорить |66| Данные | таблица, прайс, адрес, каталог, колонки поиска |67| CRM | A–D, один раз за диалог, после вызова **продолжать чат**; ID через шестерёнку |68| Телефон | Notification DQ; не переспрашивать; после валидного номера не раздувать анкету |69| Провалы | телефон вместо ответа, дубли, тишина, пропуск таблицы, CRM слишком поздно |7071Группы сбоев: логика / дыры в знаниях / приоритеты / тон / интеграции / имена функций.7273---7475## Phase 2 — Architecture7677```text78skill-name/79├── SKILL.md # disable-model-invocation: true у нишевой базы80├── prompt.md81├── prompt-suvvy-paste.md # → Instructions82├── files-map.md83├── sources/ # править здесь84│ ├── qualification-by-scale.md85│ ├── pricing-factors.md86│ ├── warehouse-address.md (или coverage)87│ ├── availability-rules.md88│ ├── catalog-assortment.md89│ ├── scenario-playbooks.md90│ ├── chat-only-mode.md91│ ├── hard-bans.md92│ ├── bitrix-funnel-stage.md # CRM DQ93│ ├── notification-telegram.md94│ ├── stock-prices.md # если есть listed unit prices95│ ├── follow-ups-reference.md # НЕ грузить в бота96│ └── *.csv97└── suvvy-qa/98 ├── wrap_sources.py99 ├── build_xlsx.py100 └── NN-*.md101```102103Оркестрация в промпте. Факты в `sources/*`. Ситуация → файл → DQ в `files-map.md`.104105---106107## Phase 3 — Реализация1081091. Brief по [brief-template.md](references/brief-template.md).1102. `prompt-suvvy-paste.md` из [instructions-template.md](references/instructions-template.md); цифры и имена функций — из ниши.1113. `#WORKING WITH FUNCTIONS`: когда какой `get_file_text` и какая таблица (primary → fallback).1124. `#RESTRICTIONS` из [hard-bans-universal.md](references/hard-bans-universal.md) + нишевые.1135. `sources/*` → `suvvy-qa/*` через wrap. Не править qa в одиночку.1146. CSV UTF-8 **без BOM**; поиск токеном из **всего чата**; `search_text` + алиасы; см. [table-setup.md](references/table-setup.md).1157. Каждый повторный сбой из чатов → ban в hard-bans **и** Restrictions.1168. Писать Instructions по [suvvy-prompt-rules.md](references/suvvy-prompt-rules.md): без противоречий, запреты утвердительные, «шаг за шагом если ещё не известно».117118---119120## Phase 4 — Деплой Suvvy1211221. [app.suvvy.ai](https://app.suvvy.ai/) → **Instructions** ← `prompt-suvvy-paste.md` (заголовки UI можно адаптировать, **правила не резать**).1232. **База знаний → Вопрос — ответ** ← `suvvy-qa/*` или Excel. Тумблеры **вкл**. Title = вызов в промпте. **< ~50** DQ.1243. Follow-ups-reference **не** импортировать в бота.1254. Таблица: один CSV, при необходимости **два имени функции**, описание LIKE, «только токен».1265. CRM: Integrations на DQ (статус «куда» + свободный оператор) **или** одно LLM-действие с тем же смыслом A–D. Не три параллельных механизма.1276. Temperature **0–0.3**.1287. Платформенные фоллоу-апы Suvvy не дублировать с отдельным приложением дожимов. Бот не обещает «напомню».1298. Регрессии: [failure-patterns.md](references/failure-patterns.md).130131---132133## Поведение бота (кратко)134135Полностью: seller-logic + scenario-playbooks + instructions-template.1361371. Ценность первой. Весь диалог как один контекст.1382. Не телефон вместо ответа на факт-вопрос.1393. Soft call: «удобно созвониться?» → номер после «да» или если уже прислали. Не повторять запрос номера.1404. Chat-only — полный сервис в чате.1415. Large → CRM **сразу**, без вопроса бюджета. Medium/small → мягкий «от X» → CRM на согласие.1426. После CRM продолжать писать. Клиенту не говорить про воронку.1437. После **валидного телефона**: Notification DQ; не раздувать новую анкету.1448. Не дублировать смысл за ход. Не тупик «всё на заказ».1459. ≤5 уточнений за диалог; ≤2 в сообщении.14610. Ярлыки масштаба — только внутри.147148---149150## Deliverables151152A) ТЗ 153B) Production pack + чеклист деплоя 154C) Список регрессий из живых чатов