ticket-deflector
Читает пересланное письмо или обращение клиента, подтягивает статус заказа и оплаты из платежей и историю клиента из CRM, готовит ответ в тоне и голосе владельца, а при необходимости — оформляет возврат с явным подтверждением владельца. Триггеры: «подготовь ответ», «ответь этому
Install
npx skills add https://github.com/ilyautov/small-business-ru/tree/main/small-business-ru/skills/ticket-deflector
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install ilyautov-small-business-ru@llmmart
git clone https://github.com/ilyautov/small-business-ru.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole ilyautov/small-business-ru collection as a plugin from our marketplace. Git is the plain clone.
Skill manifest
Помощник поддержки (ticket-deflector)
Каждое письмо клиента — это переключение контекста: где заказ, сколько заплатил, что ему отвечать и не сорвётся ли он, если ответить через два дня. Скилл сам поднимает статус оплаты и историю по клиенту и готовит ответ вашими словами, а возврат не оформит без вашего явного «да» — вы только проверяете черновик, а не собираете факты вручную.
Быстрый старт
Перешлите или вставьте письмо клиента — Claude подтянет статус заказа из ~~платежей, найдёт клиента в ~~crm и подготовит ответ в голосе владельца. Если нужен возврат, он соберёт детали и дождётся явного подтверждения, прежде чем что-либо оформлять.
Владелец: «ответь этому клиенту» [пересылает письмо]
→ Извлечь почту клиента + суть обращения из переписки
→ Подтянуть статус оплаты из ~~платежей
→ Подтянуть историю клиента из ~~crm
→ Подготовить ответ в голосе владельца
→ Владелец одобряет черновик → отправить или в черновики
→ Если нужен возврат: запрос подтверждения → владелец подтверждает → оформить
Рабочий процесс
Прочитайте сообщение клиента. Примите пересланное письмо (
~~почта), сообщение из мессенджера (~~мессенджер) или вставленный текст. Извлеките: контакт клиента, имя, номер заказа или операции (если есть) и суть — заявка на возврат, вопрос о статусе заказа или общая жалоба. Если вопросов несколько — отвечайте в порядке их появления.Подтяните статус оплаты из платежей. Найдите операцию в
~~платежах(например ЮKassa, Тинькофф Касса) по контакту клиента или номеру операции. Зафиксируйте: сумму, дату, статус и был ли уже возврат. Если~~платежине подключены — отметьте это в черновике и продолжайте. Если совпадений нет — отметьте это, не угадывайте совпадение.- Лимит запросов: если клиент дал номер операции — используйте его (точечный поиск не упирается в лимит). Если ищете по контакту — берите окно 7 дней (не 30). Широкие диапазоны дат чаще всего упираются в лимит; запросы подряд в одной сессии исчерпают лимит, если окно слишком широкое.
- Если подключён
~~мессенджер— проверьте открытые обращения от этого клиента там. - Если подключён второй источник оплат — проверьте и его как дополнительный.
- Если совпало несколько операций — покажите все и спросите владельца, какая относится к делу, прежде чем готовить черновик.
Подтяните историю клиента из CRM. Найдите контакт в
~~crm(например Битрикс24, amoCRM) по адресу/телефону. Возьмите: стадию, заметки, открытые сделки, недавнюю активность. Если контакта нет — отметьте это и предложите создать после отправки ответа, не создавайте в процессе подготовки ответа.Подготовьте ответ. Пишите в голосе владельца. Подстройте тон под тип обращения:
- Заявка на возврат → с пониманием, ясно, по делу
- Вопрос о статусе заказа → по фактам, спокойно
- Общая жалоба → признать, объяснить, предложить решение
⚠️ По возвратам — общая рамка, без выдуманных деталей закона. Если клиент требует возврат, помните: в РФ права потребителя защищает закон «О защите прав потребителей» (например, возврат товара надлежащего качества — в течение 14 дней при условиях; товар ненадлежащего качества — отдельный порядок). Не цитируйте конкретные статьи и сроки как окончательные — пишите общими словами и при сомнении добавляйте: «уточните условия возврата» (у владельца/юриста). Не обещайте клиенту того, что владелец не подтвердил.
Помечайте любые пробелы в данных прямо в черновике в скобках (например, [Прим.: операция в платежах не найдена — проверьте номер заказа перед отправкой]), чтобы владелец увидел пробел до отправки. Разобранный пример — в reference/examples/respond-refund-request.md. Типовые грабли — в reference/gotchas.md.
Контрольная точка — владелец проверяет черновик. Покажите черновик целиком. Не отправляйте и не сохраняйте, пока владелец не одобрит. Владелец может свободно править перед одобрением.
Контрольная точка — оформление возврата. Если возврат обоснован, после одобрения черновика покажите отдельный запрос на подтверждение:
«Оформить возврат [сумма] ₽ клиенту [имя] ([контакт]) по операции [номер]? Ответьте "Да" для подтверждения.»
Дождитесь явного подтверждения. Если ответ владельца — не чёткое «да», остановитесь и спросите, как поступить.
Отправьте или сохраните в черновики. После одобрения спросите владельца: отправить сейчас через
~~почту/~~мессенджерили сохранить черновиком? Выполните выбор. Затем запишите взаимодействие заметкой в карточку клиента в~~crm.Отчёт. Один короткий абзац: ответ отправлен или в черновиках, возврат оформлен или нет, заметка в CRM записана.
Точки подтверждения (approval gates)
- Никогда не оформляйте возврат без явного подтверждения владельца — всегда покажите сумму, имя клиента, контакт и номер операции до выполнения.
- Никогда не отправляйте ответ без проверки владельцем. Сначала всегда показывайте черновик целиком.
- Никогда не создавайте контакт в CRM в процессе ответа. Предложите это после.
- Никогда не выбирайте операцию за владельца автоматически. Если совпало несколько — покажите все, пусть выбирает владелец.
- Никогда не выдумывайте детали заказа или нормы закона. Если в платежах нет записи — скажите об этом прямо в черновике. По условиям возврата — общая рамка + «уточните условия возврата», без выдуманных статей.
Справочные материалы
- reference/gotchas.md — примеры «хорошо / плохо» по тону, поиску оплаты и спорным возвратам
- reference/examples/respond-refund-request.md — разобранный пример: заявка на возврат с найденной операцией
Files (small-business-ru)
-
reference
-
examples
-
respond-refund-request.md 3.7 KB
# Пример: заявка на возврат — операция в платежах найдена **Ситуация:** клиентка пишет, что товар пришёл с браком и она хочет полный возврат. Владелец пересылает письмо и говорит «ответь этому клиенту». --- ## Письмо клиента (переслано) > **Тема:** Брак товара — нужен возврат > > Здравствуйте! Заказывала набор разделочных досок в прошлом месяце, пришёл с трещиной. Хочу полный возврат, пожалуйста. Номер заказа 3847. > > — Светлана М. --- ## Шаг 2 — Результат поиска в платежах Найдена 1 операция по контакту svetlana.m@email.ru: - **Номер операции:** 3847 - **Сумма:** 5 600 ₽ - **Дата:** 28.03.2026 - **Статус:** Завершена - **Возврат:** Не оформлялся --- ## Шаг 3 — Результат поиска в CRM Контакт найден: Светлана М. (svetlana.m@email.ru) - Стадия: Клиент - Прошлых заказов: 2 - Заметки: «Постоянный клиент — отправляли новогоднее предложение, декабрь 2025.» --- ## Шаг 4 — Черновик ответа (показан владельцу на проверку) > **Тема:** Re: Брак товара — нужен возврат > > Здравствуйте, Светлана! > > Очень жаль, что набор досок пришёл с трещиной — так быть не должно. Я нашёл ваш заказ и оформляю полный возврат на 5 600 ₽. Деньги вернутся тем же способом оплаты, обычно это занимает несколько рабочих дней. > > Спасибо, что сообщили, и извините за этот случай. Если по условиям возврата возникнут вопросы — подскажу. > > [Имя владельца] *[Прим. владельцу: товар с браком (ненадлежащего качества) — порядок возврата по закону отличается от возврата качественного товара. Сумму и сроки уточните, если нужно. Здесь возврат оформляется по доброй воле — это ваше решение.]* --- ## Шаг 5 — Владелец одобряет черновик (без правок) --- ## Шаг 6 — Запрос на подтверждение возврата > *«Оформить возврат 5 600 ₽ клиенту Светлана М. (svetlana.m@email.ru) по операции 3847? Ответьте "Да" для подтверждения.»* Владелец отвечает: **Да** → Возврат оформлен через `~~платежи`. --- ## Шаг 7 — Отправка + заметка в CRM Ответ отправлен через `~~почту`. Заметка в карточке Светланы М. в `~~crm`: > «Поддержка — 23.04.2026: клиент сообщил о браке товара. Оформлен полный возврат 5 600 ₽ через платежи (операция 3847). Ответ отправлен.» --- ## Шаг 8 — Отчёт > Ответ отправлен Светлане М. · Возврат 5 600 ₽ оформлен (операция 3847) · Заметка в CRM записана.
-
-
gotchas.md 5.4 KB
# Грабли — помощник поддержки Краевые случаи, которые ломали процесс на тестах и ревью. --- ## Грабли: попасть в голос владельца, а не в безликий «деловой» тон **Почему важно:** ценность скилла в том, что ответы звучат так, будто их написал владелец. Безликий корпоративный черновик переписывают с нуля — труд впустую. ### ✗ Плохо > Уважаемый клиент! > > Благодарим за обращение. Приносим извинения за доставленные неудобства и обязуемся решить ваш вопрос в кратчайшие сроки. Просим ожидать обработки в течение нескольких рабочих дней. > > С уважением, служба поддержки. ### ✓ Хорошо Пишите в реальном регистре владельца. Если прошлых писем владельца под рукой нет, спросите: *«Какой у вас обычный тон — официальный, неформальный или что-то среднее?»* Лаконичному владельцу — короткий прямой черновик. Тёплому и общительному — тепло и его обороты. --- ## Грабли: помечать пробелы в данных по месту, а не в конце **Почему важно:** если в платежах нет операции, а черновик пишет «ваш возврат на X ₽ оформляется», владелец отправит ложное обещание. Пробелы в данных должны быть видны там, где они влияют на текст. ### ✗ Плохо Написать ответ так, будто все данные есть, и добавить сноску в конце: «Прим.: операцию в платежах не нашёл.» ### ✓ Хорошо Вставьте пометку о пробеле прямо в то предложение, где она важна: > Здравствуйте, Светлана! Спасибо, что написали. Я посмотрел ваш заказ *[Прим.: операция в платежах по этому контакту не найдена — проверьте номер заказа перед отправкой]* и хочу всё уладить. Владелец видит проблему до нажатия «отправить». --- ## Грабли: несколько операций по одному клиенту **Почему важно:** клиент с двумя заказами — один с возвратом, другой нет — сломает простой поиск «по последней операции» и даст неверный черновик. ### ✗ Плохо Автоматически взять последнюю операцию и продолжить, не сказав владельцу. ### ✓ Хорошо Покажите все совпавшие операции и сделайте паузу: > *«Нашёл 2 операции по этому клиенту: (1) 4 900 ₽ · 14.03.2026 · Завершена · (2) 12 900 ₽ · 01.04.2026 · Завершена. Какая из них по этому обращению?»* Дождитесь подтверждения владельца, прежде чем писать черновик. --- ## Грабли: возврат по закону «О защите прав потребителей» — не выдумывать детали **Почему важно:** в РФ возврат регулирует закон «О защите прав потребителей». Сроки и условия зависят от того, надлежащего или ненадлежащего качества товар, и от множества нюансов. Выдуманная «статья» или конкретный срок в ответе клиенту создаёт юридический риск для владельца. ### ✗ Плохо > По статье 25 закона вы обязаны вернуть товар в течение 14 дней, иначе возврат невозможен. (Точная формулировка статьи и применимость условий — не дело черновика. Это вводит клиента в заблуждение и подставляет владельца.) ### ✓ Хорошо Дайте общую рамку и переадресуйте к проверке: > По возврату товара мы действуем в рамках закона «О защите прав потребителей». Уточню точные условия по вашему случаю и вернусь к вам. В черновике для владельца отметьте: *[Прим.: условия возврата зависят от качества товара и сроков — уточните у юриста/бухгалтера, если случай нестандартный.]*
-
-
SKILL.md 10.7 KB
--- name: ticket-deflector description: > Читает пересланное письмо или обращение клиента, подтягивает статус заказа и оплаты из платежей и историю клиента из CRM, готовит ответ в тоне и голосе владельца, а при необходимости — оформляет возврат с явным подтверждением владельца. Триггеры: «подготовь ответ», «ответь этому клиенту», «где мой заказ», «клиент хочет возврат». compatibility: "Нужны: ~~платежи, ~~crm, ~~почта. Опционально: ~~мессенджер." metadata: version: "0.2.0" --- <!-- Производное от Anthropic knowledge-work-plugins / small-business (Apache-2.0, (c) Anthropic). Локализовано под РФ, файл изменён. См. /NOTICE и /LICENSE. --> # Помощник поддержки (ticket-deflector) Каждое письмо клиента — это переключение контекста: где заказ, сколько заплатил, что ему отвечать и не сорвётся ли он, если ответить через два дня. Скилл сам поднимает статус оплаты и историю по клиенту и готовит ответ вашими словами, а возврат не оформит без вашего явного «да» — вы только проверяете черновик, а не собираете факты вручную. ## Быстрый старт Перешлите или вставьте письмо клиента — Claude подтянет статус заказа из `~~платежей`, найдёт клиента в `~~crm` и подготовит ответ в голосе владельца. Если нужен возврат, он соберёт детали и дождётся явного подтверждения, прежде чем что-либо оформлять. ``` Владелец: «ответь этому клиенту» [пересылает письмо] → Извлечь почту клиента + суть обращения из переписки → Подтянуть статус оплаты из ~~платежей → Подтянуть историю клиента из ~~crm → Подготовить ответ в голосе владельца → Владелец одобряет черновик → отправить или в черновики → Если нужен возврат: запрос подтверждения → владелец подтверждает → оформить ``` ## Рабочий процесс 1. **Прочитайте сообщение клиента.** Примите пересланное письмо (`~~почта`), сообщение из мессенджера (`~~мессенджер`) или вставленный текст. Извлеките: контакт клиента, имя, номер заказа или операции (если есть) и суть — заявка на возврат, вопрос о статусе заказа или общая жалоба. Если вопросов несколько — отвечайте в порядке их появления. 2. **Подтяните статус оплаты из платежей.** Найдите операцию в `~~платежах` (например ЮKassa, Тинькофф Касса) по контакту клиента или номеру операции. Зафиксируйте: сумму, дату, статус и был ли уже возврат. Если `~~платежи` не подключены — отметьте это в черновике и продолжайте. Если совпадений нет — отметьте это, не угадывайте совпадение. - **Лимит запросов:** если клиент дал номер операции — используйте его (точечный поиск не упирается в лимит). Если ищете по контакту — берите окно **7 дней** (не 30). Широкие диапазоны дат чаще всего упираются в лимит; запросы подряд в одной сессии исчерпают лимит, если окно слишком широкое. - Если подключён `~~мессенджер` — проверьте открытые обращения от этого клиента там. - Если подключён второй источник оплат — проверьте и его как дополнительный. - Если совпало несколько операций — покажите все и спросите владельца, какая относится к делу, прежде чем готовить черновик. 3. **Подтяните историю клиента из CRM.** Найдите контакт в `~~crm` (например Битрикс24, amoCRM) по адресу/телефону. Возьмите: стадию, заметки, открытые сделки, недавнюю активность. Если контакта нет — отметьте это и предложите создать после отправки ответа, не создавайте в процессе подготовки ответа. 4. **Подготовьте ответ.** Пишите в голосе владельца. Подстройте тон под тип обращения: - Заявка на возврат → с пониманием, ясно, по делу - Вопрос о статусе заказа → по фактам, спокойно - Общая жалоба → признать, объяснить, предложить решение ⚠️ **По возвратам — общая рамка, без выдуманных деталей закона.** Если клиент требует возврат, помните: в РФ права потребителя защищает закон «О защите прав потребителей» (например, возврат товара надлежащего качества — в течение 14 дней при условиях; товар ненадлежащего качества — отдельный порядок). Не цитируйте конкретные статьи и сроки как окончательные — пишите общими словами и при сомнении добавляйте: «уточните условия возврата» (у владельца/юриста). Не обещайте клиенту того, что владелец не подтвердил. Помечайте любые пробелы в данных прямо в черновике в скобках (например, *[Прим.: операция в платежах не найдена — проверьте номер заказа перед отправкой]*), чтобы владелец увидел пробел до отправки. Разобранный пример — в [reference/examples/respond-refund-request.md](reference/examples/respond-refund-request.md). Типовые грабли — в [reference/gotchas.md](reference/gotchas.md). 5. **Контрольная точка — владелец проверяет черновик.** Покажите черновик целиком. Не отправляйте и не сохраняйте, пока владелец не одобрит. Владелец может свободно править перед одобрением. 6. **Контрольная точка — оформление возврата.** Если возврат обоснован, после одобрения черновика покажите отдельный запрос на подтверждение: > *«Оформить возврат [сумма] ₽ клиенту [имя] ([контакт]) по операции [номер]? Ответьте "Да" для подтверждения.»* Дождитесь явного подтверждения. Если ответ владельца — не чёткое «да», остановитесь и спросите, как поступить. 7. **Отправьте или сохраните в черновики.** После одобрения спросите владельца: отправить сейчас через `~~почту`/`~~мессенджер` или сохранить черновиком? Выполните выбор. Затем запишите взаимодействие заметкой в карточку клиента в `~~crm`. 8. **Отчёт.** Один короткий абзац: ответ отправлен или в черновиках, возврат оформлен или нет, заметка в CRM записана. ## Точки подтверждения (approval gates) - **Никогда не оформляйте возврат без явного подтверждения владельца** — всегда покажите сумму, имя клиента, контакт и номер операции до выполнения. - **Никогда не отправляйте ответ без проверки владельцем.** Сначала всегда показывайте черновик целиком. - **Никогда не создавайте контакт в CRM в процессе ответа.** Предложите это после. - **Никогда не выбирайте операцию за владельца автоматически.** Если совпало несколько — покажите все, пусть выбирает владелец. - **Никогда не выдумывайте детали заказа или нормы закона.** Если в платежах нет записи — скажите об этом прямо в черновике. По условиям возврата — общая рамка + «уточните условия возврата», без выдуманных статей. ## Справочные материалы - [reference/gotchas.md](reference/gotchas.md) — примеры «хорошо / плохо» по тону, поиску оплаты и спорным возвратам - [reference/examples/respond-refund-request.md](reference/examples/respond-refund-request.md) — разобранный пример: заявка на возврат с найденной операцией
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.